I'm trying to generate the docs for boost. I'm looking at the instructions at http://www.boost.org/doc/libs/1_41_0/doc/html/boostbook/getting/started.html I've installed: docbook-xml-4.2 docbook-xsl-175.2 fop-0.95 Jimi 1.0 (and done the 'move and rename' bit into fop) I believe that I've set up my user-config.jam correctly (attached). And when I try to build something, I get errors about "unable to external entity <a sourceforge URL>". If I take the <a sourceforge URL> and try to curl it, I get something that looks reasonable. Any suggestions? [ Oh, yeah: Mac OS X 10.6, gcc 4.2.1, from the trunk. ] -- Marshall
$ bjam --v2 onehtml ...patience... ...found 1251 targets... ...updating 1 target... xslt-xsltproc ../../../bin.v2/libs/fusion/doc/darwin-4.2.1/debug/fusion.html warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl" compilation error: file /Users/marshall/Sources/boost/tools/boostbook/xsl/html-single.xsl line 15 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/html/admon.xsl" compilation error: file /Users/marshall/Sources/boost/tools/boostbook/xsl/admon.xsl line 12 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/html/admon.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl" compilation error: file /Users/marshall/Sources/boost/tools/boostbook/xsl/relative-href.xsl line 12 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl
XML_CATALOG_FILES="../../../bin.v2/boostbook_catalog.xml" export XML_CATALOG_FILES "xsltproc" --stringparam boost.libraries "../../../libraries.htm" --stringparam boost.root "../../../.." --stringparam chunk.first.sections "1" --stringparam chunk.section.depth "4" --stringparam generate.section.toc.level "4" --stringparam html.stylesheet "../../../../doc/html/boostbook.css" --stringparam toc.max.depth "3" --stringparam toc.section.depth "3" --xinclude -o "../../../bin.v2/libs/fusion/doc/darwin-4.2.1/debug/fusion.html" "/Users/marshall/Sources/boost/tools/boostbook/xsl/html-single.xsl" "../../../bin.v2/libs/fusion/doc/darwin-4.2.1/debug/fusion.docbook"
...failed xslt-xsltproc ../../../bin.v2/libs/fusion/doc/darwin-4.2.1/debug/fusion.html... ...failed updating 1 target...
mclow-mac:doc marshall$ curl http://docbook.sourceforge.net/release/xsl/current/lib/lib.xsl | bbedit % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 18500 100 18500 0 0 76291 0 --:--:-- --:--:-- --:--:-- 141k
And when I try to build something, I get errors about "unable to external entity <a sourceforge URL>". If I take the <a sourceforge URL> and try to curl it, I get something that looks reasonable.
This is almost always caused by incorrect paths to the Docbook stylesheets etc in the user-config.jam. Further if you change these paths then you will need to do a bjam -a to force a full rebuild next time you try and build, otherwise the old paths will still be present in various cached files :-( BTW The main setup guide is now: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted HTH, John.
participants (2)
-
John Maddock
-
Marshall Clow