This folder contains the setup to build the IfcOpenShell C++ API documentation from the source code.

Prerequisites:

Make sure to have Doxygen and Graphviz installed into your $PATH variable.

The documentation also use the doxygen-awesome theme as a git submodule.

Build with the command (from within the /docs/cpp-api folder):

$ doxygen

To include the current git commit hash into the build documentation, use the following command:

$ PROJECT_NUMBER=$(git rev-parse --short HEAD) doxygen

This will extract the current commit hash in short version and sets the propper ENV variable used by doxygen.

The generation of the documentation might take a while depending on your systems hardware, as it is configured to generate the Class graphs using .

The resulting documentation is located unter /cpp-api/output/html and can be directly accessed with your browser:

$ open ./output/html/index.html