Boost logo

Boost-Build :

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
> else.


> 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, david.abrahams at, gregod at, cpdaniel at, john at