When comparing Doxygen vs Natural Docs, the Slant community recommends Doxygen for most people. In the question“What are the best documentation tools for .NET developers?” Doxygen is ranked 1st while Natural Docs is ranked 5th.
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...
Pro The output is in natural language
Natural Docs outputs documentation written in natural language which reads very similar to plain English.
Con i18n support is poor
Cannot work properly with non-ascii paths on Windows
Con PDF output is very problematic
Doxygen PDF output relies on the now broken LaTeX tabu package which was abandoned over a decade ago by its developer.
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.
Con Does not parse all the folders in the project
Con No C++ full syntax parsing
Does not support full syntax parsing of C++.
Con Supports only HTML
The documentation can only be generated in HTML format.