Document API using a tool such as Doxygen
Though the wiki page provides some hints, it would be useful to have the API of cetlib documented.
This could use a suitable markup tool such as Doxygen.
#1 Updated by Christopher Green about 5 years ago
- Tracker changed from Feature to Support
- Status changed from New to Feedback
We would like to discuss this at the stakeholders meeting, since this does entail a significant amount of effort from the point of view of both the tool choice and configuration for automatic use, and the documentation of the APIs in the chosen format. Please note that we do have the ongoing art workbook project, where you may find some of the information you seek.
#3 Updated by Ben Morgan over 3 years ago
- File 0001-Issue-6334-Build-Doxygen-docs-for-cetlib.patch 0001-Issue-6334-Build-Doxygen-docs-for-cetlib.patch added
I've attached a patch that adds the simplest way to add a target to build Doxygen pages for cetlib.
doctarget is created if Doxygen is found (so just
make docafter configuration)
- Information from the Cmake configuration is used to configure the input file
- Generated pages are output to a
Doxygensubdirectory of the build directory
- At least HTML docs are generated, and can be viewed by opening
PROJECT_BINARY_DIR/Doxygen/html/index.htmlin your browser
- The source:README file is renamed with a
.mdextension and used as the main page (as doxygen can parse markdown)
- All items are extracted, even if not documented
- No installation of the pages is done as I wasn't clear where these should go (they're flavor independent)
This is very basic and doesn't address adding doxygen as a build requires in the source:ups/product_deps file (NB,
find_package will be sufficient provided the
doxygen exe is in the PATH), nor the actual documentation(!). However, it should provide an idea at least of how to get started on generating the docs...