Further reading
- Official website of Doxygen: https://www.doxygen.nl/
- FindDoxygen find-module documentation: https://cmake.org/cmake/help/latest/module/FindDoxygen.html
- Doxygen's docblocks: https://www.doxygen.nl/manual/docblocks.html#specialblock
Other documentation generation utilities
There are dozens of other tools that are not covered in this book, as we're focusing on projects supported by CMake. Nevertheless, some of them may be more appropriate for your use case. If you're feeling adventurous, visit the websites of two projects I found interesting that are listed here:
- Adobe's Hyde (https://github.com/adobe/hyde)
Aimed at the Clang compiler, Hyde produces Markdown files that can be consumed by tools such as Jekyll (https://jekyllrb.com/), a static page generator supported by GitHub.
- Standardese (https://github.com/standardese/standardese)
This uses libclang
to compile your code and provides output in HTML...