Re: need help with building QuickBook docs

From: Andrzej Krzemienski (akrzemi1_at_[hidden])
Date: 2022-05-24 17:10:02

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 <akrzemi1_at_[hidden]>
napisał(a):

>
>
> pon., 23 maj 2022 o 22:11 Andrey Semashev via Boost <boost_at_[hidden]>
> 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
>>
>