« Return to Thread: [boostbook] Building Boost documentation

Re: [boostbook] Building Boost documentation

by Edward Diener-3 :: Rate this Message:

Reply to Author | View in Thread

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 ?

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost-build

 « Return to Thread: [boostbook] Building Boost documentation