Re: V2 documentation format: a resolution?

From: Christopher Currie (Christopher_at_[hidden])
Date: 2004-02-03 17:24:57

Douglas Gregor wrote:
> If you're going with DocBook, you should consider the work already done on 
> BoostBook (which first transforms to DocBook).

> The BBv2 tools might need a little bit of tweaking to start with DocBook 
> instead of BoostBook, but please don't start from scratch. Or, if you think 
> you might want something more than what DocBook offers, you could use 
> BoostBook directly (it's a superset of DocBook) and we can extend it with 
> Boost.Build-specific markup.

No worries, I'm all for keeping things consistent. Right now I'm using 
the BoostBook DTD starting at the <boostbook> element, which thankfully 
includes <chapter> from the DocBook DTD (<library> doesn't seem to quite 
fit what we're documenting). There hasn't been a need to create any 
specific markup, but we might need it later.

What we *may* end up doing is tweaking the stylesheets to create a 
different L&F. I'm pretty sure the existing stylesheets are designed to 
follow some Boost guidelines, but Zbynek's layout got some good reviews, 
so if possible we'd like to modernize them a little.

Christopher