Re: [Boost-build] building documentation with boostbook

Subject: Re: [Boost-build] building documentation with boostbook
From: John Maddock (jz.maddock_at_[hidden])
Date: 2015-07-17 12:39:10

>
> Meanwhile, I'm trying to compile quickbook and boostbook the usual way.
> What is the suggested b2 command to build and install those two tools ?
> The --with-libraries option only lists libraries, but no tools.
>
> I was able to build quickbook (then manually copying it into the desired
> install location), but I wasn't able to do that with boostbook, as the
> 'setup-boostbook.sh' script just prepares the current location itself
> (the modular-boost source tree) to contain third-party tools such as fop
> and DocBook stylesheets).
> Is there a way to force the build process to use system versions of fop
> and stylesheets already installed, and then install the boostbook tool
> for system-wide use ?
There is no boostbook tool as such, just the docbook stylesheets. Have 
you looked at 
https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted ?

Note that:

* System installed stylesheets are probably not what you need anyway 
since we're tied to a specific docbook DTD version - using any other DTD 
version will almost certainly cause you grief.  The XSL stylesheets and 
system supplied xsltproc you can of course use.

* I'd also generally advise against FOP for anything but 
casual/lightweight use as it tends not be very reliable sadly :(

HTH, John.
> Again, my ultimate goal is to be able to work on Boost libraries (or in
> fact, any software using boost.build and other boost tools) without
> having a full boost source tree. Unfortunately this is still very hard...
>
> Thanks,
>          Stefan
>
>