Re: need help with building QuickBook docs

From: Andrey Semashev (andrey.semashev_at_[hidden])
Date: 2022-05-25 12:31:42

On 5/24/22 20:10, Andrzej Krzemienski wrote:
> I managed to figure out that it is this command that triggers the error:
> 
>     "xsltproc" -v --stringparam boost.defaults "Boost" --stringparam
>     boost.libraries "../../../../libs/libraries.htm" --stringparam
>     boost.root "../../../.." --stringparam chapter.autolabel "0"
>     --stringparam chunk.section.depth "8" --stringparam
>     generate.section.toc.level "1" --stringparam toc.max.depth "2"
>     --stringparam toc.section.depth "2" --path "../../bin.v2" --path
>     "../../bin.v2/libs/optional/doc" --xinclude -o
>     "../../bin.v2/libs/optional/doc/optional.docbook"
>     "/home/andrzej/Repos/boost/tools/boostbook/xsl/docbook.xsl"
>     "../../bin.v2/libs/optional/doc/optional.xml"
> 
> 
> I am using xsl files in boost/tools/boostbook/xsl from Boost repo. The
> contents of optional.xml are attached.
> 
> It looks like QuickBook went fine. Well, this is now manageable. I got
> it to the point where QuickBook can detect bugs in my *.qbk files, and I
> can commit changes in documentation without the fear of introducing
> broken sources, but without the comfort of seeing the end results. I can
> then watch them in https://www.boost.org/doc/libs/develop/
> <https://www.boost.org/doc/libs/develop/>

In my local build optional.xml is the same, barring the timestamp, and
the command above (with adjusted paths) succeeds and produces mostly the
same optional.docbook (there is one difference in an orderedlist tag
attributes, which I don't think is important; diff attached).

At this point I suspect it's either locale or xsltproc. I'm not sure if
Boost.Book stylesheets use DocBook stylesheets internally, but if they
do, those might also be the culprit.

Just in case, I'm on Kubuntu 22.04 with stock versions of xsltproc and
docbook-xml and docbook-xsl packages:

xsltproc: 1.1.34-4build2
docbook-xml: 4.5-11
docbook-xsl: 1.79.2+dfsg-1