[SOLVED] Documenting namepaces in Doxygen

Documenting namepaces in Doxygen

I'm starting documenting all of my code with doxygen. I´ve no problem with file documentation but i runinto a small problem when generating documentation for several files.

For example:

In some header files (I´m using only C/C++ code projects) i have the following code:

#include "../config/compiler.h"  ///< Compiler flags

namespace nge                    ///< NGE namespace
{
... some code...
}

After running doxywizard if I look for the documentation for namepaces I will see the NGE namespace but instead of getting:

NGE | NGE namespace

I get

NGE | Compiler flags

this occurs even if I swap /// NGE namespace with /// @namespace NGE namespace

Cam somebody please explain me where I´m making the mistake ??

Solution

The problem of the "Compiler flags" is indeed that #include cannot be documented and that the comment (including the <) flows into the brief description of the next item (i.e. namespace NGE). The fact that the documentation of the namespace NGE also has the extra < is due to the fact that the ///< is used for documenting after an complete item and in this case the definition of the namespace is not complete yet.