cet-is » cetlib

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.

I've attached a patch that adds the simplest way to add a target to build Doxygen pages for cetlib.

• A doc target is created if Doxygen is found (so just make doc after configuration)
• Information from the Cmake configuration is used to configure the input file
• Generated pages are output to a Doxygen subdirectory of the build directory
• At least HTML docs are generated, and can be viewed by opening PROJECT_BINARY_DIR/Doxygen/html/index.html in your browser
• The source:README file is renamed with a .md extension 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...