Boostio Mac OS
- Mac OS X
- Windows 2000, XP, 2003, Vista, 7
- Debian, Ubuntu
This section provides some guidelines on how to install and configure BoostBook and Quickbook under several operating systems. Before installing you'll need a local copy of boost, and to install the version of bjam
which comes with it (or a later version).
Browse the newest, top selling and discounted macOS supported games. Embed external tools like a Figma, Miro, Draw.io and so on by pasting its iframe embed script. Connect with 2000+ tools using Zapier Integrate external tools via Zapier and automate your workflow.
- Mac OS X, using macports
- Mac OS X, Snow Leopard (or later)
The simplest way to install on OS X is to use macports. If you don't want to use macports and are using Snow Leopard or later, there are instructions later. Earlier versions of OS X need to use something like macports to install xsltproc
because the version they come with is very old, and doesn't have good enough XSL support for boostbook's stylesheets.
First install the libxslt
, docbook-xsl
and docbook-xml-4.2
packages:
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.
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:
- Go to Quickbook's source directory (
BOOST_ROOT/tools/quickbook
). - Build the utility by issuing
bjam
. - Copy the resulting
quickbook
binary (located atBOOST_ROOT/dist/bin
) to a safe place. The traditional location is/usr/local/bin
. Add the following to your
user-config.jam
file, using the full path of the quickbook executable:
If you need to build documentation that uses Doxygen, you will need to install it as well:
And then add to your user-config.jam
:
Alternatively, you can install from the official doxygen dmg
. This is described at the end of the next section.
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:
- Download Docbook XML 4.2 and unpack it inside
/usr/local/share/xml/docbook/4.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). 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).
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:
- Go to Quickbook's source directory (
BOOST_ROOT/tools/quickbook
). - Build the utility by issuing
bjam
. - Copy the resulting
quickbook
binary (located atBOOST_ROOT/dist/bin
) to a safe place. Following our previous example, you can install it into:/usr/local/bin
. Add the following to your
user-config.jam
file:
Boostio Mac Os Catalina
Additionally, if you need to build documentation that uses Doxygen, you will need to install it too:
- Go to the downloads section and get the disk image (
dmg
file) for Mac OS X. - Open the disk image and drag the Doxygen application to your
Applications
folder to install it. Add the following to your
user-config.jam
file:
Section contributed by Julio M. Merino Vidal
The following instructions apply to any Windows system based on Windows 2000, including Windows XP, Windows 2003 Server, Windows Vista, and Windows 7. The paths shown below are taken from a Windows Vista machine; you will need to adjust them to match your system in case you are running an older version.
- First of all you need to have a copy of
xsltproc
for Windows. There are many ways to get this tool, but to keep things simple, use the binary packages made by Igor Zlatkovic. At the very least, you need to download the following packages:iconv
,zlib
,libxml2
andlibxslt
. - Unpack all these packages in the same directory so that you get unique
bin
,include
andlib
directories within the hierarchy. These instructions useC:UsersexampleDocumentsboostxml
as the root for all files. - From the command line, go to the
bin
directory and launchxsltproc.exe
to ensure it works. You should get usage information on screen. - Download Docbook XML 4.2 and unpack it in the same directory used above. That is:
C:UsersexampleDocumentsboostxmldocbook-xml
. - Download the latest Docbook XSL version and unpack it, again in the same directory used before. 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
. To make things easier, rename the directory created during the extraction todocbook-xsl
(bypassing the version name):C:UsersexampleDocumentsboostxmldocbook-xsl
. Add the following to your
user-config.jam
file, which should live in your home directory (%HOMEDRIVE%%HOMEPATH%
). You must already have it somewhere or otherwise you could not be building Boost (i.e. missing tools configuration).
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:
- Go to Quickbook's source directory (
BOOST_ROOTtoolsquickbook
). - Build the utility by issuing
bjam
. - Copy the resulting
quickbook.exe
binary (located atBOOST_ROOTdistbin
) to a safe place. Following our previous example, you can install it into:C:UsersexampleDocumentsboostxmlbin
. Add the following to your
user-config.jam
file:
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. They assume you've already installed an appropriate version of bjam
for your copy of boost.
First install the xsltproc
, docbook-xsl
and docbook-xml
packages. For example, using apt-get
:
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.
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:
- Go to Quickbook's source directory (
BOOST_ROOT/tools/quickbook
). - Build the utility by issuing
bjam
. - Copy the resulting
quickbook
binary (located atBOOST_ROOT/dist/bin
) to a safe place. The traditional location is/usr/local/bin
. Add the following to your
user-config.jam
file, using the full path of the quickbook executable:
As of this writing, MM is using the Boost 1.40 release. There are reasonably complete instructions here: http://www.boost.org/doc/libs/1_40_0/more/getting_started/unix-variants.html
Briefly:
- Download boost 1.40.0
- tar --bzip2 -xf /path/to/boost_1_40_0.tar.bz2
- ./bootstrap.sh, (to build the bjam tool)
- Now to build only the libraries needed by Micro-Manager (a huge time saver), do:
Boostio Mac Os X
sudo ./bjam --install --link=static --runtime-link=static --threading=multi --layout=tagged --with-system --with-thread --with-iostreams --with-date_time
(Now when building micromanager, configure should have the flag:--with-boost-libdir=/path/to/your/boost/libs
)
If you wish to build Universal Binaries, you will need to build boost separately for each architecture. You can do so with the following build script:
# Note: build for ppc and i386 should be with g++4.0. Build for x86_64 should be with g++4.2.
# to accomplish this, the file tools/build/v2/user-config.jam should contain the following two lines:
# using darwin : 4.0 : g++-4.0 ;
#
# using darwin : 4.2 : g++-4.2 ;
sudo ./bjam --install --build-dir=ppc --toolset=darwin --link=static --runtime-link=static --threading=multi --layout=tagged --prefix=/usr/local/ppc architecture=power address-model=32 macosx-version-min=10.4 --with-system --with-thread --with-iostreams --with-date_time --libdir=/usr/local/ppc/lib --includedir=/usr/local/ppc/include --stagedir=/usr/local/ppc
sudo ./bjam --install --build-dir=i386 --toolset=darwin --link=static --runtime-link=static --threading=multi --layout=tagged --prefix=/usr/local/i386 architecture=x86 address-model=32 macosx-version-min=10.4 --with-system --with-thread --with-iostreams --with-date_time --libdir=/usr/local/i386/lib --includedir=/usr/local/i386/include --stagedir=/usr/local/i386
sudo ./bjam --install --build-dir=x86_64 --toolset=darwin-4.2 --link=static --runtime-link=static --threading=multi --layout=tagged --prefix=/usr/local/x86_64 architecture=x86 address-model=64 macosx-version-min=10.5 --with-system --with-thread --with-iostreams --with-date_time --libdir=/usr/local/x86_64/lib --includedir=/usr/local/x86_64/include --stagedir=/usr/local/x86_64