Jeff Garland wrote:
On Thu, 23 Mar 2006 10:36:00 -0800, Eric Niebler wrote
Looking at the nightly generated docs in the wake of my XSLT changes,
I notice that the date_time docs are out of step. Turns out for
date_time, Doxygen needs to be run as a separate step and the
resulting .boostbook files need to be checked in. Why is this not
integrated into the doc build process?
Sorry to be slow on the response. It's true, we generate the reference xml
ourselves and check it in. The primary reason is getting a bit foggy for me
now, but I believe the essential reason is the BoostBook isn't able to split
the reference into parts. If you look at:
http://www.boost.org/doc/html/date_time/doxy.html
you'll see that we split things into 4 logical groupings. As far as I know
there's no automated way to do this. As I recall there may be some other
issues with the Doxygen results that we modify 'manually' (by script) as well...
In January, I added support to BoostBook for multiple Doxygen-generated
reference sections. See http://tinyurl.com/ruy73. You might give that a
shot. You can even have cross-references between the multiple reference
sections if you use doxygen to generate tagfiles. In your Jamfile, you
can add <doxygen:param>GENERATE_TAGFILE=foo.tag for one reference
section, and then <doxygen:param>TAGFILES=foo.tag when generating a
second section that refers to entries in the first.
--
Eric Niebler
Boost Consulting
www.boost-consulting.com
-------------------------------------------------------
This SF.Net email is sponsored by xPML, a groundbreaking scripting language
that extends applications into web and mobile media. Attend the live webcast
and join the prime developer group breaking into this new coding territory!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=110944&bid=241720&dat=121642
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
