Re: [Boost-docs] Doc build failure... For bjam.

Subject: Re: [Boost-docs] Doc build failure... For bjam.
From: Rene Rivera (grafikrobot_at_[hidden])
Date: 2008-10-11 16:40:13

Did I mention that the doc build was working? As it's how I did the 
3.1.16 bjam release long ago now.

Eric Niebler wrote:
> 
> Rene Rivera wrote:
>> So had some time tonight to read some emails... And The problem I'm 
>> having with building the bjam docs has nothing to do with what Beman 
>> has been ahving problems with. When I try and build the bjam docs, 
>> note I build them in standalone mode, I get the following:
>>
>> ====
>> xslt-xsltproc 
>> ..\..\..\bin.v2\tools\jam\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\bjam.docbook 
>>
>> ../../../bin.v2/tools/jam/doc/msvc-9.0xp/dbg/lnk-sttc/thrd-mlt/bjam.xml:2: 
>> warning: failed to load external entity 
>> "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd"
>> BoostBook XML V1.0//EN" 
>> "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd"
> 
> 
> Looks like either you've configured the boostbook toolset wrong in your 
> user-config.jam (bad paths?)

My user-config.jam has:

using python : 2.5 ;
using docutils : C:/Boost/share/docutils ;
using doxygen ;
using xsltproc : C:/Boost/bin/xsltproc.exe ;
import boostbook-config ;
import quickbook-config ;

All the tools, xsltproc, and the various XML and XSLT are all the 
latest. When I run with debug configuration I see:

notice: [python-cfg] Configuring python...
notice: [python-cfg]   user-specified version: "2.5"
notice: [python-cfg] Registry indicates Python 2.5 installed at 
"E:\Python25\"
notice: [python-cfg] Checking interpreter command "python"...
notice: [python-cfg] running command 'DIR /-C /A:S 
"E:\Python25\python.exe" 2>&1'
notice: [python-cfg] running command '"python" -c "from sys import *; 
print 
'version=%d.%d\nplatform=%s\nprefix=%s\nexec_prefix=%s\nexecutable=%s' % 
(version_info[0],version_info[1],platform,prefix,exec_prefix,executable)" 
2>&1'
notice: [python-cfg] ...requested configuration matched!
notice: [python-cfg] Details of this Python configuration:
notice: [python-cfg]   interpreter command: "python"
notice: [python-cfg]   include path: "E:\Python25\Include"
notice: [python-cfg]   library path: "E:\Python25\libs"
notice: [python-cfg]   DLL search path: "E:\Python25"
notice: using doxygen : E:\Program Files\doxygen\bin\doxygen.exe
notice: using boostbook : \Boost\share\docbook-xsl-1.74.0 : 
\Boost\share\docbook-xml-4.5 : \Boost\share\boostbook
notice: Boost.Book: searching XSLS/DTD in
notice: \Boost\share\boostbook C:\DevRoots\Boost\boost\tools\boostbook 
C:\DevRoots\Boost\boost\tools\build\v2\..\..\boostbook
notice: using quickbook : \Boost\bin\quickbook.exe

Hence it finds and configures all the tools I'm using.

> or else xsltproc is not finding the catalog 
> file. Are you running this under cygwin, by any chance?

Not cygwin, this is pure win32 run within the SciTE command window which 
is just a popen display. And it's how I run all builds. Trying to build 
the quickbook docs, since I figure that *should* work, the catalog it 
creates looks like:

file E:\DOCUME~1\grafik\LOCALS~1\Temp\jambeccf03.000
<?xml version="1.0"?>
<!DOCTYPE catalog
   PUBLIC "-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN"
   "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">
   <rewriteURI 
uriStartString="http://www.boost.org/tools/boostbook/dtd/" 
rewritePrefix="file:///Boost/share/boostbook/dtd/"/>
   <rewriteURI 
uriStartString="http://docbook.sourceforge.net/release/xsl/current/" 
rewritePrefix="file:///Boost/share/docbook-xsl-1.74.0/"/>
   <rewriteURI 
uriStartString="http://www.oasis-open.org/docbook/xml/4.2/" 
rewritePrefix="file:///Boost/share/docbook-xml-4.5/"/>
</catalog>

text-action ..\..\..\bin.v2\boostbook_catalog.xml

Which correctly points to my versions of tool sources (I should know 
since I fixed this part of doc building long ago). The xsltproc commands 
look like:

xslt-xsltproc 
..\..\..\bin.v2\tools\quickbook\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\quickbook.docbook

     set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml
  "C:/Boost/bin/xsltproc.exe" --stringparam boost.libraries 
"../../../../libs/libraries.htm" --stringparam boost.root "../../../.." 
--stringparam chunk.first.sections "1" --stringparam chunk.section.depth 
"2" --stringparam generate.section.toc.level "3" --stringparam 
html.stylesheet "../../../../doc/html/boostbook.css" --xinclude -o 
"..\..\..\bin.v2\tools\quickbook\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\quickbook.docbook" 
"\Boost\share\boostbook\xsl\docbook.xsl" 
"..\..\..\bin.v2\tools\quickbook\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\quickbook.xml"

xslt-xsltproc-dir html\standalone_HTML.manifest

     set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml
  "C:/Boost/bin/xsltproc.exe" --stringparam boost.libraries 
"../../../../libs/libraries.htm" --stringparam boost.root "../../../.." 
--stringparam chunk.first.sections "1" --stringparam chunk.section.depth 
"2" --stringparam generate.section.toc.level "3" --stringparam 
html.stylesheet "../../../../doc/html/boostbook.css" --stringparam 
manifest "standalone_HTML.manifest" --xinclude -o "html/" 
"\Boost\share\boostbook\xsl\html.xsl" 
"..\..\..\bin.v2\tools\quickbook\doc\msvc-9.0xp\dbg\lnk-sttc\thrd-mlt\quickbook.docbook"

Which has the references to the just generated catalog. Running the 
xsltproc command manually to see the verbose output:

creating dictionary for stylesheet
reusing dictionary from /Boost/share/boostbook/xsl/html.xsl for stylesheet
xsltParseStylesheetProcess : found stylesheet
xsltPrecomputeStylesheet: removing ignorable blank node
Reusing dictionary for document
warning: failed to load external entity 
"http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"
compilation error: file /Boost/share/boostbook/xsl/html.xsl line 16 
element import
xsl:import : unable to load 
http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl
Reusing dictionary for document
warning: failed to load external entity 
"http://docbook.sourceforge.net/release/xsl/current/html/math.xsl"
compilation error: file /Boost/share/boostbook/xsl/html.xsl line 18 
element import
xsl:import : unable to load 
http://docbook.sourceforge.net/release/xsl/current/html/math.xsl

Shows that it does read the local XSL sources, yet it still error in 
some form. This used to not be a problem as it would just issue warnings 
instead of erroring about XSL files that have been clearly redirected.

-- 
-- Grafik - Don't Assume Anything
-- Redshift Software, Inc. - http://redshift-software.com
-- rrivera/acm.org (msn) - grafik/redshift-software.com
-- 102708583/icq - grafikrobot/aim,yahoo,skype,efnet,gmail