
Hubert, Daryle, 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. Thoughts? Thanks, John.

On 10/15/05 12:45 PM, "John Maddock" <john@johnmaddock.co.uk> wrote:
Hubert, Daryle,
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 [SNIP] 2) Use quickbook to create a new front page for the Math lib, but otherwise leave the html as it is. [SNIP] 3) Convert the existing docs to quickbook [SNIP] Thoughts?
I wouldn't mind option [3]. -- Daryle Walker Mac, Internet, and Video Game Junkie darylew AT hotmail DOT com
participants (2)
-
Daryle Walker
-
John Maddock