[article Boost.Jam    [quickbook 1.3]    [version: 3.1.16]    [authors [Rivera, Rene], [Abrahams, David], [Prus, Vladimir]]    [copyright 2003 2004 2005 2006 2007 Rene Rivera, David Abrahams, Vladimir Prus]    [category tool-build]    [id jam]    [dirname jam]    [purpose        Jam is a make(1) replacement that makes building simple things simple         and building complicated things manageable.    ]    [license        Distributed under the Boost Software License, Version 1.0.        (See accompanying file LICENSE_1_0.txt or copy at        [@http://www.boost.org/LICENSE_1_0.txt])    ]][/ QuickBook Document version 1.3 ][/ Shortcuts ][def :version: 3.1.16][/ Images ][def :NOTE:                 [$images/note.png]][def :ALERT:                [$images/caution.png]][def :DETAIL:               [$images/note.png]][def :TIP:                  [$images/tip.png]][/ Links ][def :Boost:                [@http://www.boost.org Boost]][def :Perforce_Jam:         [@http://www.perforce.com/jam/jam.html Perforce Jam]][/ Templates ][template literal[text]'''<literallayout>'''[text]'''</literallayout>'''][template list[items]'''<itemizedlist>'''[items]'''</itemizedlist>'''][template orderedlist[items]'''<orderedlist>'''[items]'''</orderedlist>'''][template li[text]'''<listitem>'''[text]'''</listitem>'''][template lines[items]'''<simplelist type='vert' columns='1'>'''[items]'''</simplelist>'''][template line[text]'''<member>'''[text]'''</member>'''][section:intro Introduction]Boost.Jam (BJam)  is a build tool based on FTJam, which in turn is based on :Perforce_Jam:. It contains significant improvements made to facilitate its use in the Boost Build System, but should be backward compatible with :Perforce_Jam:.This is version :version: of BJam and is based on version 2.4 of Jam/MR:[pre/+\+\  Copyright 1993-2002 Christopher Seiwald and Perforce Software, Inc.\+/This is Release 2.4 of Jam/MR, a make-like program.License is hereby granted to use this software and distribute itfreely, as long as this copyright notice is retained and modificationsare clearly marked.ALL WARRANTIES ARE HEREBY DISCLAIMED.][section:features Features]Jam is a make(1) replacement that makes building simple things simple and building complicated things manageable. Jam's language is expressive, making Jamfiles (c.f. Makefiles) compact.Jam handles header file dependencies automatically and on-the-fly.Jam is very portable: it runs on UNIX, VMS, Mac, and NT. Most Jamfiles themselves are portable.Jam is unintrusive: it is small, it has negligible CPU overhead, and it doesn't create any of its own funny files (c.f. Odin, nmake, SunOS make).Jam can build large projects spread across many directories in one pass, without recursing, tracking the relationships among all files. Jam can do this with multiple, concurrent processes.Jam isn't under the blinkin GNU copyright, so you can incorporate it into commercial products.[endsect][endsect][section:building Building BJam]Installing =BJam= after building it is simply a matter of copying thegenerated executables someplace in your =PATH=. For building the executablesthere are a set of =build= bootstrap scripts to accomodate particularenvironments. The scripts take one optional argument, the name of the toolsetto build with. When the toolset is not given an attempt is made to detect anavailable toolset and use that. The build scripts accept these arguments:[pre/build/ \[/toolset/\]]Running the scripts without arguments will give you the best chance of success. On Windows platforms from a command console do:[precd /jam source location/.\\build.bat]On Unix type platforms do:[precd /jam source location/sh ./build.sh]For the Boost.Jam source included with the Boost distribution the /jam source location/ is =BOOST_ROOT/tools/jam/src=.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 =PATH=.[noteThe 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.]The supported toolsets, and wether they are auto-detected, are:[table Supported Toolsets[[Script] [Platform] [Toolset] [Detection and Notes]][   [=build.bat=] [Windows NT, 2000, and XP]    [[lines        [line [@http://www.codegear.com/downloads/free/cppbuilder =borland=]]        [line [@http://www.borland.com/ Borland] C++Builder (BCC 5.5)]        ]]    [[list        [li Common install location: "=C:\Borland\BCC55="]        [li =BCC32.EXE= in =PATH=]        ]]][   [] []    [[lines        [line [@http://www.comeaucomputing.com/ =como=]]        [line Comeau Computing C/C++]        ]]    []][   [] []    [[lines        [line [@http://gcc.gnu.org/ =gcc=]]        [line GNU GCC]        ]]    []][   [] []    [[lines        [line [@http://gcc.gnu.org/ =gcc-nocygwin=]]        [line GNU GCC]        ]]    []][   [] []    [[lines        [line [@http://www.intel.com/software/products/compilers/c60 =intel-win32=]]        [line Intel C++ Compiler for Windows]        ]]    [[list        [li =ICL.EXE= in =PATH=]        ]]][   [] []    [[lines        [line [@http://www.metrowerks.com/ =metrowerks=]]        [line MetroWerks CodeWarrior C/C++ 7.x, 8.x, 9.x]        ]]    [[list        [li =CWFolder= variable configured]        [li =MWCC.EXE= in =PATH=]        ]]][   [] []    [[lines        [line [@http://www.mingw.org/ =mingw=]]        [line GNU [@http://gcc.gnu.org/ GCC] as the [@http://www.mingw.org/ MinGW] configuration]        ]]    [[list        [li Common install location: "=C:\MinGW="]        ]]][   [] []    [[lines        [line [@http://msdn.microsoft.com/visualc/ =msvc=]]        [line Microsoft Visual C++ 6.x]        ]]    [[list        [li =VCVARS32.BAT= already configured]        [li =%MSVCDir%= is present in environment]        [li Common install locations: "=%ProgramFiles%\Microsoft Visual Studio=", "=%ProgramFiles%\Microsoft Visual C++="]        [li =CL.EXE= in =PATH=]        ]]][   [] []    [[lines        [line [@http://msdn.microsoft.com/visualc/ =vc7=]]        [line Microsoft Visual C++ 7.x]        ]]    [[list        [li =VCVARS32.BAT= or =VSVARS32.BAT= already configured]        [li =%VS71COMNTOOLS%= is present in environment]        [li =%VCINSTALLDIR%= is present in environment]        [li Common install locations: "=%ProgramFiles%\Microsoft Visual Studio .NET=", "=%ProgramFiles%\Microsoft Visual Studio .NET 2003="]        [li =CL.EXE= in =PATH=]        ]]][   [] []    [[lines        [line [@http://msdn.microsoft.com/visualc/ =vc8= and =vc9=]]        [line Microsoft Visual C++ 8.x and 9.x]        ]]    [Detection:        [list            [li =VCVARSALL.BAT= already configured]            [li =%VS90COMNTOOLS%= is present in environment]            [li Common install location: "=%ProgramFiles%\Microsoft Visual Studio 9="]            [li =%VS80COMNTOOLS%= is present in environment]            [li Common install location: "=%ProgramFiles%\Microsoft Visual Studio 8="]            [li =CL.EXE= in =PATH=]            ]        Notes:        [list            [li If =VCVARSALL.BAT= 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 =bjam=. Consult the VisualStudio documentation for what the possible argument values to the =VCVARSALL.BAT= are.]            ]        ]][   [=build.sh=] [Unix, Linux, Cygwin, etc.]    [[lines        [line [@http://www.hp.com/go/c++ =acc=]]        [line HP-UX aCC]        ]]    [[list        [li =aCC= in =PATH=]        [li =uname= is "HP-UX"]        ]]][   [] []    [[lines        [line [@http://www.comeaucomputing.com/ =como=]]        [line Comeau Computing C/C++]        ]]    [[list        [li como in =PATH=]        ]]][   [] []    [[lines        [line [@http://gcc.gnu.org/ =gcc=]]        [line GNU GCC]        ]]    [[list        [li gcc in =PATH=]        ]]][   [] []    [[lines        [line [@http://www.intel.com/software/products/compilers/c60l/ =intel-linux=]]        [line Intel C++ for Linux]        ]]    [[list        [li =icc= in =PATH=]        [li Common install locations: "=/opt/intel/cc/9.0=", "=/opt/intel_cc_80=", "=/opt/intel/compiler70=", "=/opt/intel/compiler60=", "=/opt/intel/compiler50="]        ]]][   [] []    [[lines        [line =kcc=]        [line Intel KAI C++]        ]]    [[list        [li =KCC= in =PATH=]        ]]][   [] []    [[lines        [line [@http://www.codegear.com/downloads/free/cppbuilder =kylix=]]        [line [@http://www.borland.com/ Borland] C++Builder]        ]]    [[list        [li bc++ in PATH]        ]]][   [] []    [[lines        [line [@http://www.sgi.com/developers/devtools/languages/mipspro.html =mipspro=]]        [line SGI MIPSpro C]        ]]    [[list        [li =uname= is "=IRIX=" or "=IRIX64="]        ]]][   [] []    [[lines        [line =sunpro=]        [line Sun Workshop 6 C++]        ]]    [[list        [li Standard install location: "=/opt/SUNWspro="]        ]]][   [] []    [[lines        [line =qcc=]        [line [@http://www.qnx.com/ QNX Neutrino]]        ]]    [[list        [li =uname= is "=QNX=" and =qcc= in =PATH=]        ]]]