Boost C++ Libraries: Ticket #3294: [boostbook] Documentation. docbook-xsl version

Michael Caisse — Tue, 28 Jul 2009 08:29:01 GMT

This should read:

indicate which version of DocBook XSL is compatible.

Daniel James — Tue, 28 Jul 2009 18:16:05 GMT

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 — Tue, 28 Jul 2009 19:37:20 GMT

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 — Tue, 28 Jul 2009 19:54:10 GMT

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.

status changed; resolution set

Michael Caisse — Wed, 29 Jul 2009 06:57:22 GMT

status new → closed
resolution → worksforme

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.