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

From: Vladimir Prus (ghost_at_[hidden])
Date: 2007-11-20 01:07:16

Edward Diener wrote:

> 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 ?

In fact, that link is not necessary at least. I believe the official xstlproc
release is better bet.

- Volodya