Re: need help with building QuickBook docs

From: pbristow_at_[hidden]
Date: 2022-05-23 08:11:54

> -----Original Message-----
> From: Boost <boost-bounces_at_[hidden]> On Behalf Of Andrey Semashev via Boost
> Sent: 22 May 2022 23:27
> To: boost_at_[hidden]
> Cc: Andrey Semashev <andrey.semashev_at_[hidden]>
> 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