Re: [boost] Documentation Redux (was Re: Boost 1.36.0 release notice)

From: David Abrahams (dave_at_[hidden])
Date: 2008-08-18 06:33:48

on Mon Aug 18 2008, "Dean Michael Berris" <mikhailberis-AT-gmail.com> wrote:

> Another option (that I think Dave Abrahams has been doing) is to use
> RST [0] to make writing/reading the source documentation easier than
> having to rely on Boostbook+XSLT (which I personally think is a
> brittle tool-chain).
>
> Quickbook is also a nice documentation language to use, but the
> reliance on Boostbook+XSLT makes it harder to pull-off. I don't know
> though if Quickbook can be made to generate HTML directly instead of
> XML. Joel?

We could "easily" build a python-based BoostBook/DocBook -> xxx
converter.  What I'd actually do, though, is transform
BoostBook/DocBook into docutils' internal format, then feed that into
docutils and use its already-written backend writers to generate
whatever xxx we chose ;-).

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com