| <html> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> | |
| <title>Building BJam</title> | |
| <link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> | |
| <meta name="generator" content="DocBook XSL Stylesheets V1.75.2"> | |
| <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> | |
| <link rel="up" href="../jam.html" title="Chapter 32. Boost.Jam : 3.1.19"> | |
| <link rel="prev" href="../jam.html" title="Chapter 32. Boost.Jam : 3.1.19"> | |
| <link rel="next" href="usage.html" title="Using BJam"> | |
| </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="../jam.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../jam.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="usage.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> | |
| </div> | |
| <div class="section"> | |
| <div class="titlepage"><div><div><h2 class="title" style="clear: both"> | |
| <a name="jam.building"></a><a class="link" href="building.html" title="Building BJam">Building BJam</a> | |
| </h2></div></div></div> | |
| <p> | |
| Installing <code class="literal">BJam</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/jam/src</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="id3251887"></a><p class="title"><b>Table 32.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" 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" 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" 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" 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" 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" 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" 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" 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">bjam</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" 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" 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" 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" 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" 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" 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" 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" 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" 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" 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" 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" 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" 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 =bjam[.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" 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 ass needed to do non-default builds of <code class="literal">bjam</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> | |
| <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">bjam</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 Uintended Memory Access) debugging memory | |
| allocator. The build expects to find the DUMA source files in a "duma" | |
| subdirectory from the <code class="literal">bjam</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> | |
| <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">Copyright © 2003-2007 Rene Rivera, David Abrahams, Vladimir Prus<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></td> | |
| </tr></table> | |
| <hr> | |
| <div class="spirit-nav"> | |
| <a accesskey="p" href="../jam.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../jam.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="usage.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> | |
| </div> | |
| </body> | |
| </html> |