Autotools

Hooking Doxygen into the Build Process

I want to generate documentation as part of my build process, if possible. That is, if the user has doxygen installed, the build system will use it to build Doxygen documentation as part of the make all process.

The original build system has both static and generated documentation. The static documentation should always be installed, but the Doxygen documentation can only be built if the doxygen program is available on the host. Thus, I always build the docs directory, but I use the AM_CONDITIONAL macro to conditionally build the docs/doxygen directory.

Doxygen uses a configuration file (often called doxyfile) to configure literally hundreds of Doxygen options. This configuration file contains some information ...