Re: [boost] need help with building QuickBook docs

-----Original Message----- From: Boost On Behalf Of Andrey Semashev via Boost Sent: 22 May 2022 23:27 To: boost@lists.boost.org Cc: Andrey Semashev Subject: Re: [boost] need help with building QuickBook docs

On 5/22/22 17:45, Andrzej Krzemienski via Boost wrote:

...

Thank you. This seems to remove the first obstacle on my way to building Boost.Optional docs. I am now using B2 Version 4.9. OS=LINUX. I get the error from another tool, I suppose:

[2] gcc-12/release/cxxstd-0x-iso/link-static/python-3.10/threadapi-pthread /threading-multi/visibility-hidden ...patience... ...patience... ...found 4351 targets... ...updating 2 targets... xslt-xsltproc ../../../bin.v2/libs/optional/doc/optional.docbook runtime error: file /home/andrzej/Repos/boost/tools/boostbook/xsl/annotation.xsl line 432 element element xsl:element: The effective name '' is not a valid QName.

Is it DocBook, QuickBok, BoostBook? (I enclose the full error report.) I am just running b2 on boost/libs/optional/doc from the official repo. Can someone confirm if they see the same problem? or is it just me?

I think, this is coming from from incorrect (unexpected?) generated BoostBook document that was produced by QuickBook. xsltproc then applies BoostBook stylesheets to convert it to Docbook and fails.

On my local machine Boost.Optional docs from develop build successfully, although with the following warning:

23_ref_optional_io.qbk:45: warning: line breaks generate invalid boostbook (will only note first occurrence).

If this warning is from using [br] (at least once) then it is entirely normal and can be ignored. Paul