Re: [Boost-docs] Query regarding boostbook and documentation

Subject: Re: [Boost-docs] Query regarding boostbook and documentation
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2016-01-04 15:03:59

> -----Original Message-----
> From: Boost-docs [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Stefan Seefeld
> Sent: 04 January 2016 13:30
> To: boost-docs_at_[hidden]
> Subject: Re: [Boost-docs] [boost-docs] Query regarding boostbook and documentation
> 
> On 04.01.2016 08:24, Glen Fernandes wrote:
> > On Mon, Jan 4, 2016 at 8:04 AM, Stefan Seefeld wrote:
> >> It means that - ideally - the document schema (and tools) now known
> >> as "BoostBook" should become part of DocBook, freeing Boost
> >> developers to focus their attention on library design rather than
> >> support tools. And it means that - again, ideally - more people will
> >> be able to benefit from all of that work, not just Boost developers.
> >>
> >> Technically it means that Boost documentation will be able to depend
> >> on DocBook 5, rather than remaining stuck with an old DocBook 4
> >> version against which the BoostBook DTD was developed.
> > Stefan, this sounds great. Would the Quickbook implementation (or any
> > existing documentation that lives only in Docbook XML form) need
> > changes to leverage this?
> 
> I expect so, though hopefully those changes will be only minor. (Note that the original port of
> BoostBook to DocBook 5 was done a few years ago, as a GSoC project.)

This sounds a Good Idea

 - but I dimly recollect that the toolchain currently only works on a certain old version of some
tools, probably Docbook, and not on more recent versions.  Someone will need to understand fully how
this whole toolchain works before changing things as we have invested a lot of Quickbook
documentation on the toolchain.

But indeed worth doing anything that makes it easier to set up and use.  IMO the results are well
worth it.

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal UK LA8 8AB
[phone]