Mac OS X, Snow Leopard (or later) FOR MAC BOOS

Mac OS X, Snow Leopard (or later)

Section contributed by Julio M. Merino Vidal

The text below assumes you want to install all the necessary utilities in a system-wide location, allowing any user in the machine to have access to them. Therefore, all files will be put in the /usr/local hierarchy. If you do not want this, you can choose any other prefix such as ~/Applications for a single-user installation.
Snow Leopard comes with xsltproc and all related libraries preinstalled, so you do not need to take any extra steps to set them up. It is probable that future versions will include them too, but these instructions may not apply to older versions.
To get started:

1. Download Docbook XML 4.2 and unpack it inside /usr/local/share/xml/docbook/4.2.
2. Download the latest Docbook XSL version and unpack it. Be careful that you download the correct file, sometimes the 'looking for the latest version' link often links to another file. The name should be of the form docbook-xsl-1.nn.n.tar.bz2, with no suffix such as -ns.tar.bz2 or -doc.tar.bz2. Put the results in /usr/local/share/xsl/docbook, thus effectively removing the version number from the directory name (for simplicity).
3. Add the following to your user-config.jam file, which should live in your home directory (/Users/<your_username>). You must already have it somewhere or otherwise you could not be building Boost (i.e. missing tools configuration).

   using xsltproc ;
   
   using boostbook
       : "/usr/local/share/xsl/docbook"
       : "/usr/local/share/xml/docbook/4.2"
       ;
    

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 and install a system-wide Quickbook instead:

1. Go to Quickbook's source directory (BOOST_ROOT/tools/quickbook).
2. Build the utility by issuing bjam.
3. Copy the resulting quickbook binary (located at BOOST_ROOT/dist/bin) to a safe place. Following our previous example, you can install it into: /usr/local/bin.
4. Add the following to your user-config.jam file:

   using quickbook
       : "/usr/local/bin/quickbook" ;
       ;
    

Additionally, if you need to build documentation that uses Doxygen, you will need to install it too:

1. Go to the downloads section and get the disk image (dmg file) for Mac OS X.
2. Open the disk image and drag the Doxygen application to your Applications folder to install it.
3. Add the following to your user-config.jam file:

   using doxygen
       : /Applications/Doxygen.app/Contents/Resources/doxygen
       ;
    

MAC OS X,using macports (mac boosting)

Mac OS X, using macports

First install the libxslt, docbook-xsl and docbook-xml-4.2 packages:

sudo port install libxslt docbook-xsl docbook-xml-4.2

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
    : /opt/local/bin/xsltproc
    ;

using boostbook
    : /opt/local/share/xsl/docbook-xsl/
    : /opt/local/share/xml/docbook/4.2
    ;

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:

1. Go to Quickbook's source directory (BOOST_ROOT/tools/quickbook).
2. Build the utility by issuing bjam.
3. Copy the resulting quickbook binary (located at BOOST_ROOT/dist/bin) to a safe place. The traditional location is /usr/local/bin.
4. Add the following to your user-config.jam file, using the full path of the quickbook executable:

   using quickbook
       : /usr/local/bin/quickbook
       ;
    

If you need to build documentation that uses Doxygen, you will need to install it as well:

sudo port install doxygen

And then add to your user-config.jam:

using doxygen ;