Quick-doc (or BJAM?) problem generating boostbook XML (HELP ! :) )

From: Brian Braatz (brianb_at_[hidden])
Date: 2005-09-07 18:52:46

I have now tried this on both OSX and WinXP- 1.33 boost distribution.

I can BUILD the docs for boost (without error it appears). I can run the unit tests (via bjam) I can build and link and all sorts of wonderful things.

BUT- I cannot get quickdoc to produce the boost book xml without a strangeerror.

I am preparing a library for preview- which is why I am fighting this problem- I decided to try it out on the quickbook docs\jamfile itself to see if I did something. And it turns out (on both XP and OSX) I get the exact sameerror

here is the output (it DOES generate the quickdoc HTML- just errors on making the XML for boostbook)

HAS ANYONE RUN INTO THIS???

THANKS 
Brian

OUTPUT:

$ bjam --v2 
warning: Python location is not configured
warning: the Boost.Python library won't be built
Building Boost.Regex with the optional Unicode/ICU support disabled.
Please refer to the Boost.Regex documentation for more information
(and if you don't know what ICU is then you probably don't need it).
...found 19 targets...
...updating 1 target...
xslt-xsltproc-dir html/HTML.manifest
../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.docbook:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
^
Writing quickbook/syntax.html for section(quickbook.syntax)
Writing quickbook/ref.html for section(quickbook.ref)
Writing quickbook/docinfo.html for section(quickbook.docinfo)
Writing quickbook/quickbook.html for section(quickbook.quickbook)
Writing quickbook/highlight.html for section(quickbook.highlight)
Writing quickbook/pyhighlight.html for section(quickbook.pyhighlight)
Writing index.html for part(quickbook)
Writing HTML.manifest
...updated 1 target...

*********************************************
NOW - here is the same data with -d2 passed to BJAM:

$ bjam -a --v2 -d2
warning: Python location is not configured
warning: the Boost.Python library won't be built
Building Boost.Regex with the optional Unicode/ICU support disabled.
Please refer to the Boost.Regex documentation for more information
(and if you don't know what ICU is then you probably don't need it).
...found 19 targets...
...updating 4 targets...
text-action ../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml

echo "<?xml version=\"1.0\"?>" > "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml" 

echo "<!DOCTYPE catalog " >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo " PUBLIC \"-//OASIS/DTD Entity Resolution XML Catalog V1.0//EN\"" >>"../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo " \"http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd\">" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo "<catalog xmlns=\"urn:oasis:names:tc:entity:xmlns:xml:catalog\">" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo " <rewriteURI uriStartString=\"http://www.boost.org/tools/boostbook/dtd/\" rewritePrefix=\"file:///Users/brianbraatz/Documents/code/V_1_33/tools/boostbook/dtd//\"/>" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo " <rewriteURI uriStartString=\"http://docbook.sourceforge.net/release/xsl/current/\" rewritePrefix=\"file:///Users/brianbraatz/doctools/docbook-xsl-1.67.2/\"/>" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo " <rewriteURI uriStartString=\"http://www.oasis-open.org/docbook/xml/4.2/\" rewritePrefix=\"file:///Users/brianbraatz/dotools/docbook-dtd-4.2/\"/>" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
echo "</catalog>" >> "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml"
 

quickbook.quickbook-to-boostbook ../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.xml

/Users/brianbraatz/bin/quickbook quickbook.qbk ../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.xml ;

Generating Output File: ../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.xml
xslt-xsltproc ../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.docbook

XML_CATALOG_FILES=../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml
export XML_CATALOG_FILES
"/usr/bin/xsltproc" --stringparam boost.libraries ../../../../libs/libraries.htm --stringparam boost.root ../../../.. --xinclude -o "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.docbook" "/Users/brianbraatz/Documents/code/V_1_33/tools/boostbook/xsl/docbook.xsl" "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.xml" 

file:///Users/brianbraatz/Documents/code/V_1_33/tools/boostbook/dtd//boostbook.dtd:412: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
%DocBook;
^
Entity: line 1: 
%DocBook; 
^
../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.xml:617: parser error : Entity 'nbsp' not defined
<phrase role="identifier">using</phrase>&nbsp;<ulink url="index.html">quickbook<
^
xslt-xsltproc-dir html/HTML.manifest

XML_CATALOG_FILES=../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/catalog.xml
export XML_CATALOG_FILES
"/usr/bin/xsltproc" --stringparam boost.libraries ../../../../libs/libraries.htm --stringparam boost.root ../../../.. --xinclude -o "html/" "/Users/brianbraatz/Documents/code/V_1_33/tools/boostbook/xsl/html.xsl" "../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.docbook" 

../../../bin.v2/tools/quickbook/doc/darwin/debug/link-static/runtime-link-static/quickbook.docbook:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
D DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
^
Writing quickbook/syntax.html for section(quickbook.syntax)
Writing quickbook/ref.html for section(quickbook.ref)
Writing quickbook/docinfo.html for section(quickbook.docinfo)
Writing quickbook/quickbook.html for section(quickbook.quickbook)
Writing quickbook/highlight.html for section(quickbook.highlight)
Writing quickbook/pyhighlight.html for section(quickbook.pyhighlight)
Writing index.html for part(quickbook)
Writing HTML.manifest
...updated 4 targets...