additional doxygen pages (was: Re: QOF help!)
Christian Stimming
stimming at tuhh.de
Wed May 5 04:22:09 EDT 2004
Josh Sled wrote:
>
>>I'm not sure how to use doxygen for architectural docs... Could you
>>provide an example or pointers to docs that describe it?
>
> http://www.stack.nl/~dimitri/doxygen/commands.html
>
> Using \defgroup , \addtogroup , \example , \mainpage and \file , and a
> bit of convention, one could build higher-level structural docs
> along-side the lower level file/function/variable docs.
Just a thought about how I usually add "extra" documentation pages (the
result is similar to the pages shown here
http://simthetic.sourceforge.net/simthetic/api-doc/html/pages.html ):
1. Create a new text file with your documentation text
2. At the beginning and end of this text file, insert the c comments for
doxygen, i.e.
/** \page page_label My extra documentation page
[... text goes here ... ]
*/
3. Add the file name of the text file to the INPUT tag of the doxygen
configuration file (Doxyfile). That's it.
4. Potentially, use more doxygen commands inside that text file, e.g.
\section and \subsection.
Christian
More information about the gnucash-devel
mailing list