DoxyGen

Doxygen is a program to generate developer's documentation out of a program's sourcecode. Parts of the sourcecode's comments are transformed into function descriptions. Doxygen can be used to
 * create classes listings and explanation
 * create functions listings and explanation
 * create call-graphs

= Install it = Note that you need to install graphviz to be able to create graphs. Install graphviz and doxygen as described at installing software, e.g.

for SUSE
yast -i graphviz yast -i doxygen yast -i doxywizard

for Kubuntu
apt-get install graphviz apt-get install doxygen apt-get install doxygen-gui

for Gentoo
emerge -a media-gfx/graphviz app-doc/doxygen eix dox     # to see if there's an interface that you would want (like maybe mkdoxy)

= Run it = If you are a beginner, best start with the program doxywizard

= TroubleShooting =

Symptom
You get the error message Error opening map file *.map for inclusion in the docs!

Solution
Edit your doxyfile (by default ~/Doxyfile), replace SHORT_NAMES           = NO by SHORT_NAMES            = YES and run doxygen again

= See also =
 * http://en.wikipedia.org/wiki/Doxygen