Blame Jamroot

Packit 58578d
# Copyright Vladimir Prus 2002-2006.
Packit 58578d
# Copyright Dave Abrahams 2005-2006.
Packit 58578d
# Copyright Rene Rivera 2005-2007.
Packit 58578d
# Copyright Douglas Gregor 2005.
Packit 58578d
#
Packit 58578d
# Distributed under the Boost Software License, Version 1.0.
Packit 58578d
# (See accompanying file LICENSE_1_0.txt or copy at
Packit 58578d
# http://www.boost.org/LICENSE_1_0.txt)
Packit 58578d
Packit 58578d
# Usage:
Packit 58578d
#
Packit 58578d
#   b2 [options] [properties] [install|stage]
Packit 58578d
#
Packit 58578d
#   Builds and installs Boost.
Packit 58578d
#
Packit 58578d
# Targets and Related Options:
Packit 58578d
#
Packit 58578d
#   install                 Install headers and compiled library files to the
Packit 58578d
#   =======                 configured locations (below).
Packit 58578d
#
Packit 58578d
#   --prefix=<PREFIX>       Install architecture independent files here.
Packit 58578d
#                           Default; C:\Boost on Win32
Packit 58578d
#                           Default; /usr/local on Unix. Linux, etc.
Packit 58578d
#
Packit 58578d
#   --exec-prefix=<EPREFIX> Install architecture dependent files here.
Packit 58578d
#                           Default; <PREFIX>
Packit 58578d
#
Packit 58578d
#   --libdir=<DIR>          Install library files here.
Packit 58578d
#                           Default; <EPREFIX>/lib
Packit 58578d
#
Packit 58578d
#   --includedir=<HDRDIR>   Install header files here.
Packit 58578d
#                           Default; <PREFIX>/include
Packit 58578d
#
Packit 58578d
#   stage                   Build and install only compiled library files to the
Packit 58578d
#   =====                   stage directory.
Packit 58578d
#
Packit 58578d
#   --stagedir=<STAGEDIR>   Install library files here
Packit 58578d
#                           Default; ./stage
Packit 58578d
#
Packit 58578d
# Other Options:
Packit 58578d
#
Packit 58578d
#   --build-type=<type>     Build the specified pre-defined set of variations of
Packit 58578d
#                           the libraries. Note, that which variants get built
Packit 58578d
#                           depends on what each library supports.
Packit 58578d
#
Packit 58578d
#                               -- minimal -- (default) Builds a minimal set of
Packit 58578d
#                               variants. On Windows, these are static
Packit 58578d
#                               multithreaded libraries in debug and release
Packit 58578d
#                               modes, using shared runtime. On Linux, these are
Packit 58578d
#                               static and shared multithreaded libraries in
Packit 58578d
#                               release mode.
Packit 58578d
#
Packit 58578d
#                               -- complete -- Build all possible variations.
Packit 58578d
#
Packit 58578d
#   --build-dir=DIR         Build in this location instead of building within
Packit 58578d
#                           the distribution tree. Recommended!
Packit 58578d
#
Packit 58578d
#   --show-libraries        Display the list of Boost libraries that require
Packit 58578d
#                           build and installation steps, and then exit.
Packit 58578d
#
Packit 58578d
#   --layout=<layout>       Determine whether to choose library names and header
Packit 58578d
#                           locations such that multiple versions of Boost or
Packit 58578d
#                           multiple compilers can be used on the same system.
Packit 58578d
#
Packit 58578d
#                               -- versioned -- Names of boost binaries include
Packit 58578d
#                               the Boost version number, name and version of
Packit 58578d
#                               the compiler and encoded build properties. Boost
Packit 58578d
#                               headers are installed in a subdirectory of
Packit 58578d
#                               <HDRDIR> whose name contains the Boost version
Packit 58578d
#                               number.
Packit 58578d
#
Packit 58578d
#                               -- tagged -- Names of boost binaries include the
Packit 58578d
#                               encoded build properties such as variant and
Packit 58578d
#                               threading, but do not including compiler name
Packit 58578d
#                               and version, or Boost version. This option is
Packit 58578d
#                               useful if you build several variants of Boost,
Packit 58578d
#                               using the same compiler.
Packit 58578d
#
Packit 58578d
#                               -- system -- Binaries names do not include the
Packit 58578d
#                               Boost version number or the name and version
Packit 58578d
#                               number of the compiler. Boost headers are
Packit 58578d
#                               installed directly into <HDRDIR>. This option is
Packit 58578d
#                               intended for system integrators building
Packit 58578d
#                               distribution packages.
Packit 58578d
#
Packit 58578d
#                           The default value is 'versioned' on Windows, and
Packit 58578d
#                           'system' on Unix.
Packit 58578d
#
Packit 58578d
#   --buildid=ID            Add the specified ID to the name of built libraries.
Packit 58578d
#                           The default is to not add anything.
Packit 58578d
#
Packit 58578d
#   --python-buildid=ID     Add the specified ID to the name of built libraries
Packit 58578d
#                           that depend on Python. The default is to not add
Packit 58578d
#                           anything. This ID is added in addition to --buildid.
Packit 58578d
#
Packit 58578d
#   --help                  This message.
Packit 58578d
#
Packit 58578d
#   --with-<library>        Build and install the specified <library>. If this
Packit 58578d
#                           option is used, only libraries specified using this
Packit 58578d
#                           option will be built.
Packit 58578d
#
Packit 58578d
#   --without-<library>     Do not build, stage, or install the specified
Packit 58578d
#                           <library>. By default, all libraries are built.
Packit 58578d
#
Packit 58578d
# Properties:
Packit 58578d
#
Packit 58578d
#   toolset=toolset         Indicate the toolset to build with.
Packit 58578d
#
Packit 58578d
#   variant=debug|release   Select the build variant
Packit 58578d
#
Packit 58578d
#   link=static|shared      Whether to build static or shared libraries
Packit 58578d
#
Packit 58578d
#   threading=single|multi  Whether to build single or multithreaded binaries
Packit 58578d
#
Packit 58578d
#   runtime-link=static|shared
Packit 58578d
#                           Whether to link to static or shared C and C++
Packit 58578d
#                           runtime.
Packit 58578d
#
Packit 58578d
Packit 58578d
# TODO:
Packit 58578d
#  - handle boost version
Packit 58578d
#  - handle python options such as pydebug
Packit 58578d
Packit 58578d
import boostcpp ;
Packit 58578d
import package ;
Packit 58578d
Packit 58578d
import sequence ;
Packit 58578d
import xsltproc ;
Packit 58578d
import set ;
Packit 58578d
import path ;
Packit 58578d
import link ;
Packit 58578d
import threadapi-feature ;
Packit 58578d
Packit 58578d
path-constant BOOST_ROOT : . ;
Packit 58578d
constant BOOST_VERSION : 1.66.0 ;
Packit 58578d
constant BOOST_JAMROOT_MODULE : $(__name__) ;
Packit 58578d
Packit 58578d
boostcpp.set-version $(BOOST_VERSION) ;
Packit 58578d
Packit 58578d
use-project /boost/architecture : libs/config/checks/architecture ;
Packit 58578d
Packit 58578d
local all-headers =
Packit 58578d
    [ MATCH .*libs/(.*)/include/boost : [ glob libs/*/include/boost libs/*/*/include/boost ] ] ;
Packit 58578d
Packit 58578d
for dir in $(all-headers)
Packit 58578d
{
Packit 58578d
    link-directory $(dir)-headers : libs/$(dir)/include/boost : <location>. ;
Packit 58578d
    explicit $(dir)-headers ;
Packit 58578d
}
Packit 58578d
Packit 58578d
if $(all-headers)
Packit 58578d
{
Packit 58578d
    constant BOOST_MODULARLAYOUT : $(all-headers) ;
Packit 58578d
}
Packit 58578d
Packit 58578d
project boost
Packit 58578d
    : requirements <include>.
Packit 58578d
Packit 58578d
      [ boostcpp.architecture ]
Packit 58578d
      [ boostcpp.address-model ]
Packit 58578d
Packit 58578d
      # Disable auto-linking for all targets here, primarily because it caused
Packit 58578d
      # troubles with V2.
Packit 58578d
      <define>BOOST_ALL_NO_LIB=1
Packit 58578d
      # Used to encode variant in target name. See the 'tag' rule below.
Packit 58578d
      <tag>@$(__name__).tag
Packit 58578d
      <conditional>@handle-static-runtime
Packit 58578d
      # Comeau does not support shared lib
Packit 58578d
      <toolset>como:<link>static
Packit 58578d
      <toolset>como-linux:<define>_GNU_SOURCE=1
Packit 58578d
      # When building docs within Boost, we want the standard Boost style
Packit 58578d
      <xsl:param>boost.defaults=Boost
Packit 58578d
      <conditional>@threadapi-feature.detect
Packit 58578d
    : usage-requirements <include>.
Packit 58578d
    : build-dir bin.v2
Packit 58578d
    ;
Packit 58578d
Packit 58578d
# This rule is called by Boost.Build to determine the name of target. We use it
Packit 58578d
# to encode the build variant, compiler name and boost version in the target
Packit 58578d
# name.
Packit 58578d
#
Packit 58578d
rule tag ( name : type ? : property-set )
Packit 58578d
{
Packit 58578d
    return [ boostcpp.tag $(name) : $(type) : $(property-set) ] ;
Packit 58578d
}
Packit 58578d
Packit 58578d
rule python-tag ( name : type ? : property-set )
Packit 58578d
{
Packit 58578d
    return [ boostcpp.python-tag $(name) : $(type) : $(property-set) ] ;
Packit 58578d
}
Packit 58578d
Packit 58578d
rule handle-static-runtime ( properties * )
Packit 58578d
{
Packit 58578d
    # Using static runtime with shared libraries is impossible on Linux, and
Packit 58578d
    # dangerous on Windows. Therefore, we disallow it. This might be drastic,
Packit 58578d
    # but it was disabled for a while without anybody complaining.
Packit 58578d
Packit 58578d
    # For CW, static runtime is needed so that std::locale works.
Packit 58578d
    if <link>shared in $(properties) && <runtime-link>static in $(properties) &&
Packit 58578d
        ! ( <toolset>cw in $(properties) )
Packit 58578d
    {
Packit 58578d
        if ! $(.shared-static-warning-emitted)
Packit 58578d
        {
Packit 58578d
            ECHO "warning: skipping configuration link=shared, runtime-link=static" ;
Packit 58578d
            ECHO "warning: this combination is either impossible or too dangerous" ;
Packit 58578d
            ECHO "warning: to be of any use" ;
Packit 58578d
            .shared-static-warning-emitted = 1 ;
Packit 58578d
        }
Packit 58578d
Packit 58578d
        return <build>no ;
Packit 58578d
    }
Packit 58578d
}
Packit 58578d
Packit 58578d
all-libraries = [ MATCH .*libs/(.*)/build/.* : [ glob libs/*/build/Jamfile.v2 ]
Packit 58578d
    [ glob libs/*/build/Jamfile ] ] ;
Packit 58578d
Packit 58578d
all-libraries = [ sequence.unique $(all-libraries) ] ;
Packit 58578d
# The function_types library has a Jamfile, but it's used for maintenance
Packit 58578d
# purposes, there's no library to build and install.
Packit 58578d
all-libraries = [ set.difference $(all-libraries) : function_types ] ;
Packit 58578d
Packit 58578d
# Setup convenient aliases for all libraries.
Packit 58578d
Packit 58578d
local rule explicit-alias ( id : targets + )
Packit 58578d
{
Packit 58578d
    alias $(id) : $(targets) ;
Packit 58578d
    explicit $(id) ;
Packit 58578d
}
Packit 58578d
Packit 58578d
# First, the complicated libraries: where the target name in Jamfile is
Packit 58578d
# different from its directory name.
Packit 58578d
explicit-alias prg_exec_monitor : libs/test/build//boost_prg_exec_monitor ;
Packit 58578d
explicit-alias test_exec_monitor : libs/test/build//boost_test_exec_monitor ;
Packit 58578d
explicit-alias unit_test_framework : libs/test/build//boost_unit_test_framework ;
Packit 58578d
explicit-alias bgl-vis : libs/graps/build//bgl-vis ;
Packit 58578d
explicit-alias serialization : libs/serialization/build//boost_serialization ;
Packit 58578d
explicit-alias wserialization : libs/serialization/build//boost_wserialization ;
Packit 58578d
for local l in $(all-libraries)
Packit 58578d
{
Packit 58578d
    if ! $(l) in test graph serialization
Packit 58578d
    {
Packit 58578d
        explicit-alias $(l) : libs/$(l)/build//boost_$(l) ;
Packit 58578d
    }
Packit 58578d
}
Packit 58578d
Packit 58578d
# Log has an additional target
Packit 58578d
explicit-alias log_setup : libs/log/build//boost_log_setup ;
Packit 58578d
Packit 58578d
alias headers : $(all-headers)-headers : : : <include>.  ;
Packit 58578d
explicit headers ;
Packit 58578d
Packit 58578d
# Make project ids of all libraries known.
Packit 58578d
for local l in $(all-libraries)
Packit 58578d
{
Packit 58578d
    use-project /boost/$(l) : libs/$(l)/build ;
Packit 58578d
}
Packit 58578d
Packit 58578d
if [ path.exists $(BOOST_ROOT)/tools/inspect/build ]
Packit 58578d
{
Packit 58578d
    use-project /boost/tools/inspect : tools/inspect/build ;
Packit 58578d
}
Packit 58578d
Packit 58578d
if [ path.exists $(BOOST_ROOT)/libs/wave/tool/build ]
Packit 58578d
{
Packit 58578d
    use-project /boost/libs/wave/tool : libs/wave/tool/build ;
Packit 58578d
}
Packit 58578d
Packit 58578d
# This rule should be called from libraries' Jamfiles and will create two
Packit 58578d
# targets, "install" and "stage", that will install or stage that library. The
Packit 58578d
# --prefix option is respected, but --with and --without options, naturally, are
Packit 58578d
# ignored.
Packit 58578d
#
Packit 58578d
# - libraries -- list of library targets to install.
Packit 58578d
#
Packit 58578d
rule boost-install ( libraries * )
Packit 58578d
{
Packit 58578d
    package.install install
Packit 58578d
        : <dependency>/boost//install-proper-headers $(install-requirements)
Packit 58578d
        : # No binaries
Packit 58578d
        : $(libraries)
Packit 58578d
        : # No headers, it is handled by the dependency.
Packit 58578d
    ;
Packit 58578d
Packit 58578d
    install stage : $(libraries) : <location>$(BOOST_STAGE_LOCATE) ;
Packit 58578d
Packit 58578d
    module [ CALLER_MODULE ]
Packit 58578d
    {
Packit 58578d
        explicit stage ;
Packit 58578d
        explicit install ;
Packit 58578d
    }
Packit 58578d
}
Packit 58578d
Packit 58578d
# Creates a library target, adding autolink support and also creates
Packit 58578d
# stage and install targets via boost-install, above.
Packit 58578d
rule boost-lib ( name : sources * : requirements * : default-build * : usage-requirements * )
Packit 58578d
{
Packit 58578d
    name = boost_$(name) ;
Packit 58578d
    autolink = <link>shared:<define>$(name:U)_DYN_LINK=1 ;
Packit 58578d
    lib $(name)
Packit 58578d
        : $(sources)
Packit 58578d
        : $(requirements) $(autolink)
Packit 58578d
        : $(default-build)
Packit 58578d
        : $(usage-requirements) $(autolink)
Packit 58578d
        ;
Packit 58578d
    boost-install $(name) ;
Packit 58578d
}
Packit 58578d
Packit 58578d
Packit 58578d
headers =
Packit 58578d
    # The .SUNWCCh files are present in tr1 include directory and have to be
Packit 58578d
    # installed (see http://lists.boost.org/Archives/boost/2007/05/121430.php).
Packit 58578d
    [ path.glob-tree $(BOOST_ROOT)/boost : *.hpp *.ipp *.h *.inc *.SUNWCCh : CVS .svn ]
Packit 58578d
    [ path.glob-tree $(BOOST_ROOT)/boost/compatibility/cpp_c_headers : c* : CVS .svn ]
Packit 58578d
    [ path.glob boost/tr1/tr1 : * : bcc32 sun CVS .svn ]
Packit 58578d
    ;
Packit 58578d
Packit 58578d
# Declare special top-level targets that build and install the desired variants
Packit 58578d
# of the libraries.
Packit 58578d
boostcpp.declare-targets $(all-libraries) : $(headers) ;