Re: [boost] need help with building QuickBook docs

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/ Regards, &rzej; pon., 23 maj 2022 o 22:54 Andrzej Krzemienski napisał(a):

pon., 23 maj 2022 o 22:11 Andrey Semashev via Boost napisał(a):

...

On 5/23/22 22:14, Andrzej Krzemienski wrote:

...

pon., 23 maj 2022 o 00:30 Andrey Semashev via Boost > > Are you using the latest built QuickBook > executable?

How can I check my version of QuickBook?

quickbook --version

But if you need to ask, it is probably better to just build it from sources.

$ quickbook --version Quickbook Version 1.7.2 (Boost 1.76)

...

...

Also, make sure you don't have some stale content in bin.v2. Your

log

...

doesn't indicate that QuickBook was run, probably because the

BoostBook

...

document was already there.

I now removed everything from folder bin.v2 before running `b2 doc`. I still get the same result. Maybe there is a way to see intermediate results, such as the generated BoostBook format?

The intermediate results can be found in bin.v2/libs/optional.

So, the only intermediate result I found there is bin.v2/libs/optional/doc/optional.xml (enclosed). It has:

<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN" " http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">

Which is the output of quickbook, I suppose.

I am using libxslt-1.1.35-1.fc36.x86_64, and it seems the lowest one that I can get on my Fedora.

# xsltproc --version Using libxml 20914, libxslt 10135 and libexslt 820 xsltproc was compiled against libxml 20912, libxslt 10135 and libexslt 820 libxslt 10135 was compiled against libxml 20912 libexslt 820 was compiled against libxml 20912

Regards, &rzej;

...

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