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