Added documentation for the new macro "DOXYGEN".

The macro DOXYGEN is defined when generating the documentation with doxygen
and should NEVER be defined when compiling with a C/C++ compiler.
See config/docs/macros.txt for details.