Re: [Boost-build] [boostbook] Building Boost documentation

From: Edward Diener (eldiener_at_[hidden])
Date: 2007-11-19 18:19:01

Ilya Sokolov wrote:
> Edward Diener wrote:
>> Rene Rivera wrote:
>>> Edward Diener wrote:
>>>> ...updating 1 target...
>>>> xslt-xsltproc-dir html\function-doc_HTML.manifest
>>>>
>>>>    set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml
>>>>   "xsltproc" --stringparam manifest "function-doc_HTML.manifest" 
>>>> --xinclude -o "h
>>>> tml/" "E:\Programming\Version 
>>>> Control\Subversion\Boost\tools\boostbook\xsl\html.
>>>> xsl" "..\..\..\bin.v2\libs\function\doc\msvc-8.0\debug\function.docbook"
>>>>
>>>> ...failed xslt-xsltproc-dir html\function-doc_HTML.manifest...
>>>> ...failed updating 1 target..."
>>>>
>>>> What does the failure mean ?
>>> That's weird. Usually programs tell you why things fail. Try running the 
>>> same commands in a shell to see if you get the same problem. Or if it 
>>> gives some useful errors.
>> Running:
>>
>> "xsltproc" --stringparam manifest "function-doc_HTML.manifest" 
>> --xinclude -o "html/" "E:\Programming\Version 
>> Control\Subversion\Boost\tools\boostbook\xsl\html.xsl" 
>> "..\..\..\bin.v2\libs\function\doc\msvc-8.0\debug\function.docbook"
>>
>> from the command line succeeds. 
> 
> are you sure? how did you determine that? (i think i've seen exactly 
> this problem already)

By succeed I mean that it returns no errors to stderr or stdout and 
returns no error code of 1 or above.

> 
>> I have no idea why bjam would say it 
>> fails. What the command is supposed to do I do not know.
> 
> 1. try "bjam onehtml"

What is that supposed to do ?

> 2. try another xsltproc (e.g. http://www.zlatkovic.com/libxml.en.html)

I will give it a try, but this business of trying to setup and use the 
Boost documentation system, according to instructions, and failing to be 
able to do so, is getting old. I think Boost should either consider 
something better than this mess or get it working someday in this century.

I did get the xsltproc directly from the link in the The BoostBook 
Documentation Format, and that link is at 
http://www.meta-comm.com/engineering/boost/xsltproc-win32.zip. Is that 
link's implementation of xsltproc broken perhaps ?