mirror of
https://develop.openfoam.com/Development/openfoam.git
synced 2025-11-28 03:28:01 +00:00
e57874859a
Contributed by Bruno Santos Resolves patch report http://www.openfoam.org/mantisbt/view.php?id=2023 Update online documentation http://openfoam.github.io/Documentation-dev/html/
Building the Doxygen help for OpenFOAM
======================================
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 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.
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.
**Note**:
For versions of Doxygen below 1.7, the final <div> in the
_Header file (line 37) must be deleted before running Doxygen to
produce the correctly formatted HTML files.