Subject: Re: [Boost-docs] question about using Doxygen
From: Edward Diener (eldiener_at_[hidden])
Date: 2011-06-20 23:59:36
On 6/20/2011 7:19 PM, Robert Ramey wrote:
> 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.
What is 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.
Doxygen can generate reference documentation for class templates, among
other C++ constructs. I believe it has some problems with full and
It is up to the programmer to create the documentation as he wants it.
> 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"
Quickbook is so much easier than anything else that it should be a
no-brainer to choose.
> 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?
Use quickbook and doxygen. Look at any number of library documentation
for how to setup the doc bjam file ( you can see my own libraries, VMD
and TTI in the sandbox ).
Doxygen is simply a means to document C++ constructs via a short
description and a long description, either being optional. With either,
but especially with the latter, you can create completely free-form
documentation, although doxygen also allows constructs in your doc which
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC