question about using Doxygen
"Robert Ramey" <[email protected]>
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
https://svn.boost.org/trac/boost/wiki/Guidelines/DoxygenGuidelines contains this text Documenting the Reference section following the C++ standard style Doxygen provides a certain number of tags that allows to generate a clean documentation, but it would be great if all the Boost libraries document its Reference section following the C++ standard style. which I would certainly like to do. Looking at the Doxygen documentation it's not immediatly obvious whether or not Doxygen is useful for this task. It seems we have a few alternatives: a) use HTML directly - simple but tedious b) use BoostBook - complex but tedious c) quickbook - simple - but ... frustratnig? or not? - I'm just a little wary of a tool which does "too much" Is DOxygen useful for generating reference documenation for template meta programming libraries? Or is it something that "can be made to work" which is a whole different thing than "just works". Any one care to share their advice on the simplest way to get generate documentation for a library? Robert Ramey