diff options
Diffstat (limited to 'doc/html/jam.html')
-rw-r--r-- | doc/html/jam.html | 924 |
1 files changed, 0 insertions, 924 deletions
diff --git a/doc/html/jam.html b/doc/html/jam.html deleted file mode 100644 index b82b01feb5..0000000000 --- a/doc/html/jam.html +++ /dev/null @@ -1,924 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> -<title>Chapter 50. Boost.Jam : 3.1.19</title> -<link rel="stylesheet" href="../../doc/src/boostbook.css" type="text/css"> -<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> -<link rel="home" href="index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> -<link rel="up" href="tools.html" title="Part II. Boost Tools"> -<link rel="prev" href="examples.html" title="Examples"> -<link rel="next" href="jam/language.html" title="Language"> -</head> -<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> -<table cellpadding="2" width="100%"><tr> -<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../boost.png"></td> -<td align="center"><a href="../../index.html">Home</a></td> -<td align="center"><a href="../../libs/libraries.htm">Libraries</a></td> -<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> -<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> -<td align="center"><a href="../../more/index.htm">More</a></td> -</tr></table> -<hr> -<div class="spirit-nav"> -<a accesskey="p" href="examples.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="tools.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="jam/language.html"><img src="../../doc/src/images/next.png" alt="Next"></a> -</div> -<div class="chapter"> -<div class="titlepage"><div> -<div><h2 class="title"> -<a name="jam"></a>Chapter 50. Boost.Jam : 3.1.19</h2></div> -<div><div class="authorgroup"> -<div class="author"><h3 class="author"> -<span class="firstname">Rene</span> <span class="surname">Rivera</span> -</h3></div> -<div class="author"><h3 class="author"> -<span class="firstname">David</span> <span class="surname">Abrahams</span> -</h3></div> -<div class="author"><h3 class="author"> -<span class="firstname">Vladimir</span> <span class="surname">Prus</span> -</h3></div> -</div></div> -<div><p class="copyright">Copyright © 2003-2007 Rene Rivera, David Abrahams, Vladimir Prus</p></div> -<div><div class="legalnotice"> -<a name="jam.legal"></a><p> - Distributed under the Boost Software License, Version 1.0. (See accompanying - file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) - </p> -</div></div> -</div></div> -<div class="toc"> -<p><b>Table of Contents</b></p> -<dl class="toc"> -<dt><span class="section"><a href="jam.html#jam.building">Building B2</a></span></dt> -<dt><span class="section"><a href="jam/language.html">Language</a></span></dt> -<dd><dl> -<dt><span class="section"><a href="jam/language.html#jam.language.lexical">Lexical Features</a></span></dt> -<dt><span class="section"><a href="jam/language.html#jam.language.target">Targets</a></span></dt> -<dt><span class="section"><a href="jam/language.html#jam.language.rules">Rules</a></span></dt> -<dt><span class="section"><a href="jam/language.html#jam.language.flow_of_control">Flow-of-Control</a></span></dt> -<dt><span class="section"><a href="jam/language.html#jam.language.variables">Variables</a></span></dt> -<dt><span class="section"><a href="jam/language.html#jam.language.modules">Modules</a></span></dt> -</dl></dd> -<dt><span class="section"><a href="jam/miscellaneous.html">Miscellaneous</a></span></dt> -<dd><dl> -<dt><span class="section"><a href="jam/miscellaneous.html#jam.miscellaneous.diagnostics">Diagnostics</a></span></dt> -<dt><span class="section"><a href="jam/miscellaneous.html#jam.miscellaneous.bugs__limitations">Bugs, Limitations</a></span></dt> -<dt><span class="section"><a href="jam/miscellaneous.html#jam.miscellaneous.fundamentals">Fundamentals</a></span></dt> -</dl></dd> -<dt><span class="section"><a href="jam/history.html">History</a></span></dt> -</dl> -</div> -<div class="section"> -<div class="titlepage"><div><div><h2 class="title" style="clear: both"> -<a name="jam.building"></a><a class="link" href="jam.html#jam.building" title="Building B2">Building B2</a> -</h2></div></div></div> -<p> - Installing <code class="literal">B2</code> after building it is simply a matter of copying - the generated executables someplace in your <code class="literal">PATH</code>. For building - the executables there are a set of <code class="literal">build</code> bootstrap scripts - to accomodate particular environments. The scripts take one optional argument, - the name of the toolset to build with. When the toolset is not given an attempt - is made to detect an available toolset and use that. The build scripts accept - these arguments: - </p> -<pre class="programlisting"><span class="emphasis"><em>build</em></span> [<span class="emphasis"><em>toolset</em></span>] -</pre> -<p> - Running the scripts without arguments will give you the best chance of success. - On Windows platforms from a command console do: - </p> -<pre class="programlisting">cd <span class="emphasis"><em>jam source location</em></span> -.\build.bat -</pre> -<p> - On Unix type platforms do: - </p> -<pre class="programlisting">cd <span class="emphasis"><em>jam source location</em></span> -sh ./build.sh -</pre> -<p> - For the Boost.Jam source included with the Boost distribution the <span class="emphasis"><em>jam - source location</em></span> is <code class="literal">BOOST_ROOT/tools/build/src/engine</code>. - </p> -<p> - If the scripts fail to detect an appropriate toolset to build with your particular - toolset may not be auto-detectable. In that case, you can specify the toolset - as the first argument, this assumes that the toolset is readily available in - the <code class="literal">PATH</code>. - </p> -<div class="note"><table border="0" summary="Note"> -<tr> -<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../doc/src/images/note.png"></td> -<th align="left">Note</th> -</tr> -<tr><td align="left" valign="top"><p> - The toolset used to build Boost.Jam is independent of the toolsets used for - Boost.Build. Only one version of Boost.Jam is needed to use Boost.Build. - </p></td></tr> -</table></div> -<p> - The supported toolsets, and whether they are auto-detected, are: - </p> -<div class="table"> -<a name="jam.building.t0"></a><p class="title"><b>Table 50.1. Supported Toolsets</b></p> -<div class="table-contents"><table class="table" summary="Supported Toolsets"> -<colgroup> -<col> -<col> -<col> -<col> -</colgroup> -<thead><tr> -<th> - <p> - Script - </p> - </th> -<th> - <p> - Platform - </p> - </th> -<th> - <p> - Toolset - </p> - </th> -<th> - <p> - Detection and Notes - </p> - </th> -</tr></thead> -<tbody> -<tr> -<td> - <p> - <code class="literal">build.bat</code> - </p> - </td> -<td> - <p> - Windows NT, 2000, and XP - </p> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.codegear.com/downloads/free/cppbuilder" target="_top"><code class="literal">borland</code></a></td></tr> -<tr><td> -<a href="http://www.borland.com/" target="_top">Borland</a> C++Builder (BCC 5.5)</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem">Common install location: "<code class="literal">C:\Borland\BCC55</code>"</li> -<li class="listitem"> -<code class="literal">BCC32.EXE</code> - in <code class="literal">PATH</code> -</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.comeaucomputing.com/" target="_top"><code class="literal">como</code></a></td></tr> -<tr><td>Comeau - Computing C/C++</td></tr> -</table> -<p> - </p> - </td> -<td> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://gcc.gnu.org/" target="_top"><code class="literal">gcc</code></a></td></tr> -<tr><td>GNU - GCC</td></tr> -</table> -<p> - </p> - </td> -<td> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://gcc.gnu.org/" target="_top"><code class="literal">gcc-nocygwin</code></a></td></tr> -<tr><td>GNU - GCC</td></tr> -</table> -<p> - </p> - </td> -<td> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.intel.com/software/products/compilers/c60" target="_top"><code class="literal">intel-win32</code></a></td></tr> -<tr><td>Intel - C++ Compiler for Windows</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">ICL.EXE</code> in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.metrowerks.com/" target="_top"><code class="literal">metrowerks</code></a></td></tr> -<tr><td>MetroWerks - CodeWarrior C/C++ 7.x, 8.x, 9.x</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">CWFolder</code> variable configured</li> -<li class="listitem"> -<code class="literal">MWCC.EXE</code> - in <code class="literal">PATH</code> -</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.mingw.org/" target="_top"><code class="literal">mingw</code></a></td></tr> -<tr><td>GNU - <a href="http://gcc.gnu.org/" target="_top">GCC</a> as the <a href="http://www.mingw.org/" target="_top">MinGW</a> - configuration</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">Common install location: "<code class="literal">C:\MinGW</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://msdn.microsoft.com/visualc/" target="_top"><code class="literal">msvc</code></a></td></tr> -<tr><td>Microsoft - Visual C++ 6.x</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">VCVARS32.BAT</code> already configured</li> -<li class="listitem"> -<code class="literal">%MSVCDir%</code> - is present in environment</li> -<li class="listitem">Common install locations: "<code class="literal">%ProgramFiles%\Microsoft - Visual Studio</code>", "<code class="literal">%ProgramFiles%\Microsoft - Visual C++</code>"</li> -<li class="listitem"> -<code class="literal">CL.EXE</code> in <code class="literal">PATH</code> -</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://msdn.microsoft.com/visualc/" target="_top"><code class="literal">vc7</code></a></td></tr> -<tr><td>Microsoft - Visual C++ 7.x</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">VCVARS32.BAT</code> or <code class="literal">VSVARS32.BAT</code> - already configured</li> -<li class="listitem"> -<code class="literal">%VS71COMNTOOLS%</code> is present in - environment</li> -<li class="listitem"> -<code class="literal">%VCINSTALLDIR%</code> is present in environment</li> -<li class="listitem">Common - install locations: "<code class="literal">%ProgramFiles%\Microsoft Visual - Studio .NET</code>", "<code class="literal">%ProgramFiles%\Microsoft - Visual Studio .NET 2003</code>"</li> -<li class="listitem"> -<code class="literal">CL.EXE</code> - in <code class="literal">PATH</code> -</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://msdn.microsoft.com/visualc/" target="_top"><code class="literal">vc8</code> - and <code class="literal">vc9</code></a></td></tr> -<tr><td>Microsoft Visual C++ 8.x and 9.x</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - Detection: </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">VCVARSALL.BAT</code> already configured</li> -<li class="listitem"> -<code class="literal">%VS90COMNTOOLS%</code> - is present in environment</li> -<li class="listitem">Common install location: "<code class="literal">%ProgramFiles%\Microsoft - Visual Studio 9</code>"</li> -<li class="listitem"> -<code class="literal">%VS80COMNTOOLS%</code> - is present in environment</li> -<li class="listitem">Common install location: "<code class="literal">%ProgramFiles%\Microsoft - Visual Studio 8</code>"</li> -<li class="listitem"> -<code class="literal">CL.EXE</code> in <code class="literal">PATH</code> -</li> -</ul></div> -<p> - </p> - <p> - Notes: </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">If <code class="literal">VCVARSALL.BAT</code> is called to set up the - toolset, it is passed all the extra arguments, see below for what - those arguments are. This can be used to build, for example, a Win64 - specific version of <code class="literal">b2</code>. Consult the VisualStudio - documentation for what the possible argument values to the <code class="literal">VCVARSALL.BAT</code> - are.</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - <p> - <code class="literal">build.sh</code> - </p> - </td> -<td> - <p> - Unix, Linux, Cygwin, etc. - </p> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.hp.com/go/c++" target="_top"><code class="literal">acc</code></a></td></tr> -<tr><td>HP-UX - aCC</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">aCC</code> in <code class="literal">PATH</code> -</li> -<li class="listitem"> -<code class="literal">uname</code> - is "HP-UX"</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.comeaucomputing.com/" target="_top"><code class="literal">como</code></a></td></tr> -<tr><td>Comeau - Computing C/C++</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">como in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://gcc.gnu.org/" target="_top"><code class="literal">gcc</code></a></td></tr> -<tr><td>GNU - GCC</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">gcc in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.intel.com/software/products/compilers/c60l/" target="_top"><code class="literal">intel-linux</code></a></td></tr> -<tr><td>Intel - C++ for Linux</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> -<code class="literal">icc</code> in <code class="literal">PATH</code> -</li> -<li class="listitem">Common install locations: - "<code class="literal">/opt/intel/cc/9.0</code>", "<code class="literal">/opt/intel_cc_80</code>", - "<code class="literal">/opt/intel/compiler70</code>", "<code class="literal">/opt/intel/compiler60</code>", - "<code class="literal">/opt/intel/compiler50</code>"</li> -</ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><code class="literal">kcc</code></td></tr> -<tr><td>Intel KAI C++</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">KCC</code> in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.codegear.com/downloads/free/cppbuilder" target="_top"><code class="literal">kylix</code></a></td></tr> -<tr><td> -<a href="http://www.borland.com/" target="_top">Borland</a> C++Builder</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">bc++ in PATH</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.sgi.com/developers/devtools/languages/mipspro.html" target="_top"><code class="literal">mipspro</code></a></td></tr> -<tr><td>SGI - MIPSpro C</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">uname</code> is "<code class="literal">IRIX</code>" or - "<code class="literal">IRIX64</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><code class="literal">sunpro</code></td></tr> -<tr><td>Sun Workshop 6 C++</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">Standard install location: "<code class="literal">/opt/SUNWspro</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><code class="literal">qcc</code></td></tr> -<tr><td><a href="http://www.qnx.com/" target="_top">QNX Neutrino</a></td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">uname</code> is "<code class="literal">QNX</code>" and - <code class="literal">qcc</code> in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.tru64unix.compaq.com/cplus/" target="_top"><code class="literal">true64cxx</code></a></td></tr> -<tr><td>Compaq - C++ Compiler for True64 UNIX</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">uname</code> is "<code class="literal">OSF1</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.ibm.com/software/awdtools/vacpp/" target="_top"><code class="literal">vacpp</code></a></td></tr> -<tr><td>IBM - VisualAge C++</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">xlc</code> in <code class="literal">PATH</code> -</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - <p> - MacOS X - </p> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://developer.apple.com/tools/compilers.html" target="_top"><code class="literal">darwin</code></a></td></tr> -<tr><td>Apple - MacOS X GCC</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> -<code class="literal">uname</code> is "<code class="literal">Darwin</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -<tr> -<td> - </td> -<td> - <p> - Windows NT, 2000, and XP - </p> - </td> -<td> - <p> - </p> -<table border="0" summary="Simple list" class="simplelist"> -<tr><td><a href="http://www.mingw.org/" target="_top"><code class="literal">mingw</code></a></td></tr> -<tr><td>GNU - <a href="http://gcc.gnu.org/" target="_top">GCC</a> as the <a href="http://www.mingw.org/" target="_top">MinGW</a> - configuration with the MSYS shell</td></tr> -</table> -<p> - </p> - </td> -<td> - <p> - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">Common install location: "<code class="literal">/mingw</code>"</li></ul></div> -<p> - </p> - </td> -</tr> -</tbody> -</table></div> -</div> -<br class="table-break"><p> - The built executables are placed in a subdirectory specific to your platform. - For example, in Linux running on an Intel x86 compatible chip, the executables - are placed in: "<code class="literal">bin.linuxx86</code>". The =b2[.exe]= - executable can be used to invoke Boost.Build. - </p> -<p> - The build scripts support additional invocation arguments for use by developers - of Boost.Jam and for additional setup of the toolset. The extra arguments come - after the toolset: - </p> -<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> -<li class="listitem"> - Arguments not in the form of an option, before option arguments, are used - for extra setup to toolset configuration scripts. - </li> -<li class="listitem"> - Arguments of the form "<code class="literal">--option</code>", which are - passed to the <code class="literal">build.jam</code> build script. - </li> -<li class="listitem"> - Arguments not in the form of an option, after the options, which are targets - for the <code class="literal">build.jam</code> script. - </li> -</ul></div> -<pre class="programlisting"><span class="emphasis"><em>build</em></span> [<span class="emphasis"><em>toolset</em></span>] [<span class="emphasis"><em>setup</em></span>*] [--<span class="emphasis"><em>option</em></span>+ <span class="emphasis"><em>target</em></span>*] -</pre> -<p> - The arguments immediately after the toolset are passed directly to the setup - script of the toolset, if available and if it needs to be invoked. This allows - one to configure the toolset as needed to do non-default builds of <code class="literal">b2</code>. - For example to build a Win64 version with <code class="literal">vc8</code>. See the toolset - descriptiona above for when particular toolsets support this. - </p> -<p> - The arguments starting with the "<code class="literal">--option</code>" forms - are passed to the <code class="literal">build.jam</code> script and are used to further - customize what gets built. Options and targets supported by the <code class="literal">build.jam</code> - script: - </p> -<div class="variablelist"> -<p class="title"><b></b></p> -<dl class="variablelist"> -<dt><span class="term"><div class="literallayout"><p><code class="literal">---</code></p></div></span></dt> -<dd><p> - Empty option when one wants to only specify a target. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--release</code></p></div></span></dt> -<dd><p> - The default, builds the optimized executable. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--debug</code></p></div></span></dt> -<dd><p> - Builds debugging versions of the executable. When built they are placed - in their own directory "<code class="literal">bin./platform/.debug</code>". - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--grammar</code></p></div></span></dt> -<dd><p> - Normally the Jam language grammar parsing files are not regenerated. - This forces building of the grammar, although it may not force the regeneration - of the grammar parser. If the parser is out of date it will be regenerated - and subsequently built. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--with-python=<span class="emphasis"><em>path</em></span></code></p></div></span></dt> -<dd><p> - Enables Python integration, given a path to the Python libraries. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--gc</code></p></div></span></dt> -<dd><p> - Enables use of the Boehm Garbage Collector. The build will look for the - Boehm-GC source in a "boehm_gc" subdirectory from the <code class="literal">b2</code> - sources. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--duma</code></p></div></span></dt> -<dd><p> - Enables use of the DUMA (Detect Unintended Memory Access) debugging memory - allocator. The build expects to find the DUMA source files in a "duma" - subdirectory from the <code class="literal">b2</code> sources. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--toolset-root=<span class="emphasis"><em>path</em></span></code></p></div></span></dt> -<dd><p> - Indicates where the toolset used to build is located. This option is - passed in by the bootstrap (<code class="literal">build.bat</code> or <code class="literal">build.sh</code>) - script. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--show-locate-target</code></p></div></span></dt> -<dd><p> - For information, prints out where it will put the built executable. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">--noassert</code></p></div></span></dt> -<dd><p> - Disable debug assertions, even if building the debug version of the executable. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">dist</code></p></div></span></dt> -<dd><p> - Generate packages (compressed archives) as appropriate for distribution - in the platform, if possible. - </p></dd> -<dt><span class="term"><div class="literallayout"><p><code class="literal">clean</code></p></div></span></dt> -<dd><p> - Remove all the built executables and objects. - </p></dd> -</dl> -</div> -</div> -</div> -<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> -<td align="left"></td> -<td align="right"><div class="copyright-footer"></div></td> -</tr></table> -<hr> -<div class="spirit-nav"> -<a accesskey="p" href="examples.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="tools.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="jam/language.html"><img src="../../doc/src/images/next.png" alt="Next"></a> -</div> -</body> -</html> |