Re: [Boost-docs] Running boost book

Subject: Re: [Boost-docs] Running boost book
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2011-07-09 11:26:40

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of
> John Maddock
> Sent: Saturday, July 09, 2011 11:49 AM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Running boost book
> 
> >> On 25 June 2011 01:45, Robert Ramey <ramey_at_[hidden]> wrote:
> >> > $ xsltproc -V
> >> > Using libxml 20614CVS2195, libxslt 10111CVS955 and libexslt
> >> > 809CVS955 xsltproc was compiled against libxml 20614, libxslt 10111
> >> > and libexslt
> >> > 809 libxslt 10111 was compiled against libxml 20614 libexslt 809
> >> > was compiled against libxml 20614
> >>
> >> These versions of libxml and libxslt were released in 2004. You need
> >> a recent version.
> >
> > Some years ago, when I tried to use the newest versions, it didn't work.
> >
> > I'm still using docbookXML version 42 dated 2002 and
> > Docbook_xsl_1._70_1 from 2006 and they work OK for me.
> 
> Paul, we're talking about two completely different things here: xsltproc (the program and
libraries) should
> be a recent version, so should the Docbook XSL stylesheets, *but*, the Docbook DTD is fixed at 4.2
as this
> is the *specification* of the Docbook standard we're targeting.

Ah yes - you are right - senility creeps ever onward - I remember now, it was a later Docbook DTD
that *really* caused trouble (but I didn't know that at the time).

However, I think my comment that a working copy of all the Known-Good utilities might avoid others
getting equally or more confused.

Writers of Quickbook docs should not need to know all this.  I fear that the toolchain complexity is
putting people off using the toolchain and that everything was can do to make is easier is a Good
Thing.

Paul