> Done, although slightly changed. I didn't understand the usage of
> "because" in this context, and I first changed it to "although".
> Finally, this was what I committed:
>
> ....
> <li> #if defined(__APPLE__) || defined(FL_DOXYGEN) / #endif allows
> some platform-specific code (__APPLE__) to be seen by Doxygen,
> even if Doxygen is run on another system (e.g. Linux).
> ....
>
> Please correct me if this is not what you intended.
>
> Albrecht

This specific point (subitem 2.) needs probably a few more words
to be clear:

<li>The Doxygen program does not define the platform-diagnostic
variables __APPLE__ or WIN32 (even if it's run on Mac OS or MSWindows).
Thus, for some platform-specific (say, Mac-specific) code to be
seen by Doxygen, one must bracket it as follows:
<pre><tt>#if defined(__APPLE__) || defined(FL_DOXYGEN)
.. Mac-specific code ...
#endif
</tt></pre>


Alternatively, this may be judged too detailed. In that case,
just the definition of FL_DOXYGEN, without subitems 1. and 2.,
would be enough:

"FL_DOXYGEN is defined when the Doxygen program that builds the FLTK 
documentation processes the source code."

_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev

Reply via email to