From: Vladimir Prus (ghost_at_[hidden])
Date: 2004-02-03 08:53:11
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?
First, you need to get XSLT tool called xsltproc from
(Debian has it already, other Linux distros are likely to have it too).
Then, get example from
After unpacking, running "./run.sh" on Linux will create single-html version
of docs and multiple-page version. On other platforms, you'd need to manually
execute two commands in ./run.sh.
The results don't look extremely nice, but I guess that's because there's not
CSS to help with this. I'm hoping Christopher knows how to make result
Of course, in real life we'd be using Boost.Build to generate docs, since
almost all the bits are already there.
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