boost/more
1
0
Fork 0
mirror of https://github.com/boostorg/more.git synced 2026-08-22 13:03:28 +08:00
Code Issues Packages Projects Releases Wiki Activity

Clneaup... Update license statements, HTMLTidy, add missing toolsets, remove dead toolsets.

Browse Source 
[SVN r25539]
This commit is contained in:
Rene Rivera
2004-10-03 16:28:44 +00:00
parent 47c2dc4791
commit c138da53f1
1 changed files with 1108 additions and 1093 deletions
Download Patch File Download Diff File Expand all files Collapse all files

543
getting_started.html
View File

@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html> <html>
<head> <head>
<meta name="generator" content= <meta name="generator" content=
"HTML Tidy for Cygwin (vers 1st April 2002), see www.w3.org"> "HTML Tidy for Cygwin (vers 1st April 2002), see www.w3.org">
@@ -10,11 +10,10 @@
<meta http-equiv="Content-Language" content="en-us"> <meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii"> <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<link rel="stylesheet" type="text/css" href="../boost.css"> <link rel="stylesheet" type="text/css" href="../boost.css">
</head> </head>
<body bgcolor="#FFFFFF" text="#000000"> <body bgcolor="#FFFFFF" text="#000000">
<table summary="" width="100%" border="0" cellspacing="0" cellpadding= <table summary="" width="100%" border="0" cellspacing="0" cellpadding="0">
"0">
<tr valign="top"> <tr valign="top">
<td valign="top" align="left"><img src="../c%2B%2Bboost.gif" alt= <td valign="top" align="left"><img src="../c%2B%2Bboost.gif" alt=
"c++boost.gif (8819 bytes)" width="277" height="86"></td> "c++boost.gif (8819 bytes)" width="277" height="86"></td>
@@ -27,8 +26,7 @@
<tr> <tr>
<td bgcolor="#DDDDDD"> <td bgcolor="#DDDDDD">
<p>.&nbsp;<a href="../index.htm">Home</a><br> <p>.&nbsp;<a href="../index.htm">Home</a><br>
.&nbsp;<a href= .&nbsp;<a href="../libs/libraries.htm">Libraries</a><br>
"../libs/libraries.htm">Libraries</a><br>
.&nbsp;<a href="../people/people.htm">People</a><br> .&nbsp;<a href="../people/people.htm">People</a><br>
.&nbsp;<a href="faq.htm">FAQ</a><br> .&nbsp;<a href="faq.htm">FAQ</a><br>
.&nbsp;<a href="index.htm">More</a></p> .&nbsp;<a href="index.htm">More</a></p>
@@ -76,11 +74,11 @@
<li><a href="#Additional_Steps">Additional Steps</a></li> <li><a href="#Additional_Steps">Additional Steps</a></li>
</ul> </ul>
<h2><a name="Introduction">Introduction</a></h2> <h2><a name="Introduction" id="Introduction">Introduction</a></h2>
<p>These instructions are intended to help you get started using the <p>These instructions are intended to help you get started using the Boost
Boost Libraries. This walks you through getting, building, and installing Libraries. This walks you through getting, building, and installing the
the libraries. To summarize these are the steps to get Boost built and libraries. To summarize these are the steps to get Boost built and
installed:</p> installed:</p>
<ol> <ol>
@@ -95,75 +93,71 @@
<li><a href="#step5">Build and install</a>.</li> <li><a href="#step5">Build and install</a>.</li>
</ol> </ol>
<h2><a name="Download"></a>Download</h2> <h2><a name="Download" id="Download"></a>Download</h2>
<table summary="" width="100%" border="0" cellspacing="2" cellpadding= <table summary="" width="100%" border="0" cellspacing="2" cellpadding="2">
"2">
<tr align="left" valign="top"> <tr align="left" valign="top">
<td width="40" align="center" valign="top" bgcolor="#FFFF66"><font <td width="40" align="center" valign="top" bgcolor="#FFFF66">
size="6"><b><a name="step1"></a>1</b></font></td> <font size="6"><b><a name="step1" id="step1"></a>1</b></font></td>
<td>The Boost Libraries are distributed through the SourceForge file <td>The Boost Libraries are distributed through the SourceForge file
distribution system. Click here to <b><a href= distribution system. Click here to <b><a href=
"http://sourceforge.net/project/showfiles.php?group_id=7586"><font "http://sourceforge.net/project/showfiles.php?group_id=7586"><font size="4">
size="4">download releases from SourceForge</font></a></b>. And download releases from SourceForge</font></a></b>. And unpack the
unpack the release to a convenient location.</td> release to a convenient location.</td>
</tr> </tr>
</table> </table>
<p>The Boost release includes all of the libraries and other material <p>The Boost release includes all of the libraries and other material from
from the web site. It is available in <a href="#.zip">ZIP</a>, <a href= the web site. It is available in <a href="#.zip">ZIP</a>, <a href=
"#.tar.gz">TAR.GZ</a>, and <a href="#.tar.gz">TAR.BZ2</a> formats. Past "#.tar.gz">TAR.GZ</a>, and <a href="#.tar.gz">TAR.BZ2</a> formats. Past
releases are also available.</p> releases are also available.</p>It is also possible to download current
It is also possible to download current snapshots of work-in-progress snapshots of work-in-progress from Boost's <a href="#CVS">CVS
from Boost's <a href="#CVS">CVS repository</a>. repository</a>.
<h3><a name=".zip">.zip</a> file</h3> <h3><a name=".zip" id="zip">.zip</a> file</h3>The .zip format is widely
The .zip format is widely supported by both free decoders and commercial supported by both free decoders and commercial compress/archive utilities.
compress/archive utilities. If you don't already have a .zip file If you don't already have a .zip file decoder, download one from the
decoder, download one from the <a href= <a href="http://www.info-zip.org/">Info-ZIP</a> web site, which supplies
"http://www.info-zip.org/">Info-ZIP</a> web site, which supplies versions versions for many operating systems.
for many operating systems.
<p>Text file line endings in the .zip file are as supplied by each <p>Text file line endings in the .zip file are as supplied by each library
library developer.&nbsp; This works fine for Windows, but not for developer.&nbsp; This works fine for Windows, but not for Unix/Linux.&nbsp;
Unix/Linux.&nbsp; The .tar.gz and .tar.bz2 files supply Unix/Linux The .tar.gz and .tar.bz2 files supply Unix/Linux friendly line endings.</p>
friendly line endings.</p>
<h3><a name=".tar.gz">.tar.gz</a> and .tar.bz2 files</h3> <h3><a name=".tar.gz" id="tar_gz">.tar.gz</a> and .tar.bz2 files</h3>
<p>The .tar.gz format is widely supported on Unix/Linux platforms. Some <p>The .tar.gz format is widely supported on Unix/Linux platforms. Some
Windows compress/archive utilities can read the format as well.&nbsp; Windows compress/archive utilities can read the format as well.&nbsp;
Because the gzip format compresses the archive as a single file rather Because the gzip format compresses the archive as a single file rather than
than compressing each file individually, the .tar.gz file is smaller that compressing each file individually, the .tar.gz file is smaller that the
the .zip file.</p> .zip file.</p>
<p>The .tar.bz2 format is becoming widely available on Unix/Linux <p>The .tar.bz2 format is becoming widely available on Unix/Linux platforms
platforms and is built into many tar utilities. This format differs for and is built into many tar utilities. This format differs for the .tar.gz
the .tar.gz format in the compression used, which is considerably better format in the compression used, which is considerably better and therefore
and therefore creates smaller files.</p> creates smaller files.</p>
<p>Text file line endings in the .tar.gz and .tar.bz2 files have been <p>Text file line endings in the .tar.gz and .tar.bz2 files have been
converted to newlines for ease of use on Unix/Linux platforms.</p> converted to newlines for ease of use on Unix/Linux platforms.</p>
<h3>Boost <a name="CVS">CVS</a> Repository</h3> <h3>Boost <a name="CVS" id="CVS">CVS</a> Repository</h3>
<p>All Boost files, including the entire distribution tree including web <p>All Boost files, including the entire distribution tree including web
site HTML is maintained in a CVS repository. Command line, GUI, or site HTML is maintained in a CVS repository. Command line, GUI, or browser
browser access is available.</p> access is available.</p>
<h4>Boost CVS access via command line or graphical clients</h4> <h4>Boost CVS access via command line or graphical clients</h4>For those
For those who have CVS clients installed, the libraries are also who have CVS clients installed, the libraries are also available from the
available from the public <a href= public <a href="http://sourceforge.net/cvs/?group_id=7586">Boost CVS
"http://sourceforge.net/cvs/?group_id=7586">Boost CVS repository</a>. repository</a>. Free command line clients (often already installed on
Free command line clients (often already installed on Linux/Unix systems) Linux/Unix systems) are available for many systems, and free GUI clients
are available for many systems, and free GUI clients are available for are available for Windows, Mac, and other systems.
Windows, Mac, and other systems.
<p>See the much improved <a href= <p>See the much improved <a href=
"http://sourceforge.net/docman/?group_id=1">CVS documentation</a> "http://sourceforge.net/docman/?group_id=1">CVS documentation</a> (Section
(Section F) from SourceForge, which includes links to the home pages for F) from SourceForge, which includes links to the home pages for various GUI
various GUI and command line clients.</p> and command line clients.</p>
<p>The general procedure for command-line clients is something like <p>The general procedure for command-line clients is something like
this:</p> this:</p>
@@ -176,64 +170,61 @@
checkout boost</code><br> checkout boost</code><br>
<code>cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/boost <code>cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/boost
logout</code> logout</code>
</blockquote> </blockquote>Read the manual for your CVS client for further information.
Read the manual for your CVS client for further information.
<p>This access is read-only; if you are a library author and wish to have <p>This access is read-only; if you are a library author and wish to have
CVS write access, please contact one of the <a href= CVS write access, please contact one of the <a href=
"moderators.html">moderators</a>.</p> "moderators.html">moderators</a>.</p>
<h4>Boost CVS access via web <a name="Browser">Browser</a></h4> <h4>Boost CVS access via web <a name="Browser" id=
For access to the CVS archive from any modern web browser, you can also "Browser">Browser</a></h4>For access to the CVS archive from any modern web
use the <a href= browser, you can also use the <a href=
"http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/boost/boost/">web "http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/boost/boost/">web
browser&nbsp; interface</a>.&nbsp; Try one of the color diffs to see how browser&nbsp; interface</a>.&nbsp; Try one of the color diffs to see how a
a file has changed over time. <b>Note:</b> this interface is only file has changed over time. <b>Note:</b> this interface is only suitable
suitable for viewing individual files and their revision histories. If for viewing individual files and their revision histories. If you need an
you need an image of the whole CVS tree, <a href= image of the whole CVS tree, <a href=
"http://www.boost-consulting.com">Boost Consulting</a> provides an hourly "http://www.boost-consulting.com">Boost Consulting</a> provides an hourly
<a href="http://www.boost-consulting.com/boost.tar.bz2">snapshot in <a href="http://www.boost-consulting.com/boost.tar.bz2">snapshot in
.tar.bz2 format</a>. .tar.bz2 format</a>.
<h4><a name="generated">Documentation</a> generated from BoostBook in <h4><a name="generated" id="generated">Documentation</a> generated from
CVS</h4> BoostBook in CVS</h4>
<p>Some of the Boost documentation is generated from <a href= <p>Some of the Boost documentation is generated from <a href=
"../doc/html/boostbook.html">BoostBook XML</a> source stored in the CVS "../doc/html/boostbook.html">BoostBook XML</a> source stored in the CVS
repository, and will not appear directly in the CVS tree as readable repository, and will not appear directly in the CVS tree as readable HTML.
HTML. View a nightly build of the generated HTML on the <a href= View a nightly build of the generated HTML on the <a href=
"http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/libraries.html"> "http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/libraries.html">
Nightly Generated Documentation</a> page. Where generated HTML is missing Nightly Generated Documentation</a> page. Where generated HTML is missing
from the CVS tree, an attempt has been made to include redirection to from the CVS tree, an attempt has been made to include redirection to this
this nightly build, but if you are away from an internet connection you nightly build, but if you are away from an internet connection you may want
may want to download the generated documentation archive from the to download the generated documentation archive from the aforementioned
aforementioned page so you can browse those documents offline.</p> page so you can browse those documents offline.</p>
<h2><a name="Preparation"></a>Preparation</h2> <h2><a name="Preparation" id="Preparation"></a>Preparation</h2>
<p>The recommended way to build and install the Boost Libraries is to use <p>The recommended way to build and install the Boost Libraries is to use
<a href="../tools/build/v1/build_system.htm">Boost.Build</a>, the Boost <a href="../tools/build/v1/build_system.htm">Boost.Build</a>, the Boost
Build system. The rest of these instructions explain that use, but it is Build system. The rest of these instructions explain that use, but it is up
up to you to use this method, or not. Note that some of the libraries to you to use this method, or not. Note that some of the libraries also
also include non Boost.Build makefiles and/or project files. But all include non Boost.Build makefiles and/or project files. But all include the
include the needed files for building with Boost.Build.</p> needed files for building with Boost.Build.</p>
<table summary="" width="100%" border="0" cellspacing="2" cellpadding= <table summary="" width="100%" border="0" cellspacing="2" cellpadding="2">
"2">
<tr align="left" valign="top"> <tr align="left" valign="top">
<td width="40" align="center" valign="top" bgcolor="#FFFF66"><font <td width="40" align="center" valign="top" bgcolor="#FFFF66">
size="6"><b><a name="step2"></a>2</b></font></td> <font size="6"><b><a name="step2" id="step2"></a>2</b></font></td>
<td>The build system uses <a href= <td>The build system uses <a href=
"../tools/build/jam_src/index.html">Boost.Jam</a>, an extension of "../tools/build/jam_src/index.html">Boost.Jam</a>, an extension of the
the <a href="http://www.perforce.com/jam/jam.html">Perforce Jam</a> <a href="http://www.perforce.com/jam/jam.html">Perforce Jam</a>
portable <i>make</i> replacement. The recommended way to get portable <i>make</i> replacement. The recommended way to get Boost.Jam
Boost.Jam if you are using a Boost distribution is to <strong><a if you are using a Boost distribution is to <strong><a href=
href= "http://sourceforge.net/project/showfiles.php?group_id=7586&amp;package_id=72941">
"http://sourceforge.net/project/showfiles.php?group_id=7586&package_id=72941"> download a prebuilt executable</a></strong> from SourceForge. If a
download a prebuilt executable</a></strong> from SourceForge. If a prebuilt prebuilt executable is not provided for your platform or you are using
executable is not provided for your platform or you Boost's sources in an unreleased state, it may be neccessary to
are using Boost's sources in an unreleased state, it may be neccessary to
<a href="../tools/build/jam_src/index.html#building_bjam">build <a href="../tools/build/jam_src/index.html#building_bjam">build
<tt>bjam</tt> from sources</a> included in the Boost source tree. To <tt>bjam</tt> from sources</a> included in the Boost source tree. To
install Boost.Jam, copy the <tt>bjam</tt> executable to a location install Boost.Jam, copy the <tt>bjam</tt> executable to a location
@@ -241,56 +232,50 @@
</tr> </tr>
</table> </table>
<h3><a name="Configuring">Configuring the tools</a></h3> <h3><a name="Configuring" id="Configuring">Configuring the tools</a></h3>
<p>Before using Boost.Build you will need to configure the compiler tools <p>Before using Boost.Build you will need to configure the compiler tools
you are using. The build system's toolsets are designed to work in either you are using. The build system's toolsets are designed to work in either
of two ways:</p> of two ways:</p>
<ol> <ol>
<li>The user sets up all of the environment for each toolset he wants <li>The user sets up all of the environment for each toolset he wants to
to use in the normal way. For example, for Microsoft VC++, ...VC98/Bin use in the normal way. For example, for Microsoft VC++, ...VC98/Bin or
or .../VC7/Bin is in the PATH environment variable, VCVARS32.BAT or .../VC7/Bin is in the PATH environment variable, VCVARS32.BAT or
VSVARS32.BAT has been invoked, etc. For Metrowerks CodeWarrior, VSVARS32.BAT has been invoked, etc. For Metrowerks CodeWarrior, cwenv.bat
cwenv.bat or equivalent has been called and ...Other Metrowerks or equivalent has been called and ...Other Metrowerks Tools/Command Line
Tools/Command Line Tools is in the path. Many Unix operating systems Tools is in the path. Many Unix operating systems come preconfigured this
come preconfigured this way and require no user intervention.<br> way and require no user intervention.<br>
<br> <br></li>
</li>
<li>The user doesn't want his environment cluttered with settings or <li>The user doesn't want his environment cluttered with settings or has
has nonstandard installations for some of his tools. Instead, he or she nonstandard installations for some of his tools. Instead, he or she sets
sets variables which point to the toolset installation directories, variables which point to the toolset installation directories, either in
either in the command shell environment or on the <code>bjam</code> the command shell environment or on the <code>bjam</code> command-line.
command-line. These variables are used by the build system to locate These variables are used by the build system to locate the tools and
the tools and invoke the necessary setup. To set the variables on the invoke the necessary setup. To set the variables on the <tt>bjam</tt>
<tt>bjam</tt> command-line you use the "<tt>-s</tt>" option. For command-line you use the "<tt>-s</tt>" option. For example:<br>
example:<br>
<br> <br>
<tt>bjam "-sGCC_ROOT_DIRECTORY=/usr/local/gcc-3.3.2"</tt><br> <tt>bjam "-sGCC_ROOT_DIRECTORY=/usr/local/gcc-3.3.2"</tt><br>
<br> <br>
Some variables, like the toolset <tt>TOOLS</tt> variable, can accept Some variables, like the toolset <tt>TOOLS</tt> variable, can accept
multiple values separated by spaces. Others, like the path above, can multiple values separated by spaces. Others, like the path above, can
contain spaces. For such circumstances you should use quotes contain spaces. For such circumstances you should use quotes appropriate
appropriate for your command interpreter.<br> for your command interpreter.<br></li>
</li>
</ol> </ol>
<h3><a name="Tools">Supported Toolsets</a></h3> <h3><a name="Tools" id="Tools">Supported Toolsets</a></h3>
<table summary="" width="100%" border="0" cellspacing="2" cellpadding= <table summary="" width="100%" border="0" cellspacing="2" cellpadding="2">
"2">
<tr align="left" valign="top"> <tr align="left" valign="top">
<td width="40" align="center" valign="top" bgcolor="#FFFF66"><font <td width="40" align="center" valign="top" bgcolor="#FFFF66">
size="6"><b><a name="step3"></a>3</b></font></td> <font size="6"><b><a name="step3" id="step3"></a>3</b></font></td>
<td>The following toolsets are supported by Boost.Build. For <td>The following toolsets are supported by Boost.Build. For
information about <a href="#Configuring">configuring</a> each information about <a href="#Configuring">configuring</a> each toolset,
toolset, click its name in the leftmost column.</td> click its name in the leftmost column.</td>
</tr> </tr>
</table> </table><br>
<br>
<table summary="" border="1" cellpadding="5"> <table summary="" border="1" cellpadding="5">
<tr> <tr>
@@ -304,8 +289,7 @@
"../tools/build/v1/borland-tools.html"><code>borland</code></a></td> "../tools/build/v1/borland-tools.html"><code>borland</code></a></td>
<td><a href= <td><a href=
"http://www.borland.com/bcppbuilder/freecompiler">Borland</a> "http://www.borland.com/bcppbuilder/freecompiler">Borland</a> C++</td>
C++</td>
</tr> </tr>
<tr> <tr>
@@ -322,16 +306,14 @@
<td><a href="http://www.comeaucomputing.com">Comeau C++</a> compiler <td><a href="http://www.comeaucomputing.com">Comeau C++</a> compiler
front-end for Windows, using Microsoft <a href= front-end for Windows, using Microsoft <a href=
"http://msdn.microsoft.com/visualc/">Visual C++</a>as a "http://msdn.microsoft.com/visualc/">Visual C++</a>as a back-end.</td>
back-end.</td>
</tr> </tr>
<tr> <tr>
<td><a href= <td><a href="../tools/build/v1/cw-tools.html"><code>cw</code></a></td>
"../tools/build/v1/cw-tools.html"><code>cw</code></a></td>
<td><a href="http://www.metrowerks.com">Metrowerks CodeWarrior</a> <td><a href="http://www.metrowerks.com">Metrowerks CodeWarrior</a> Pro
Pro 6.x, 7.x, 8.x, and 9.x command-line tools</td> 6.x, 7.x, 8.x, and 9.x command-line tools</td>
</tr> </tr>
<tr> <tr>
@@ -339,7 +321,23 @@
"../tools/build/v1/darwin-tools.html"><code>darwin</code></a></td> "../tools/build/v1/darwin-tools.html"><code>darwin</code></a></td>
<td>Apple Darwin OS hosted GNU <a href= <td>Apple Darwin OS hosted GNU <a href=
"http://developer.apple.com/tools/compilers.html">GCC</a>.</td> "http://developer.apple.com/tools/compilers.html">GCC</a></td>
</tr>
<tr>
<td><a href=
"../tools/build/v1/dmc-tools.html"><code>dmc</code></a></td>
<td><a href="http://www.digitalmars.com/">Digital Mars C++</a>.</td>
</tr>
<tr>
<td><a href=
"../tools/build/v1/dmc-stlport-tools.html"><code>dmc-stlport</code></a></td>
<td><a href="http://www.digitalmars.com/">Digital Mars C++</a>, using
the <a href="http://www.stlport.org">STLport</a> standard library
implementation</td>
</tr> </tr>
<tr> <tr>
@@ -381,8 +379,8 @@
"../tools/build/v1/intel-linux-tools.html"><code>intel-linux</code></a></td> "../tools/build/v1/intel-linux-tools.html"><code>intel-linux</code></a></td>
<td><a href= <td><a href=
"http://www.intel.com/software/products/compilers/c60l/">Intel C++ "http://www.intel.com/software/products/compilers/c60l/">Intel C++ for
for Linux</a></td> Linux</a></td>
</tr> </tr>
<tr> <tr>
@@ -391,10 +389,9 @@
<td><a href= <td><a href=
"http://www.intel.com/software/products/compilers/c60/">Intel C++ for "http://www.intel.com/software/products/compilers/c60/">Intel C++ for
Windows</a> using the Dinkumware standard library in the Windows</a> using the Dinkumware standard library in the Intel-required
Intel-required Microsoft <a href= Microsoft <a href="http://msdn.microsoft.com/visualc/">Visual C++</a> 6
"http://msdn.microsoft.com/visualc/">Visual C++</a> 6 or 7 or 7 installation</td>
installation</td>
</tr> </tr>
<tr> <tr>
@@ -422,6 +419,17 @@
redistributable objects)</td> redistributable objects)</td>
</tr> </tr>
<tr>
<td><a href=
"../tools/build/v1/mingw-stlport-tools.html"><code>mingw-stlport</code></a></td>
<td>GNU GCC and associated tools in <a href=
"http://www.mingw.org">MinGW</a> configuration (produces commercially
redistributable objects), using the <a href=
"http://www.stlport.org">STLport</a> standard library
implementation</td>
</tr>
<tr> <tr>
<td><a href= <td><a href=
"../tools/build/v1/mipspro-tools.html"><code>mipspro</code></a></td> "../tools/build/v1/mipspro-tools.html"><code>mipspro</code></a></td>
@@ -464,8 +472,8 @@
<td><a href= <td><a href=
"../tools/build/v1/tru64cxx-tools.html"><code>tru64cxx</code></a></td> "../tools/build/v1/tru64cxx-tools.html"><code>tru64cxx</code></a></td>
<td><a href="http://www.tru64unix.compaq.com/cplus/">Compaq C++</a> <td><a href="http://www.tru64unix.compaq.com/cplus/">Compaq C++</a> for
for Tru64 UNIX (versions prior to 6.5)</td> Tru64 UNIX (versions prior to 6.5)</td>
</tr> </tr>
<tr> <tr>
@@ -513,25 +521,23 @@
"../tools/build/v1/vc7.1-stlport-tools.html"><code>vc7.1-stlport</code></a></td> "../tools/build/v1/vc7.1-stlport-tools.html"><code>vc7.1-stlport</code></a></td>
<td>Microsoft <a href="http://msdn.microsoft.com/visualc/">Visual <td>Microsoft <a href="http://msdn.microsoft.com/visualc/">Visual
C++</a> command-line tools from Visual Studio .NET 2003 + C++</a> command-line tools from Visual Studio .NET 2003 + STLPort.</td>
STLPort.</td>
</tr> </tr>
</table> </table>
<h2><a name="Build_Install"></a>Build and Install</h2> <h2><a name="Build_Install" id="Build_Install"></a>Build and Install</h2>
<p>The common build and install process is driven by the top-level build <p>The common build and install process is driven by the top-level build
file (<a href="../Jamfile">Jamfile</a>).</p> file (<a href="../Jamfile">Jamfile</a>).</p>
<table summary="" width="100%" border="0" cellspacing="2" cellpadding= <table summary="" width="100%" border="0" cellspacing="2" cellpadding="2">
"2">
<tr align="left" valign="top"> <tr align="left" valign="top">
<td width="40" align="center" valign="top" bgcolor="#FFFF66"><font <td width="40" align="center" valign="top" bgcolor="#FFFF66">
size="6"><b><a name="step4"></a>4</b></font></td> <font size="6"><b><a name="step4" id="step4"></a>4</b></font></td>
<td> <td>
<p>First you need to change to the directory where you have the <p>First you need to change to the directory where you have the Boost
Boost distribution you downloaded. For example:</p> distribution you downloaded. For example:</p>
<blockquote> <blockquote>
<p><code>chdir&nbsp;boost-1.31.0</code></p> <p><code>chdir&nbsp;boost-1.31.0</code></p>
@@ -540,20 +546,18 @@
</tr> </tr>
</table> </table>
<p>The default build and install attempts to build all available <p>The default build and install attempts to build all available libraries
libraries and install to default locations the libraries and Boost header and install to default locations the libraries and Boost header files. On
files. On Unix systems the default install location is Unix systems the default install location is "<tt>/usr/local</tt>", and on
"<tt>/usr/local</tt>", and on Windows systems the default is Windows systems the default is "<tt>C:\Boost</tt>". Within those
"<tt>C:\Boost</tt>". Within those directories libraries are installed to directories libraries are installed to the "<tt>lib</tt>" subdirectory, and
the "<tt>lib</tt>" subdirectory, and headers to an headers to an "<tt>include/boost-1_31</tt>" subdirectory, the version will
"<tt>include/boost-1_31</tt>" subdirectory, the version will reflect the reflect the distribution you are installing.</p>
distribution you are installing.</p>
<table summary="" width="100%" border="0" cellspacing="2" cellpadding= <table summary="" width="100%" border="0" cellspacing="2" cellpadding="2">
"2">
<tr align="left" valign="top"> <tr align="left" valign="top">
<td width="40" align="center" valign="top" bgcolor="#FFFF66"><font <td width="40" align="center" valign="top" bgcolor="#FFFF66">
size="6"><b><a name="step5"></a>5</b></font></td> <font size="6"><b><a name="step5" id="step5"></a>5</b></font></td>
<td> <td>
Invoke the build system, specifying the <a href= Invoke the build system, specifying the <a href=
@@ -564,8 +568,8 @@
<p><code>bjam&nbsp;"-sTOOLS=gcc" install</code></p> <p><code>bjam&nbsp;"-sTOOLS=gcc" install</code></p>
</blockquote> </blockquote>
<p>Or if you are interested only in the built libraries you can <p>Or if you are interested only in the built libraries you can have
have them built and collected to a common directory without them built and collected to a common directory without
installation.</p> installation.</p>
<blockquote> <blockquote>
@@ -575,11 +579,11 @@
</tr> </tr>
</table> </table>
<p>The build and install system can be controlled through a set of <p>The build and install system can be controlled through a set of options
options similar in style to GNU configure options. The options allow you similar in style to GNU configure options. The options allow you to, among
to, among other things, change the install location, disable building of other things, change the install location, disable building of libraries,
libraries, etc. You can see a summary of the available options by etc. You can see a summary of the available options by invoking "<tt>bjam
invoking "<tt>bjam --help</tt>". The full invocation takes the form:</p> --help</tt>". The full invocation takes the form:</p>
<blockquote> <blockquote>
<p><code>bjam&nbsp;[<i>options</i>...] [install|stage]</code></p> <p><code>bjam&nbsp;[<i>options</i>...] [install|stage]</code></p>
@@ -596,9 +600,8 @@
<td nowrap align="left" valign="top"><i>none</i></td> <td nowrap align="left" valign="top"><i>none</i></td>
<td align="left" valign="top">Only builds the Boost libraries. This <td align="left" valign="top">Only builds the Boost libraries. This
lets you do the first part of what the <tt>install</tt> action lets you do the first part of what the <tt>install</tt> action normally
normally does without copying the built libraries to the install does without copying the built libraries to the install location.</td>
location.</td>
</tr> </tr>
<tr> <tr>
@@ -624,8 +627,8 @@
<tr> <tr>
<td nowrap align="left" valign="top"><tt>--help</tt></td> <td nowrap align="left" valign="top"><tt>--help</tt></td>
<td align="left" valign="top">Shows a short summary of the options <td align="left" valign="top">Shows a short summary of the options and
and syntax of the command.</td> syntax of the command.</td>
</tr> </tr>
<tr> <tr>
@@ -674,8 +677,8 @@
<td nowrap align="left" valign="top"><tt>--builddir=DIR</tt></td> <td nowrap align="left" valign="top"><tt>--builddir=DIR</tt></td>
<td align="left" valign="top">Build in this location instead of <td align="left" valign="top">Build in this location instead of
building within the distribution tree. This moves where the sources building within the distribution tree. This moves where the sources for
for the libraries are compiled to before they are installed. the libraries are compiled to before they are installed.
Recommended!</td> Recommended!</td>
</tr> </tr>
@@ -699,10 +702,9 @@
<td nowrap align="left" valign="top"> <td nowrap align="left" valign="top">
<tt>--with-&lt;<i>library</i>&gt;</tt></td> <tt>--with-&lt;<i>library</i>&gt;</tt></td>
<td align="left" valign="top">Build, stage, or install the <td align="left" valign="top">Build, stage, or install the specified
specified library. This changes the default from trying to library. This changes the default from trying to build all possible
build all possible libraries, to only building the speicfied libraries, to only building the speicfied libraries.</td>
libraries.</td>
</tr> </tr>
<tr> <tr>
@@ -710,9 +712,9 @@
<tt>--with-python-root[=PYTHON_ROOT]</tt></td> <tt>--with-python-root[=PYTHON_ROOT]</tt></td>
<td align="left" valign="top">Build Boost.Python libraries with the <td align="left" valign="top">Build Boost.Python libraries with the
Python devel packages located at <tt>PYTHON_ROOT</tt>. The Python devel packages located at <tt>PYTHON_ROOT</tt>. The Boost.Python
Boost.Python libraries are built only if the build can find the libraries are built only if the build can find the Python development
Python development package at this location.<br> package at this location.<br>
Default; <tt>C:\tools\python</tt> on Win32.<br> Default; <tt>C:\tools\python</tt> on Win32.<br>
Default; <tt>/usr/local</tt> on Unix, Linux, etc.<br> Default; <tt>/usr/local</tt> on Unix, Linux, etc.<br>
Default; <tt>/usr</tt> on Cygwin.</td> Default; <tt>/usr</tt> on Cygwin.</td>
@@ -734,13 +736,13 @@
options perhaps the most imporant is "<tt>-s<a href= options perhaps the most imporant is "<tt>-s<a href=
"../tools/build/v1/build_system.htm#build">BUILD</a>=&lt;features/variants&gt;</tt>" "../tools/build/v1/build_system.htm#build">BUILD</a>=&lt;features/variants&gt;</tt>"
which lets you override what is built by default. The which lets you override what is built by default. The
"<tt>&lt;features/variants&gt;</tt>" value is a list, separated by "<tt>&lt;features/variants&gt;</tt>" value is a list, separated by spaces,
spaces, of build requests. Features take the form of a tag and a value or of build requests. Features take the form of a tag and a value or values.
values. And variants are single symbolic names for a collection of And variants are single symbolic names for a collection of features. For
features. For example the default is to request "<tt>debug release example the default is to request "<tt>debug release
&lt;runtime-link&gt;static/dynamic &lt;threading&gt;single/multi</tt>", &lt;runtime-link&gt;static/dynamic &lt;threading&gt;single/multi</tt>", in
in which "<tt>debug</tt>" and "<tt>release</tt>" are variants, and the which "<tt>debug</tt>" and "<tt>release</tt>" are variants, and the rest
rest features with two values each.</p> features with two values each.</p>
<p>If you have some feedback about the build and install process please <p>If you have some feedback about the build and install process please
drop us a line at the <a href="mailing_lists.htm#jamboost">Boost.Build drop us a line at the <a href="mailing_lists.htm#jamboost">Boost.Build
@@ -748,14 +750,14 @@
platform and if it there is anything that you feel could be done platform and if it there is anything that you feel could be done
better.</p> better.</p>
<h2><a name="Results"></a>Results</h2> <h2><a name="Results" id="Results"></a>Results</h2>
<p>The results of building come in to forms: static libraries, and <p>The results of building come in to forms: static libraries, and dynamic
dynamic libraries. Depending on the platform the libraries produced have libraries. Depending on the platform the libraries produced have different
different names to accommodate the platform requirements. For a single names to accommodate the platform requirements. For a single Boost library
Boost library the build with the default will produce eight different the build with the default will produce eight different libraries. For
libraries. For example building the Boost.Datetime library on Unix type example building the Boost.Datetime library on Unix type system it would
system it would produce:</p> produce:</p>
<ol> <ol>
<li><tt>libboost_date_time-gcc-d-1_31.so</tt></li> <li><tt>libboost_date_time-gcc-d-1_31.so</tt></li>
@@ -772,16 +774,14 @@
<li><tt>libboost_date_time-gcc-1_31.a</tt></li> <li><tt>libboost_date_time-gcc-1_31.a</tt></li>
<li><tt>libboost_date_time-gcc-mt-1_31.a</tt><br> <li><tt>libboost_date_time-gcc-mt-1_31.a</tt><br></li>
</li>
</ol> </ol>
<table summary="" border="0" cellspacing="0" cellpadding="0" width= <table summary="" border="0" cellspacing="0" cellpadding="0" width="100%">
"100%">
<tr> <tr>
<td colspan="11"> <td colspan="11">
<table summary="" border="0" cellspacing="2" cellpadding="2" <table summary="" border="0" cellspacing="2" cellpadding="2" bgcolor=
bgcolor="#CCCCCC"> "#CCCCCC">
<tr> <tr>
<th>&middot; Library Prefix</th> <th>&middot; Library Prefix</th>
</tr> </tr>
@@ -809,8 +809,8 @@
"+1">boost_date_time</font></tt></td> "+1">boost_date_time</font></tt></td>
<td colspan="10"> <td colspan="10">
<table summary="" border="0" cellspacing="2" cellpadding="2" <table summary="" border="0" cellspacing="2" cellpadding="2" bgcolor=
bgcolor="#CCCCCC"> "#CCCCCC">
<tr> <tr>
<th>&middot; Toolset</th> <th>&middot; Toolset</th>
</tr> </tr>
@@ -835,15 +835,13 @@
</tr> </tr>
<tr> <tr>
<td rowspan="4" valign="bottom"><tt><font size= <td rowspan="4" valign="bottom"><tt><font size="+1">-</font></tt></td>
"+1">-</font></tt></td>
<td rowspan="4" valign="bottom"><tt><font size= <td rowspan="4" valign="bottom"><tt><font size="+1">mt</font></tt></td>
"+1">mt</font></tt></td>
<td colspan="6"> <td colspan="6">
<table summary="" border="0" cellspacing="2" cellpadding="2" <table summary="" border="0" cellspacing="2" cellpadding="2" bgcolor=
bgcolor="#CCCCCC"> "#CCCCCC">
<tr> <tr>
<th>&middot; Runtime</th> <th>&middot; Runtime</th>
</tr> </tr>
@@ -868,15 +866,14 @@
</tr> </tr>
<tr> <tr>
<td rowspan="2" valign="bottom"><tt><font size= <td rowspan="2" valign="bottom"><tt><font size="+1">-</font></tt></td>
"+1">-</font></tt></td>
<td rowspan="2" valign="bottom"><tt><font size= <td rowspan="2" valign="bottom"><tt><font size=
"+1">1_31</font></tt></td> "+1">1_31</font></tt></td>
<td colspan="2"> <td colspan="2">
<table summary="" border="0" cellspacing="2" cellpadding="2" <table summary="" border="0" cellspacing="2" cellpadding="2" bgcolor=
bgcolor="#CCCCCC"> "#CCCCCC">
<tr> <tr>
<th>&middot; Library Type</th> <th>&middot; Library Type</th>
</tr> </tr>
@@ -897,8 +894,8 @@
<p>The "lib" prefix on the libraries is a requirement on many platforms, <p>The "lib" prefix on the libraries is a requirement on many platforms,
like Unix, and on others like GCC running on Windows. The prefix is like Unix, and on others like GCC running on Windows. The prefix is
therefore added to all libraries on Unix type systems, and to static therefore added to all libraries on Unix type systems, and to static
libraries on Windows. That is on Unix shared libraries and static libraries on Windows. That is on Unix shared libraries and static libraries
libraries (object archives) are named respectively:</p> (object archives) are named respectively:</p>
<ul> <ul>
<li><tt>lib*.so</tt></li> <li><tt>lib*.so</tt></li>
@@ -906,8 +903,8 @@
<li><tt>lib*.a</tt></li> <li><tt>lib*.a</tt></li>
</ul> </ul>
<p>On Windows shared libraries do not have the prefix to differentiate <p>On Windows shared libraries do not have the prefix to differentiate the
the import libraries from static libraries. Consequently on Windows the import libraries from static libraries. Consequently on Windows the
libraries are named:</p> libraries are named:</p>
<ul> <ul>
@@ -926,11 +923,11 @@
<h3>Toolset</h3> <h3>Toolset</h3>
<p>The toolset name is an abbreviation based on the compiler you are <p>The toolset name is an abbreviation based on the compiler you are
building with. The abbreviation is composed of a short, 2 to 4 building with. The abbreviation is composed of a short, 2 to 4 characters,
characters, tag for the compiler and a version number of the compiler's tag for the compiler and a version number of the compiler's major and minor
major and minor revision (if available). For example if your toolset is revision (if available). For example if your toolset is
"<tt>gcc-3.2.3</tt>" the toolset tag would be "<tt>gcc32</tt>". The "<tt>gcc-3.2.3</tt>" the toolset tag would be "<tt>gcc32</tt>". The toolset
toolset abbreviations used are as follows:</p> abbreviations used are as follows:</p>
<table border="1" cellpadding="5" summary=""> <table border="1" cellpadding="5" summary="">
<tr> <tr>
@@ -961,17 +958,9 @@
</tr> </tr>
<tr> <tr>
<td><a href= <td><a href="../tools/build/v1/cw-tools.html"><code>cw</code></a></td>
"../tools/build/v1/cwpro8-tools.html"><code>cwpro8</code></a></td>
<td><tt>cw8</tt></td> <td><tt>cw</tt></td>
</tr>
<tr>
<td><code><a href="../tools/build/v1/cwpro9-tools.html">cwpro</a><a
href="../tools/build/v1/cwpro8-tools.html">9</a></code></td>
<td><tt><code>cw</code></tt><code>9</code></td>
</tr> </tr>
<tr> <tr>
@@ -981,6 +970,20 @@
<td><tt>osx</tt></td> <td><tt>osx</tt></td>
</tr> </tr>
<tr>
<td><a href=
"../tools/build/v1/dmc-tools.html"><code>dmc</code></a></td>
<td><tt>dmc</tt></td>
</tr>
<tr>
<td><a href=
"../tools/build/v1/dmc-stlport-tools.html"><code>dmc-stlport</code></a></td>
<td><tt>dmc</tt></td>
</tr>
<tr> <tr>
<td><a href= <td><a href=
"../tools/build/v1/edg-tools.html"><code>edg</code></a></td> "../tools/build/v1/edg-tools.html"><code>edg</code></a></td>
@@ -1039,14 +1042,14 @@
<tr> <tr>
<td><a href= <td><a href=
"../tools/build/v1/metrowerks-tools.html"><code>metrowerks</code></a></td> "../tools/build/v1/mingw-tools.html"><code>mingw</code></a></td>
<td><tt>cw</tt></td> <td><tt>mgw</tt></td>
</tr> </tr>
<tr> <tr>
<td><a href= <td><a href=
"../tools/build/v1/mingw-tools.html"><code>mingw</code></a></td> "../tools/build/v1/mingw-stlport-tools.html"><code>mingw-stlport</code></a></td>
<td><tt>mgw</tt></td> <td><tt>mgw</tt></td>
</tr> </tr>
@@ -1107,6 +1110,13 @@
<td><tt>vc</tt></td> <td><tt>vc</tt></td>
</tr> </tr>
<tr>
<td><a href=
"../tools/build/v1/vc7-stlport-tools.html"><code>vc7-stlport</code></a></td>
<td><tt>vc</tt></td>
</tr>
<tr> <tr>
<td><a href= <td><a href=
"../tools/build/v1/vc7.1-tools.html"><code>vc7.1</code></a></td> "../tools/build/v1/vc7.1-tools.html"><code>vc7.1</code></a></td>
@@ -1114,6 +1124,13 @@
<td><tt>vc</tt></td> <td><tt>vc</tt></td>
</tr> </tr>
<tr>
<td><a href=
"../tools/build/v1/vc7.1-stlport-tools.html"><code>vc7.1-stlport</code></a></td>
<td><tt>vc</tt></td>
</tr>
<tr> <tr>
<td>Others</td> <td>Others</td>
@@ -1123,16 +1140,16 @@
<h3>Threading</h3> <h3>Threading</h3>
<p>This tag indicates if the library is compiled with threading support. <p>This tag indicates if the library is compiled with threading support. If
If threading is enabled "<tt>-mt</tt>" is added, otherwise nothing is threading is enabled "<tt>-mt</tt>" is added, otherwise nothing is
added.</p> added.</p>
<h3>Runtime</h3> <h3>Runtime</h3>
<p>This specifies the type of runtime the library was compiled against, <p>This specifies the type of runtime the library was compiled against, and
and the type of code that is compiled. More commonly this encodes the ABI the type of code that is compiled. More commonly this encodes the ABI
variation used in the code. For each feature of the runtime system and variation used in the code. For each feature of the runtime system and code
code compilation option a single letter is added to this tag.</p> compilation option a single letter is added to this tag.</p>
<table border="1" cellpadding="5" summary=""> <table border="1" cellpadding="5" summary="">
<tr> <tr>
@@ -1187,52 +1204,50 @@
<p>This is the short label for the version of the Boost Libraries. The <p>This is the short label for the version of the Boost Libraries. The
major and minor version numbers are taken together separated by an major and minor version numbers are taken together separated by an
underscore. For example version 1.31.0 would be tagged as underscore. For example version 1.31.0 would be tagged as "<tt>-1_31</tt>".
"<tt>-1_31</tt>". The patch version number is not included because it is The patch version number is not included because it is assumed that patch
assumed that patch versions are upward compatible.</p> versions are upward compatible.</p>
<h3>Library Type</h3> <h3>Library Type</h3>
<p>The extension holds the type of library. This follows the platform <p>The extension holds the type of library. This follows the platform
requirements. On Windows this is "<tt>.dll</tt>" for shared libraries, requirements. On Windows this is "<tt>.dll</tt>" for shared libraries, and
and "<tt>.lib</tt>" for static libraries including import libraries. On "<tt>.lib</tt>" for static libraries including import libraries. On Unix
Unix this is ".a" for static libraries (archives), and ".so" for shared this is ".a" for static libraries (archives), and ".so" for shared
libraries. For toolsets that support it in Unix they will also have a libraries. For toolsets that support it in Unix they will also have a full
full version extension (for example "<tt>.so.1.31.0</tt>") with a version extension (for example "<tt>.so.1.31.0</tt>") with a symbolic link
symbolic link for the un-versioned library.</p> for the un-versioned library.</p>
<h2><a name="Additional_Steps"></a>Additional Steps</h2> <h2><a name="Additional_Steps" id="Additional_Steps"></a>Additional
Steps</h2>
<p>Depending on your platform and configuration you may need to perform <p>Depending on your platform and configuration you may need to perform
some additional configuration to get Boost to build and install.</p> some additional configuration to get Boost to build and install.</p>
<ul> <ul>
<li><a href="../libs/config/config.htm#configuring">Configure the boost <li><a href="../libs/config/config.htm#configuring">Configure the boost
source code</a>. This step should not be required on the vast majority source code</a>. This step should not be required on the vast majority of
of platforms, but if you're trying to build Boost on an untested or platforms, but if you're trying to build Boost on an untested or
unsupported platform it may be necessary.<br> unsupported platform it may be necessary.<br>
<br> <br></li>
</li>
<li>If Boost.Build has problems detecting your Python installation it <li>If Boost.Build has problems detecting your Python installation it
will print a short messages about how to configure for finding the will print a short messages about how to configure for finding the Python
Python installation. For more information, see these detailed <a href= installation. For more information, see these detailed <a href=
"../libs/python/doc/building.html#building">instructions</a>.</li> "../libs/python/doc/building.html#building">instructions</a>.</li>
</ul> </ul>
<hr> <hr>
<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" <p>Revised <!--webbot bot="Timestamp" s-type="EDITED"
s-format="%d %B, %Y" startspan -->11 s-format="%d %B, %Y" startspan -->3
July, 2004 October, 2004 <!--webbot bot="Timestamp" endspan i-checksum="38706" --></p>
<!--webbot bot="Timestamp" endspan i-checksum="38706" --></p>
<p>Copyright &copy; Rene Rivera 2003.<br> <p>Copyright &copy; Rene Rivera 2003.<br>
Copyright &copy; Jens Maurer 2001.</p> Copyright &copy; Jens Maurer 2001.</p>
<p><small>Use, modification, and distribution are subject to the Boost <p><small>Distributed under the Boost Software License, Version 1.0. (See
Software License, Version 1.0. (See accompanying file <a href= accompanying file <a href="../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or copy
"../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or copy at <a href= at <a href=
"http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a>)</small></p> "http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</a>)</small></p>
</body> </body>
</html> </html>