[boostbook] Documentation. docbook-xsl version

[Michael Caisse]

Section Configuring local DocBook XSL and DTD distributions should indicate which version of DocBook XML is compatible.

The latest version (1.75.2) will not work. Version 1.73.2 (which is what the unix auto script downloads also) works fine.

[Michael Caisse]

This should read:

indicate which version of DocBook XSL is compatible.

[Daniel James]

What issues are you having with 1.75.2? I just tried it and it works fine for me. If you're stuck, it might help if you let me know the details of your system and post your user-config.jam?

Also, whenever you change your user-config.jam you should then build with bjam -a because boost build doesn't notice that the settings have been changed (I'll add a note to the 1.40 documentation, or maybe even get it fixed).

[Michael Caisse]

I apologize about not posting details. I figured all would have the problem. I am using libs/function/doc as the test location for the build in boost release 1.39.0.

When using 1.75.2 I get failures such as the following:

warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"
compilation error: file file:///d:/boost/boost_1_39_0/tools/boostbook/xsl/html.xsl line 15 element import
xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/math.xsl"
compilation error: file file:///d:/boost/boost_1_39_0/tools/boostbook/xsl/html.xsl line 17 element import

Indeed, the 1.75.2 zip is lacking files such as chunk.xsl and math.xsl.

The 1.73.2 zip contains all of the files that are missing in version 1.75.2.

My failing user-config.jam file contains these lines (there is nothing else in the file):

using xsltproc 
      : "d:/boost/boost_book/libxslt-1.1.24.win32/bin/xsltproc.exe"
      ;

using boostbook
      : "d:/boost/boost_book/docbook-xsl-1.75.2/doc"
      : "d:/boost/boost_book/docbook-xml-4.2"
      ;


using doxygen ;

using quickbook
      : "c:/bin/quickbook.exe"
      ;

The working version contains:

using xsltproc 
      : "d:/boost/boost_book/libxslt-1.1.24.win32/bin/xsltproc.exe"
      ;

using boostbook
      : "d:/boost/boost_book/docbook-xsl-1.73.2"
      : "d:/boost/boost_book/docbook-xml-4.2"
      ;


using doxygen ;

using quickbook
      : "c:/bin/quickbook.exe"
      ;

The 1.75.2 version came from here: ​http://sourceforge.net/projects/docbook/files/docbook-xsl-doc/1.75.2/docbook-xsl-doc-1.75.2.zip/download

I had noticed that bjam wasn't updating the catalog and have been manually removing the boostbook_catalog.xml file after updating my user-config.jam. Thank you for the bjam -a tip.

[Daniel James]

Did you download docbook-xsl-doc-1.75.2.zip? You need to download docbook-xsl-1.75.2.zip, sourceforge has just revamped their download system so that it only shows the most recently uploaded file which is the wrong one (I made the same mistake). If you expand 'docbook-xsl' on the download page you'll find it.

[Michael Caisse]

Indeed I did. And I was trying to be so careful.

I went back and downloaded the correct package and of course it all works just fine.

Sorry for the noise.