On Wednesday 26 November 2003 11:44 am, Markus Werle wrote:
> >> > And, of course, we'll be glad to answer any questions that come up.
> >>
> >> The tight coupling with bjam is necessary?
> >
> > It takes a bit of work to do the BoostBook->HTML, and using Doxygen makes
> > it unbearable.
>
> Is there a short overview about the whole system
> and some intro for new authors?
The "Documenting Libraries" section has info for new authors... I'm not sure
quite what you're looking for.
> I think the problem with doxygen is that you cannot apply it
> to a single file, right?
You can apply it to any number of files. The problems with Doxygen are mainly
problems with the Doxygen XML format itself, that cost me a _lot_ of time to
deal with properly. From the user side, it seems to work reasonably well.
> > Interesting... the MPL docs look to be written in DocBook,
>
> So the boost developers do not use BoostBook?
Some do, most don't. Newer libraries seem to be using BoostBook more, but
libraries that predated BoostBook (most of Boost) haven't been converted
except for a few cases.
> > If you do want to use a different toolchain, you'll have to manually
> > apply the $BOOST_ROOT/tools/boostbook/xsl/docbook.xsl stylesheet to the
> > BoostBook XML files to get a pure DocBook document that you can---I
> > think---use with db2pdf.
>
> Does that mean editing the files? If yes, how?
No, it means running it through an XSLT processor like xsltproc.
> This is the first time I get in touch with XSLT, XML, SGML and
> all this looks not like I get an overview in amortized O(1) time.
Nope, it's not easy to get started. It's mostly my fault (I should at least
have easy-to-install packages for these things), and partly the fault of the
inherent complexity of the project.
I think the "easy way" is really to use the bjam toolset for BoostBook; it
takes care of most of the gory details. The setup is detailed in the online
documentation.
Or, of course, you can wait until I get my act together and make an easy
installer for your platform. But be warned that I'm ludicrously busy right
now and won't get to it for a while.
Doug
-------------------------------------------------------
This SF.net email is sponsored by: SF.net Giveback Program.
Does SourceForge.net help you be more productive? Does it
help you create better code? SHARE THE LOVE, and help us help
YOU! Click Here: http://sourceforge.net/donate/
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
