From: Douglas Paul Gregor (gregod_at_[hidden])
Date: 2003-03-27 13:59:01
On Thu, 27 Mar 2003, Douglas Paul Gregor wrote:
> On Thu, 27 Mar 2003, Joel de Guzman wrote:
> > Spirit desperately needs a reference manual. Yes, I'm very interested.
> > I am also very interested to build Spirit based tools to make the task
> > easier. I'm just afraid of the time that I need to commit. Perhaps I can
> > proceed step-wise? Suggestions?
> It depends on how you want to write your documentation. Are you planning
> to annotate your source with comments and use an extraction tool (e.g.,
> Doxygen), or would you prefer to write interfaces by hand? The former is
> generally preferred, but the latter might be needed if the user-view of
> the interfaces is so different from the implementation that you would be
> fighting the extraction tool the whole time.
FWIW, the basic Jamfile.v2 for using Doxygen would be:
project boost/spirit/doc ;
import boostbook : boostbook ;
import doxygen : doxygen ;
doxygen spirit.doxygen : ../../../boost/spirit/
: <recursive>on <pattern>*.hpp
boostbook spirit : spirit.doxygen ;
With a patched Doxygen (see the "Getting Started" docs) and this
Jamfile.v2 in libs/spirit/doc, I can generate skeletal documentation for
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk