From: Pedro Ferreira (pedro.ferreira_at_[hidden])
Date: 2004-02-02 10:13:19
> recently, several people asked that V2 docs be split into more manageable
> parts. Zbynek Winkler made an initial attempt on this, and results can be
> seen at
> First question is how does it look?
Really nice! Congratulations to you and Zbynek.
> The second question is what documentation format should be use. Zbynek has
> used PHP to automatically generate header and navigation links, and I'd
> to discuss if we're going to use that format, or current html, or
> Eventually, I think moving to Docbook is the best approach.
> What should be done now? I would not like to ignore the work that Zbynek
> done, but is there something wrong with the idea of using new tool just to
> generate headers? After all, I can do that in HTML, once. Other concern is
> that not all will be able to generate HTML from PHP. Finally, if we're
> to move to Docbook someday, then we probably should not switch now to yet
> another format, to minimize confusion.
I too find it a bit of an overkill to use PHP just to create the headers...
I'm not familiar with docbook, so I'll refrain from commenting.
Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk