-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Peter Dimov Sent: 05 June 2014 16:10 To: boost@lists.boost.org Subject: Re: [boost] [Boost-docs] [quickbook] Thank you Daniel James
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.
This would certainly lower the barrier to getting started with Quickbook toolchain. It would also ensure that we are also all using the same version - some newer versions seemed not work as I recall. Paul --- Paul A. Bristow Prizet Farmhouse Kendal UK LA8 8AB +44 01539 561830