...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
The following instructions apply to Debian and its derivatives. They are based on a Ubuntu Edgy install but should work on other Debian based systems.
First install the bjam
,
xsltproc
, docbook-xsl
and
docbook-xml
packages. For example, using apt-get
:
sudo apt-get install xsltproc docbook-xsl docbook-xml
If you're planning on building boost's documentation, you'll also need to
install the doxygen
package
as well.
Next, we need to configure Boost Build to compile BoostBook files. Add the
following to your user-config.jam
file, which should be in your home
directory. If you don't have one, create a file containing this text. For
more information on setting up user-config.jam
, see
the Boost
Build documentation.
using xsltproc ; using boostbook : /usr/share/xml/docbook/stylesheet/nwalsh : /usr/share/xml/docbook/schema/dtd/4.2 ; # Remove this line if you're not using doxygen using doxygen ;
The above steps are enough to get a functional BoostBook setup. Quickbook will be automatically built when needed. If you want to avoid these rebuilds:
BOOST_ROOT/tools/quickbook
).
bjam
--v2
.
quickbook
binary (located under the BOOST_ROOT/bin.v2
hierarchy)
to a safe place. The traditional location is /usr/local/bin
.
user-config.jam
file, using the full path of the quickbook executable:
using quickbook : /usr/local/bin/quickbook ;