Eric Niebler wrote:
I was the one who took Joel de Guzman's QuickDoc tool, which generated HTML, re-purposed it to generate BoostBook XML, and rechristened it QuickBook. It has been terrifically useful, and other have run with it. As others have pointed out, the Docbook toolchain is powerful. Escaping to BoostBook/Docbook XML is a great way to Get Things Done when QuickBook doesn't offer a pithy syntax. And as Daniel points out, Doxygen generates XML which can be integrated with the XML spit out by QuickBook, allowing you to easily link from your user docs to your reference and (with some difficulty), the reverse.
Thanks for the explanations. I've actually did get that running, and it's not remotely as difficult as it first appears. The main problem is a psychological one - download this from site A, that from site B, that other thing from site C, but be careful to not download something else from there. The installation procedure could probably be improved considerably by just putting docbook-xml and docbook-xslt into our repository. I'm not sure how things would stand license-wise though.