Question

I have updated our c++ class comments to doxygen format and they look nice… but the namespaces list/tab is not at all useful. We have a parent namespace e.g john and then sub-namespaces for each library or functional area e.g john::graphics, john::sound, etc.
Doxygen is only listing a single namespace: john.
Do I have to simply change some setting, or is it mandatory to document my namespaces for doxygen to pick them up?

Answer 1

In general, you have to document anything for Doxygen to decide that it’s important. Namespaces in included. But you don’t have to document them particularly well; just a brief notation of what they’re for is sufficient for Doxygen to document them.