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

From: Ilya Sokolov (fal_delivery_at_[hidden])
Date: 2007-11-20 03:19:20

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.

Has it produced something?
BTW, error code may be less than zero on windows

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

 From 
http://boost.org/doc/html/boostbook/getting/started.html#boostbook.setup.running:

<quote>
html     HTML output (multiple files). This is the default
onehtml  HTML output in a single HTML file.
</quote>

With metacomm' xsltproc installed, 'bjam html' (or just 'bjam') silently 
fails for me, but 'bjam onehtml' works. Binaries from 
http://www.zlatkovic.com/libxml.en.html work in both cases.

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

AFAICT, its purpose is to contain this old fix:
http://mail.gnome.org/archives/xslt/2004-November/msg00030.html

BoostBook docs should be updated to point to binary packages made by 
Igor Zlatkovic, IMHO.