root/branches/newmole/doxygen/readme_doxygen.txt

Revision 687, 1.4 kB (checked in by peter, 2 years ago)

Merge changes from mainline upto r685.

This branch is now fully merged. Any remaining problems in doxygen, scripts
and tsuite should now be resolved.

  • Property svn:eol-style set to native
Line 
1Readme for Doxygen
2
3quick start:
4create the documentation with the command
5doxygen Doxyfile
6
7Doxygen is a source code documentation system that is widely used in open source projects.  It is available on the web at http://www.stack.nl/~dimitri/doxygen/  You will need a copy of the doxygen executable on your system to create the documentation.
8
9Doxygen must be able to find the open source program graphviz that is used to create equations from embedded LaTex.  Download graphviz from http://www.graphviz.org/
10
11This directory includes the setup file "Doxyfile" that is needed to run doxygen.  The Cloudy download does not include the output documentation it generates.  To create documentation run doxygen with the command
12doxygen Doxyfile
13in this directory.  Doxgyen will create a new html directory below this one.  The index.html file in the html directory is the top of the documentation.
14
15The manual for doxygen can be found at http://www.stack.nl/~dimitri/doxygen/download.html#latestman
16The full description of its commands is under "Special Commands" in the "Reference Manual" section.
17
18The document file doxygen_setup_style.txt in this directory contains some notes on how Cloudy uses doxygen.
19
20==============================================
21
22the file Doxyfile was created with the gui that is lauchned with the command
23doxywizard Doxyfile
24this is used to set the parameters for the generated output.
25
26Good luck,
27Gary Ferland
28http://www.nublado.org
Note: See TracBrowser for help on using the browser.