Command line options and man pages
As one can generate man pages for a docbook refentry as well, it sounds like a good idea to use it for that purpose. This way the interface is part of the reference and one gets the man-page for free.
- 7.1.1. Document the tool
- 7.1.2. Adding the extra configure check
- 7.1.3. Adding the extra makefile rules
7.1.1. Document the tool
Create one refentry file per tool. Following our example we would call it meep/docs/reference/meeper/meep.xml. For the xml tags that should be used and can look at generated file in the xml subdirectory as well as examples e.g. in glib.