Re: [jamboost] Re: V2 documentation format: a resolution?

From: Douglas Gregor (gregod_at_[hidden])
Date: 2004-02-03 10:51:40

On Tuesday 03 February 2004 08:30 am, Zbynek Winkler wrote:
> Vladimir Prus wrote:
> > So, let's go with DocBook?
>
> Is there anyone here familiar with the DocBook toolchain? What is needed to
> get i.e. html out of it? Could someone write a quick howto for the most
> common platforms, so we can try it out before the final decision?

If you're going with DocBook, you should consider the work already done on 
BoostBook (which first transforms to DocBook). We've already handled the 
DocBook -> HTML, single HTML, PDF, PS, etc. . See instructions for generating 
output in the various formats from BoostBook (via BBv2) here:

http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/boostbook.html

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.

Doug