Doxygen is the de facto standard tool for generating documentation from annotated C++ sources.
Ranked in these QuestionsQuestion Ranking
Pro Generates documentation from comments
Doxygen can generate documentation from formatted comments in the source code. This is extremely useful when writing detailed man pages.
Doxygen is compatible with multiple languages. Including but not limited to: C, Objective-C, C#, C++, Java, Python, PHP etc...
Con No recursive inclusion
For example, if you specify
INCLUDE_PATH=incl, it doesn't search other folders included in the
incl folder (
incl/sub2) and there's no option to turn on recursive inclusion.