Re: [boost] Re: Reference documentation: one approach

From: David Abrahams (dave_at_[hidden])
Date: 2002-11-01 18:55:24

"Jeff Garland" <jeff_at_[hidden]> writes:

> > I used Doxygen to produce HTML (directly) and PDF (through pdftex)
> > documentation of the 1.29 version of Boost.Python. It was not a very
> > interesting document... Doxygen seems to not acknowledge templates as
> > "compounds", so one basically get a list of the files involved in the
> > project. Not very useful for Boost, in other words. 
> 
> I think generalizing about Boost libraries soley based on Boost.Python 
> is quite dangerous.  You might get very different results from other
> libraries...

You certainly might. However, Boost.Python actually uses a fairly wide
spectrum of other Boost libraries including Type Traits, Function,
Bind, Graph, Smart Pointers, and MPL. So it's likely to stress test a
fairly broad range of our code idioms.

-- 
                    David Abrahams
dave_at_[hidden] * http://www.boost-consulting.com