From: John Maddock (john_at_[hidden])
Date: 2005-10-15 11:45:11
I'm trying to figure out how to integrate the docs for the few new additions
to Boost.Math that come with the TR1 library into the existing
documentation. The new docs use quickbook, and the options appear to be:
1) Leave the existing docs as they are, the minor problem with this is that
my addition ends up with it's own library entry under doc/html/index.html,
while the rest of you get left out of there as you do now :-(
2) Use quickbook to create a new front page for the Math lib, but otherwise
leave the html as it is. The doc/html/index.html would now look right, but
the existing html docs would be second-class citizens in the BoostBook
generated TOC for the Math lib: they would get a main entry, but no
sub-entries, and just a forwarding link to the existing html.
3) Convert the existing docs to quickbook: it's a bit tedious, but
surprisingly easy to do, and once you get the hang of it, easier to maintain
than html: no honestly it is, not having to quote "<>&" etc code snippets is
worth the change alone IMO. I don't mind making the initial changeover, but
thereafter you guys would have to be happy maintaining the quickbook source.
The main advantages are a coherent look to the docs, automatic TOC, optional
PDF generation and so on. There's the potential to integrate the docs for
the new complex number inverse trig special functions, with the existing
docs for the scalar versions as well, but I haven't looked into that yet.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk