Re: [boost] [Boost-docs] [quickbook] Thank you Daniel James

Subject: Re: [boost] [Boost-docs] [quickbook] Thank you Daniel James
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2014-06-05 12:22:20

> -----Original Message-----
> From: Boost [mailto:boost-bounces_at_[hidden]] On Behalf Of Peter Dimov
> Sent: 05 June 2014 16:10
> To: boost_at_[hidden]
> 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
[phone]