This section briefly describes how to build Massiv documentation.
All sources of the Massiv Core, Massiv Demo, utilities and examples are documented using Doxygen comments. Doxygen (http://www.doxygen.org) is a documentation system that can generate nice documentation from a set of documented sources. The Massiv Core Reference Guide mentioned many times in this book is generated by the Doxygen too.
To generate documentation of the Massiv Core (the Massiv Core Reference Guide) or documentation of the Massiv Demo, follow these steps:
Install the Doxygen.
Optionally install Graphviz (http://www.research.att.com/sw/tools/graphviz/) if you want to generate nicer diagrams.
Enter the doc/doxygen subdirectory of the Massiv source root directory.
Copy config.doxygen.example to config.doxygen and edit it. If you have install Graphviz, you should set HAVE_DOT to YES.
On systems with unixish make, you can use supplied Makefile to build the documentation. Otherwise run Doxygen directly; to build the Massiv Core Reference Guide, use core.doxygen config file, to build the Massiv Demo documentation, use demo.doxygen. You may have to create the output directory (html/core for example) manually, because Doxygen can't create nested directories automatically.
The documentation you are reading now is written in DocBook (http://www.docbook.org). Its XML sources can be found in doc/docbook subdirectory of the massiv source root directory.
Building DocBook documentation is not an easy task. Please refer to doc/tech/documentation.txt for information about required tools and documentation of the doc/docbook/docgen.pl utility that is used generate the documentation.