Doxygen is a program which generates HTML documentation describing all the files, functions and classes of a program based on the C++ source. It uses comments in a particular format in the code. There is a search box and a tree view for the classes, as well as links to HTML versions of the source files. An example of the output is at
To generate the documentation, go into the root Carpet directory and type "doxygen", assuming that doxygen is installed on the local system. The documentation will be generated in a new carpet-doc directory. Open the file carpet-doc/html/index.html to browse the documentation.
It would be convenient to have the documentation generated in this way made available on the Carpet web site and updated after each commit to the repository.
The attached patch provides a doxygen configuration file and a header file for the main documentation page.