Gennadiy Rozental wrote:
"Peter Dimov" <pdimov@mmltd.net> wrote in message news:018a01c7b752$26407bf0$6407a80a@pdimov2...
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 be.
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.