Re: need help with building QuickBook docs

From: Andrzej Krzemienski (akrzemi1_at_[hidden])
Date: 2022-05-22 16:36:59

niedz., 22 maj 2022 o 17:33 <pbristow_at_[hidden]> napisał(a):

> I don’t see where annotation.xsl comes from, or what is should contain
> (but it looks as though it contains something wrong!!).
>
>
>
> Can you share it with us?  And any metadata?
>

The file comes from the boostbook repo:
https://github.com/boostorg/boostbook/blob/develop/xsl/annotation.xsl
I applied no modifications.

>
>
> None of this looks familiar to me from generating Quickbook docs ☹
>
>
>
> Paul
>
>
>
> PS I also view items reported as cached with suspicion, as a result of
> being bitten before.
>
>
>
> Especially when there are two difference versions.
>
>
>
>
> https://stackoverflow.com/questions/5709105/how-do-i-force-bjam-in-boost-to-build-cleanly-and-consistently
> may help.
>

Thanks for the idea. I'll try it later, in the evening.

Regards,
&rzej;

>
>
>
>
> *From:* Andrzej Krzemienski <akrzemi1_at_[hidden]>
> *Sent:* 22 May 2022 15:45
> *To:* Boost mailing list <boost_at_[hidden]>
> *Cc:* pbristow_at_[hidden]
> *Subject:* Re: [boost] need help with building QuickBook docs
>
>
>
>
>
>
>
> niedz., 22 maj 2022 o 15:52 Paul A Bristow via Boost <
> boost_at_[hidden]> napisał(a):
>
> > -----Original Message-----
> > From: Boost <boost-bounces_at_[hidden]> On Behalf Of Andrzej
> Krzemienski via Boost
> > Sent: 22 May 2022 14:14
> > To: René Ferdinand Rivera Morell <grafikrobot_at_[hidden]>
> > Cc: Andrzej Krzemienski <akrzemi1_at_[hidden]>; Boost Developers List <
> boost_at_[hidden]>
> > Subject: Re: [boost] need help with building QuickBook docs
> >
> > Thanks. That would be the most likely cause of my problems. Could you
> point me to instructions for
> > rebuilding the b2 engine executable?
>
>
>
> https://www.boost.org/doc/libs/1_79_0/more/getting_started/windows.html#get-boost
>
>
> Section 5.1    Simplified Build From Source
>
> If you wish to build from source with Visual C++, you can use a simple
> build procedure described in this section. Open the command prompt and
> change your current directory to the Boost root directory. Then, type the
> following commands:
>
> bootstrap
> .\b2
> The first command prepares the Boost.Build system for use. The second
> command invokes Boost.Build to build the separately-compiled Boost
> libraries. Please consult the Boost.Build documentation for a list of
> allowed options.
>
> https://www.boost.org/doc/libs/1_79_0/tools/build/doc/html/index.html
>
>
> https://www.boost.org/doc/libs/1_79_0/tools/build/doc/html/index.html#bbv2.installation
>
> Run either .\bootstrap.bat (on Windows), or ./bootstrap.sh (on other
> operating systems)
>
> (which may be too simple.  By default, Windows 10 and up, probably don't
> provide cmd.exe, preferring the fancy new command shell Windows
> PowerShell)
>
> b2 -v  will show the current version.
>
> You will probably want to ensure that b2.exe is visible globally, perhaps
> by adding to PATH.  Perhaps using the Windows Environment Variables editor?
>
> HTH
>
> Paul
>
>
>
> 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?
>
>
>
> Regards,
>
> &rzej;
>
>
>
>
>
>
>
>
>
>
> _______________________________________________
> Unsubscribe & other changes:
> http://lists.boost.org/mailman/listinfo.cgi/boost
>
>