"Doxygen is not quite magical, though it comes close. To use it,
you simply document your program with good comments in a form that
Doxygen understands. Doxygen then parses the code and comments and
transforms them into nicely formatted output files. Using comments
as documentation keeps everything in one place, making life easier
for hard-working coders.
"Doxygen also has the ability to extract the code structure from
uncommented source code files, which is a wonderful thing when
you're trying to understand strange code (including your own).
Doxygen understands the code; it is much more than just a another
set of formatting tags."