From: Peter Dimov (pdimov_at_[hidden])
Date: 2007-06-25 16:58:46
Gennadiy Rozental wrote:
> "Peter Dimov" <pdimov_at_[hidden]> wrote in message
>> Peter Dimov wrote:
>>> I admit that it would be possible to make the .xml files viewable in
>>> a browser by using a stylesheet, but currently they don't seem to
>> By using
> Hmm. Why not regular single or multi chunk HTML output stylesheet?
No idea. Given that the XML->HTML conversion is done via XSLT, I'd have
expected the XML files to already come with an associated XSLT stylesheet,
but they do not. The above was what I found in the limited time I spent
looking for a DocBook stylesheet. Apparently, the XmlMind editor also
contains a CSS stylesheet for DocBook.
The exact method is not important. What matters is that the user should be
able to view the documentation in at least Firefox, and hopefully IE7 as
well. It might be reasonable to require a 'bjam' invocation for libraries
that need building anyway, but a requirement to install a BoostBook
toolchain seems a bit steep (in this light I view QuickBook as an
improvement as it can - IIUC - produce HTML docs from a single 'bjam'
command given a fresh Boost tree). For header-only libraries that don't even
require bjam to be present, everything besides readily-accessible HTML would
be a regression.
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk