843d831172
The doc/Doxygen/Allwmake script can now be given directories as arguments, which will be built instead of the usual src/ and applications/ directories. This allows testing the documentation of a limited set of files without building everything. The outer doc/Allwmake script has also been deleted.
Building the Doxygen help for OpenFOAM
#
Doxygen
The HTML documentation of OpenFOAM can be built using the Doxygen software.
Images in the documentation are generated using "dot", a program within the
graphviz software package. To build the documentation on the Ubuntu GNU/Linux
system, for example, the user should install both doxygen and graphviz
packages, e.g. by typing in a terminal window:
sudo apt-get install doxygen graphviz
The Doxygen documentation will build automatically for a user that is
configured to run OpenFOAM, i.e. has environment variables such as
$WM_PROJECT_DIR set. The user must also ensure they have write
permission for the directory that Doxygen writes files to.
Configuration
The Doygen configuration file, Doxyfile, in the $WM_PROJECT_DIR/doc/Doxygen
directory is configured to work with Doxygen versions 1.6.3-1.8.5.
The Header, Footer, and Stylesheet are generated automatically:
doxygen -w html header.html footer.html customdoxygen.css
See: https://www.stack.nl/~dimitri/doxygen/manual/customize.html
Running Doxygen
In the $WM_PROJECT_DIR/doc/Doxygen directory type
./Allwmake
which will generate the $WM_PROJECT_DIR/doc/Doxygen/html directory
containing the OpenFOAM source code documentation. Load the index.html file
into a browser, \e.g.\
firefox html/index.html