From 1c78556dc093d48bff646c288efa76d909a61e04 Mon Sep 17 00:00:00 2001 From: Vladimir Prus Date: Mon, 9 Aug 2010 08:59:19 +0000 Subject: [PATCH] Refactor Jamroot. [SVN r64690] --- Jamroot | 579 ++++----------------------------------------------- boostcpp.jam | 574 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 617 insertions(+), 536 deletions(-) create mode 100644 boostcpp.jam diff --git a/Jamroot b/Jamroot index 65b191111b..91ef5b932b 100644 --- a/Jamroot +++ b/Jamroot @@ -123,66 +123,18 @@ # - handle boost version # - handle python options such as pydebug -import generate ; -import modules ; -import set ; -import stage ; +import boostcpp ; import package ; -import path ; -import common ; -import os ; -import regex ; -import errors ; -import "class" : new ; -import common ; + import sequence ; -import symlink ; -import targets ; -import project ; -import option ; import xsltproc ; -import build-system ; -import configure ; +import set ; path-constant BOOST_ROOT : . ; constant BOOST_VERSION : 1.44.0 ; constant BOOST_JAMROOT_MODULE : $(__name__) ; -local version-tag = [ MATCH "^([^.]+)[.]([^.]+)[.]([^.]+)" : $(BOOST_VERSION) ] - ; -if $(version-tag[3]) = 0 -{ - version-tag = $(version-tag[1-2]) ; -} - -constant BOOST_VERSION_TAG : $(version-tag:J="_") ; - -# Option to choose how many variants to build. The default is "minimal". -local build-type = [ MATCH "^--build-type=(.*)" : [ modules.peek : ARGV ] ] ; -build-type ?= minimal ; -if ! ( $(build-type) in minimal complete ) -{ - ECHO "The value of the --build-type option should be either 'complete' or 'minimal'" ; - EXIT ; -} - -rule handle-static-runtime ( properties * ) -{ - # Using static runtime with shared libraries is impossible on Linux, - # and dangerous on Windows. Therefore, we disallow it. This might - # be drastic, but it was disabled for a while with nobody complaining. - - # For CW, static runtime is needed so that std::locale works. - if shared in $(properties) && static in $(properties) && - ! ( cw in $(properties) ) - { - ECHO "error: link=shared together with runtime-link=static is not allowed" ; - ECHO "error: such property combination is either impossible " ; - ECHO "error: or too dangerious to be of any use" ; - EXIT ; - } -} - +boostcpp.set-version $(BOOST_VERSION) ; project boost : requirements . @@ -204,8 +156,31 @@ project boost : build-dir bin.v2 ; +# This rule is called by Boost.Build to determine the name of target. We use it +# to encode the build variant, compiler name and boost version in the target +# name. +# +rule tag ( name : type ? : property-set ) +{ + return [ boostcpp.tag $(name) : $(type) : $(property-set) ] ; +} + +rule handle-static-runtime ( properties * ) +{ + # Using static runtime with shared libraries is impossible on Linux, + # and dangerous on Windows. Therefore, we disallow it. This might + # be drastic, but it was disabled for a while with nobody complaining. -# Setup convenient aliases for all libraries. + # For CW, static runtime is needed so that std::locale works. + if shared in $(properties) && static in $(properties) && + ! ( cw in $(properties) ) + { + ECHO "error: link=shared together with runtime-link=static is not allowed" ; + ECHO "error: such property combination is either impossible " ; + ECHO "error: or too dangerious to be of any use" ; + EXIT ; + } +} all-libraries = [ MATCH .*libs/(.*)/build/.* : [ glob libs/*/build/Jamfile.v2 ] [ glob libs/*/build/Jamfile ] ] @@ -216,7 +191,7 @@ all-libraries = [ sequence.unique $(all-libraries) ] ; # purposes, there's no library to build and install. all-libraries = [ set.difference $(all-libraries) : function_types ] ; -configure.register-components $(all-libraries) ; +# Setup convenient aliases for all libraries. local rule explicit-alias ( id : targets + ) { @@ -224,7 +199,6 @@ local rule explicit-alias ( id : targets + ) explicit $(id) ; } - # First, the complicated libraries: where the target name in Jamfile is # different from its directory name. explicit-alias prg_exec_monitor : libs/test/build//boost_prg_exec_monitor ; @@ -242,486 +216,14 @@ for local l in $(all-libraries) } alias headers : : : : . ; +explicit headers ; - -# Decides which libraries are to be installed by looking at --with- -# --without- arguments. Returns the list of directories under "libs" -# which must be built and installed. -# -rule libraries-to-install ( existing-libraries * ) +# Make project ids of all libraries known. +for local l in $(all-libraries) { - local argv = [ modules.peek : ARGV ] ; - local with-parameter = [ MATCH --with-(.*) : $(argv) ] ; - local without-parameter = [ MATCH --without-(.*) : $(argv) ] ; - - if ! $(with-parameter) && ! $(without-parameter) - { - # Nothing is specified on command line. See if maybe - # project-config.jam has some choices. - local project-config-libs = [ modules.peek project-config : libraries ] ; - with-parameter = [ MATCH --with-(.*) : $(project-config-libs) ] ; - without-parameter = [ MATCH --without-(.*) : $(project-config-libs) ] ; - } - - # Do some checks. - if $(with-parameter) && $(without-parameter) - { - ECHO "error: both --with- and --without- specified" ; - EXIT ; - } - - local wrong = [ set.difference $(with-parameter) : $(existing-libraries) ] ; - if $(wrong) - { - ECHO "error: wrong library name '$(wrong[1])' in the --with- option." ; - EXIT ; - } - local wrong = [ set.difference $(without-parameter) : $(existing-libraries) ] ; - if $(wrong) - { - ECHO "error: wrong library name '$(wrong[1])' in the --without- option." ; - EXIT ; - } - - if $(with-parameter) - { - return [ set.intersection $(existing-libraries) : $(with-parameter) ] ; - } - else - { - return [ set.difference $(existing-libraries) : $(without-parameter) ] ; - } + use-project /boost/$(l) : libs/$(l)/build ; } - -# What kind of layout are we doing? -layout = [ option.get layout : "" ] ; -# On Windows, we used versioned layout by default in order to -# be compatible with autolink. On other systems, we use system -# layout which is what every other program uses. Note that windows -# check is static, and won't -if ! $(layout) -{ - if [ modules.peek : NT ] - { - layout = versioned ; - } - else - { - layout = system ; - } -} -layout-$(layout) = true ; - -if $(layout) = system && $(build-type) = complete -{ - ECHO "error: Cannot use --layout=system with --build-type complete." ; - ECHO "error: Please used either --layout=versioned or --layout=tagged " ; - ECHO "error: if you wish to build multiple variants." ; - if ! [ modules.peek : NT ] - { - ECHO "error: Note that --layout=system is default on Unix starting with Boost 1.40." ; - } - EXIT ; -} - -# Possible stage only location. -local stage-locate = [ MATCH "^--stagedir=(.*)" : [ modules.peek : ARGV ] ] ; -stage-locate ?= stage ; -path-constant BOOST_STAGE_LOCATE : $(stage-locate) ; - - -# Python location. -local python-root = [ MATCH "^--with-python-root=(.*)" : [ modules.peek : ARGV ] - ] ; -PYTHON_ROOT ?= $(python-root) ; - - -# Select the libraries to install. -libraries = [ libraries-to-install $(all-libraries) ] ; -configure.components-building $(libraries) ; - -if --show-libraries in [ modules.peek : ARGV ] -{ - ECHO "The following libraries require building:" ; - for local l in $(libraries) - { - ECHO " - $(l)" ; - } - EXIT ; -} - -# Custom build ID. -local build-id = [ MATCH "^--buildid=(.*)" : [ modules.peek : ARGV ] ] ; -if $(build-id) -{ - constant BUILD_ID : [ regex.replace $(build-id) "[*\\/:.\"\' ]" "_" ] ; -} - -# Python build id (only for Python libraries) -local python-id = [ MATCH "^--python-buildid=(.*)" : [ modules.peek : ARGV ] ] ; -if $(python-id) -{ - constant PYTHON_ID : [ regex.replace $(python-id) "[*\\/:.\"\']" "_" ] ; -} - -# This rule is called by Boost.Build to determine the name of target. We use it -# to encode the build variant, compiler name and boost version in the target -# name. -# -rule tag ( name : type ? : property-set ) -{ - if $(type) in STATIC_LIB SHARED_LIB IMPORT_LIB - { - local result ; - if $(layout) = versioned - { - result = [ common.format-name - -$(BOOST_VERSION_TAG) - -$(BUILD_ID) - : $(name) : $(type) : $(property-set) ] ; - } - else if $(layout) = tagged - { - result = [ common.format-name - - -$(BUILD_ID) - : $(name) : $(type) : $(property-set) ] ; - } - else if $(layout) = system - { - result = [ common.format-name - - -$(BUILD_ID) - : $(name) : $(type) : $(property-set) ] ; - } - else - { - ECHO "error: invalid layout '$(layout)'" ; - EXIT ; - } - - # Optionally add version suffix. On NT, library with version suffix - # will not be recognized by linkers. On CYGWIN, we get strage - # duplicate symbol errors when library is generated with version - # suffix. On OSX, version suffix is not needed -- the linker expects - # the libFoo.1.2.3.dylib format. AIX linkers do not accept version - # suffixes either. Pgi compilers can not accept library with version - # suffix. - if $(type) = SHARED_LIB && - ( ! ( [ $(property-set).get ] in windows cygwin darwin aix ) && - ! ( [ $(property-set).get ] in pgi ) ) - { - result = $(result).$(BOOST_VERSION) ; - } - - return $(result) ; - } -} - - -# Install to system location. - -install-requirements = $(BOOST_ROOT)/boost ; - -if $(layout-versioned) -{ - install-requirements += boost-$(BOOST_VERSION_TAG)/boost ; -} -else -{ - install-requirements += boost ; -} -if [ modules.peek : NT ] -{ - install-requirements += C:/Boost ; -} -else if [ modules.peek : UNIX ] -{ - install-requirements += /usr/local ; -} - -local headers = - # The .SUNWCCh files are present in tr1 include directory and have to be installed, - # see http://lists.boost.org/Archives/boost/2007/05/121430.php - [ path.glob-tree $(BOOST_ROOT)/boost : *.hpp *.ipp *.h *.inc *.SUNWCCh : CVS .svn ] - [ path.glob-tree $(BOOST_ROOT)/boost/compatibility/cpp_c_headers : c* : CVS .svn ] - [ path.glob boost/tr1/tr1 : * : bcc32 sun CVS .svn ] - ; - -# Complete install. -package.install install-proper - : $(install-requirements) on - : - : libs/$(libraries)/build - : $(headers) - ; -explicit install-proper ; - -# Install just library. -install stage-proper - : libs/$(libraries)/build - : $(stage-locate)/lib - on LIB - on - ; -explicit stage-proper ; - - -if $(layout-versioned) && ( [ modules.peek : NT ] || [ modules.peek : UNIX ] ) -{ - rule make-unversioned-links ( project name ? : property-set : sources * ) - { - local result ; - local filtered ; - local pattern ; - local nt = [ modules.peek : NT ] ; - - # Collect the libraries that have the version number in 'filtered'. - for local s in $(sources) - { - local m ; - if $(nt) - { - m = [ MATCH "(.*[.]lib)" : [ $(s).name ] ] ; - } - else - { - m = [ MATCH "(.*[.]so[.0-9]+)" "(.*[.]dylib)" "(.*[.]a)" : - [ $(s).name ] ] ; - } - if $(m) - { - filtered += $(s) ; - } - } - - # Create links without version. - for local s in $(filtered) - { - local name = [ $(s).name ] ; - local ea = [ $(s).action ] ; - local ep = [ $(ea).properties ] ; - local a = [ new non-scanning-action $(s) : symlink.ln : $(ep) ] ; - - local noversion-file ; - if $(nt) - { - noversion-file = [ MATCH "(.*)-[0-9_]+(.*[.]lib)" : $(name) ] ; - } - else - { - noversion-file = - [ MATCH "(.*)-[0-9_]+(.*[.]so)[.0-9]*" : $(name) ] - [ MATCH "(.*)-[0-9_]+(.*[.]dylib)" : $(name) ] - [ MATCH "(.*)-[0-9_]+(.*[.]a)" : $(name) ] - [ MATCH "(.*)-[0-9_]+(.*[.]dll[.]a)" : $(name) ] ; - } - - local new-name = - $(noversion-file[1])$(noversion-file[2]) ; - result += [ new file-target $(new-name) exact : [ $(s).type ] : $(project) - : $(a) ] ; - - } - return $(result) ; - } - - generate stage-unversioned : stage-proper : - @make-unversioned-links ; - explicit stage-unversioned ; - - generate install-unversioned : install-proper : - @make-unversioned-links ; - explicit install-unversioned ; -} -else -{ - # Create do-nothing aliases. - alias stage-unversioned ; - explicit stage-unversioned ; - alias install-unversioned ; - explicit install-unversioned ; -} - -# This is a special metatarget class that handles the --build-type=complete -# option. -class top-level-target : alias-target-class -{ - import modules ; - import errors ; - - rule __init__ ( name : project : sources * : requirements * - : default-build * : usage-requirements * ) - { - alias-target-class.__init__ $(name) : $(project) : $(sources) : - $(requirements) : $(default-build) : $(usage-requirements) ; - - local m = [ $(project).project-module ] ; - self.build-type = [ modules.peek $(m) : build-type ] ; - # On Linux, we build release variant by default, since few users will - # ever want to debug C++ Boost libraries, and there's no ABI - # incompatibility between debug and release variants. We build - # shared and static libraries since that's what most packages - # seem to provide (.so in libfoo and .a in libfoo-dev). - self.minimal-properties = [ property-set.create - release multi shared static shared ] ; - # On Windows, new IDE projects use: - # - # runtime-link=dynamic, threading=multi, variant=(debug|release) - # - # and in addition, C++ Boost's autolink defaults to static linking. - self.minimal-properties-win = [ property-set.create - debug release multi static shared ] ; - - self.complete-properties = [ property-set.create - debug release - single multi - shared static - shared static ] ; - } - - rule generate ( property-set ) - { - local x = [ modules.peek : top-level-targets ] ; - x += $(self.name) ; - modules.poke : top-level-targets : $(x) ; - if $(self.build-type) = minimal - { - local expanded ; - - local os = [ $(property-set).get ] ; - # Because we completely override parent's 'generate' - # we need to check for default value of feature ourself. - if ! $(os) - { - os = [ feature.defaults ] ; - os = $(os:G=) ; - } - - if $(os) = windows - { - expanded = [ targets.apply-default-build $(property-set) - : $(self.minimal-properties-win) ] ; - } - else - { - expanded = [ targets.apply-default-build $(property-set) - : $(self.minimal-properties) ] ; - } - return [ build-multiple $(expanded) ] ; - } - else if $(self.build-type) = complete - { - local expanded = [ targets.apply-default-build $(property-set) - : $(self.complete-properties) ] ; - - # Filter inappopriate combinations - local filtered ; - for local p in $(expanded) - { - # See comment in handle-static-runtime regarding this logic. - if [ $(p).get ] = shared && [ $(p).get ] = static - && [ $(p).get ] != cw - { - # Skip this - } - else - { - filtered += $(p) ; - } - } - return [ build-multiple $(filtered) ] ; - } - else - { - errors.error "Unknown build type" ; - } - } - - rule build-multiple ( property-sets * ) - { - local usage-requirements = [ property-set.empty ] ; - local result ; - for local p in $(property-sets) - { - local r = [ alias-target-class.generate $(p) ] ; - if $(r) - { - usage-requirements = [ $(usage-requirements).add $(r[1]) ] ; - result += $(r[2-]) ; - } - } - return $(usage-requirements) [ sequence.unique $(result) ] ; - } - -} - -targets.create-metatarget top-level-target : [ project.current ] - : install - : install-proper install-unversioned - ; -targets.create-metatarget top-level-target : [ project.current ] - : stage - : stage-proper stage-unversioned - ; - -explicit install ; -explicit stage ; - -stage-abs = [ path.native [ path.root $(stage-locate)/lib [ path.pwd ] ] ] ; - -# This target is built by default, and will forward to 'stage' -# after producing some explanations. -targets.create-metatarget top-level-target : [ project.current ] - : forward - : explain stage - ; - - -message explain : -"\nBuilding the Boost C++ Libraries.\n\n" ; -explicit explain ; - -rule pre-build ( ) -{ - local tl = [ modules.peek : top-level-targets ] ; - if stage in $(tl) || install in $(tl) - { - # FIXME: remove if when Boost regression tests use trunk - # bjam. - if PAD in [ RULENAMES ] - { - configure.print-component-configuration ; - } - } -} -IMPORT $(__name__) : pre-build : : $(__name__).pre-build ; -build-system.set-pre-build-hook $(__name__).pre-build ; - -rule post-build ( ok ? ) -{ - if forward in [ modules.peek : top-level-targets ] - { - if $(ok) - { - ECHO -"\n\nThe Boost C++ Libraries were successfully built! - -The following directory should be added to compiler include paths: - - $(BOOST_ROOT) - -The following directory should be added to linker library paths: - - $(stage-abs) -" ; - } - } -} -IMPORT $(__name__) : post-build : : $(__name__).post-build ; -build-system.set-post-build-hook $(__name__).post-build ; - # This rule should be called from libraries' Jamfiles and will create two # targets, "install" and "stage", that will install or stage that library. The # --prefix option is respected, but --with and --without options, naturally, are @@ -749,9 +251,14 @@ rule boost-install ( libraries * ) } } +headers = + # The .SUNWCCh files are present in tr1 include directory and have to be installed, + # see http://lists.boost.org/Archives/boost/2007/05/121430.php + [ path.glob-tree $(BOOST_ROOT)/boost : *.hpp *.ipp *.h *.inc *.SUNWCCh : CVS .svn ] + [ path.glob-tree $(BOOST_ROOT)/boost/compatibility/cpp_c_headers : c* : CVS .svn ] + [ path.glob boost/tr1/tr1 : * : bcc32 sun CVS .svn ] + ; -# Make project ids of all libraries known. -for local l in $(all-libraries) -{ - use-project /boost/$(l) : libs/$(l)/build ; -} +# Declare special top-level targets that build and install the desired variants +# of the libraries. +boostcpp.declare_targets $(all-libraries) : $(headers) ; diff --git a/boostcpp.jam b/boostcpp.jam new file mode 100644 index 0000000000..bf1b3bffdf --- /dev/null +++ b/boostcpp.jam @@ -0,0 +1,574 @@ +# Boost.Build support specific for the Boost C++ Libraries. +# Copyright Vladimir Prus 2002-2010. +# Copyright Dave Abrahams 2005-2006. +# Copyright Rene Rivera 2005-2007. +# Copyright Douglas Gregor 2005. +# +# 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) + +import option ; +import regex ; +import common ; + +import modules ; +import os ; +import path ; +import build-system ; +import configure ; +import set ; +import package ; +import project ; +import targets ; +import generate ; +import package ; + +############################################################################## +# +# 0. General setup. Parse options, check them. +# +############################################################################## + +BOOST_ROOT = [ modules.binding $(__name__) ] ; + +rule set-version ( version ) +{ + BOOST_VERSION = $(version) ; + + local version-tag = [ MATCH "^([^.]+)[.]([^.]+)[.]([^.]+)" : $(BOOST_VERSION) ] + ; + if $(version-tag[3]) = 0 + { + version-tag = $(version-tag[1-2]) ; + } + + BOOST_VERSION_TAG = $(version-tag:J="_") ; +} + +# Option to choose how many variants to build. The default is "minimal". +build-type = [ option.get "build-type" ] ; +build-type ?= minimal ; +if ! ( $(build-type) in minimal complete ) +{ + ECHO "The value of the --build-type option should be either 'complete' or 'minimal'" ; + EXIT ; +} + +# What kind of layout are we doing? +layout = [ option.get layout : "" ] ; +# On Windows, we used versioned layout by default in order to +# be compatible with autolink. On other systems, we use system +# layout which is what every other program uses. Note that windows +# check is static, and won't +if ! $(layout) +{ + if [ os.name ] = NT + { + layout = versioned ; + } + else + { + layout = system ; + } +} +layout-$(layout) = true ; + +if $(layout) = system && $(build-type) = complete +{ + ECHO "error: Cannot use --layout=system with --build-type complete." ; + ECHO "error: Please used either --layout=versioned or --layout=tagged " ; + ECHO "error: if you wish to build multiple variants." ; + if ! [ os.name ] = NT + { + ECHO "error: Note that --layout=system is default on Unix starting with Boost 1.40." ; + } + EXIT ; +} + +# Possible stage only location. +stage-locate = [ option.get "stagedir" ] ; +stage-locate ?= stage ; +BOOST_STAGE_LOCATE = $(stage-locate) ; + +# Custom build ID. +build-id = [ option.get "buildid" ] ; +if $(build-id) +{ + BUILD_ID = [ regex.replace $(build-id) "[*\\/:.\"\' ]" "_" ] ; +} + +# Python build id (only for Python libraries) +python-id = [ option.get "python-buildid" ] ; +if $(python-id) +{ + PYTHON_ID = [ regex.replace $(python-id) "[*\\/:.\"\']" "_" ] ; +} + +############################################################################## +# +# 1. The 'tag' function that adds decoration suitable to the properties if +# versioned or tagged layout is requested. This function is called from +# Jamroot +# +############################################################################## + +rule tag ( name : type ? : property-set ) +{ + if $(type) in STATIC_LIB SHARED_LIB IMPORT_LIB + { + local result ; + if $(layout) = versioned + { + result = [ common.format-name + -$(BOOST_VERSION_TAG) + -$(BUILD_ID) + : $(name) : $(type) : $(property-set) ] ; + } + else if $(layout) = tagged + { + result = [ common.format-name + + -$(BUILD_ID) + : $(name) : $(type) : $(property-set) ] ; + } + else if $(layout) = system + { + result = [ common.format-name + + -$(BUILD_ID) + : $(name) : $(type) : $(property-set) ] ; + } + else + { + ECHO "error: invalid layout '$(layout:E=)'" ; + EXIT ; + } + + # Optionally add version suffix. On NT, library with version suffix + # will not be recognized by linkers. On CYGWIN, we get strage + # duplicate symbol errors when library is generated with version + # suffix. On OSX, version suffix is not needed -- the linker expects + # the libFoo.1.2.3.dylib format. AIX linkers do not accept version + # suffixes either. Pgi compilers can not accept library with version + # suffix. + if $(type) = SHARED_LIB && + ( ! ( [ $(property-set).get ] in windows cygwin darwin aix ) && + ! ( [ $(property-set).get ] in pgi ) ) + { + result = $(result).$(BOOST_VERSION) ; + } + + return $(result) ; + } +} + +############################################################################## +# +# 2. Declare targets that build and install all libraries. Specifically: +# +# - 'stage-proper' that puts all libraries in stage/lib +# - 'install-proper' that install libraries and headers to system location +# - 'stage-unversioned' that creates links to libraries without boost veriosn +# in name +# - 'install-unversioned' which creates unversioned linked to installed +# libraries. +# +############################################################################## + +# Worker function suitable to the 'generate' metatarget. Creates a link +# to 'source', striping any version number from the name. +rule make-unversioned-links ( project name ? : property-set : sources * ) +{ + local result ; + local filtered ; + local pattern ; + local nt = [ modules.peek : NT ] ; + + # Collect the libraries that have the version number in 'filtered'. + for local s in $(sources) + { + local m ; + if $(nt) + { + m = [ MATCH "(.*[.]lib)" : [ $(s).name ] ] ; + } + else + { + m = [ MATCH "(.*[.]so[.0-9]+)" "(.*[.]dylib)" "(.*[.]a)" : + [ $(s).name ] ] ; + } + if $(m) + { + filtered += $(s) ; + } + } + + # Create links without version. + for local s in $(filtered) + { + local name = [ $(s).name ] ; + local ea = [ $(s).action ] ; + local ep = [ $(ea).properties ] ; + local a = [ new non-scanning-action $(s) : symlink.ln : $(ep) ] ; + + local noversion-file ; + if $(nt) + { + noversion-file = [ MATCH "(.*)-[0-9_]+(.*[.]lib)" : $(name) ] ; + } + else + { + noversion-file = + [ MATCH "(.*)-[0-9_]+(.*[.]so)[.0-9]*" : $(name) ] + [ MATCH "(.*)-[0-9_]+(.*[.]dylib)" : $(name) ] + [ MATCH "(.*)-[0-9_]+(.*[.]a)" : $(name) ] + [ MATCH "(.*)-[0-9_]+(.*[.]dll[.]a)" : $(name) ] ; + } + + local new-name = + $(noversion-file[1])$(noversion-file[2]) ; + result += [ new file-target $(new-name) exact : [ $(s).type ] : $(project) + : $(a) ] ; + + } + return $(result) ; +} + +rule declare_install_and_stage_proper_targets ( libraries * : headers * ) +{ + install-requirements = $(BOOST_ROOT)/boost ; + + if $(layout-versioned) + { + install-requirements += boost-$(BOOST_VERSION_TAG)/boost ; + } + else + { + install-requirements += boost ; + } + + if [ os.name ] = NT + { + install-requirements += C:/Boost ; + } + else + { + install-requirements += /usr/local ; + } + + p = [ project.current ] ; + + # Complete install. + package.install install-proper + : $(install-requirements) on + : + : libs/$(libraries)/build + : $(headers) + ; + + $(p).mark-target-as-explicit install-proper ; + + # Install just library. + install stage-proper + : libs/$(libraries)/build + : $(stage-locate)/lib + on LIB + on + ; + $(p).mark-target-as-explicit stage-proper ; + + if $(layout-versioned) && ( [ modules.peek : NT ] || [ modules.peek : UNIX ] ) + { + generate stage-unversioned : stage-proper : + boostcpp.make-unversioned-links ; + $(p).mark-target-as-explicit stage-unversioned ; + + generate install-unversioned : install-proper : + boostcpp.make-unversioned-links ; + $(p).mark-target-as-explicit explicit install-unversioned ; + } + else + { + # Create do-nothing aliases. + alias stage-unversioned ; + $(p).mark-target-as-explicit stage-unversioned ; + alias install-unversioned ; + $(p).mark-target-as-explicit install-unversioned ; + } +} + +############################################################################## +# +# 3. Declare top-level targets 'stage' and 'install'. These examine +# the --build-type option and, in case it's 'complete', build the +# 'install-proper' and 'stage-proper' targets with a number of +# property sets. +# +############################################################################## + +class top-level-target : alias-target-class +{ + import modules ; + import errors ; + + rule __init__ ( name : project : sources * : requirements * + : default-build * : usage-requirements * ) + { + alias-target-class.__init__ $(name) : $(project) : $(sources) : + $(requirements) : $(default-build) : $(usage-requirements) ; + + self.build-type = [ modules.peek boostcpp : build-type ] ; + # On Linux, we build release variant by default, since few users will + # ever want to debug C++ Boost libraries, and there's no ABI + # incompatibility between debug and release variants. We build + # shared and static libraries since that's what most packages + # seem to provide (.so in libfoo and .a in libfoo-dev). + self.minimal-properties = [ property-set.create + release multi shared static shared ] ; + # On Windows, new IDE projects use: + # + # runtime-link=dynamic, threading=multi, variant=(debug|release) + # + # and in addition, C++ Boost's autolink defaults to static linking. + self.minimal-properties-win = [ property-set.create + debug release multi static shared ] ; + + self.complete-properties = [ property-set.create + debug release + single multi + shared static + shared static ] ; + } + + rule generate ( property-set ) + { + local x = [ modules.peek : top-level-targets ] ; + x += $(self.name) ; + modules.poke : top-level-targets : $(x) ; + if $(self.build-type) = minimal + { + local expanded ; + + local os = [ $(property-set).get ] ; + # Because we completely override parent's 'generate' + # we need to check for default value of feature ourself. + if ! $(os) + { + os = [ feature.defaults ] ; + os = $(os:G=) ; + } + + if $(os) = windows + { + expanded = [ targets.apply-default-build $(property-set) + : $(self.minimal-properties-win) ] ; + } + else + { + expanded = [ targets.apply-default-build $(property-set) + : $(self.minimal-properties) ] ; + } + return [ build-multiple $(expanded) ] ; + } + else if $(self.build-type) = complete + { + local expanded = [ targets.apply-default-build $(property-set) + : $(self.complete-properties) ] ; + + # Filter inappopriate combinations + local filtered ; + for local p in $(expanded) + { + # See comment in handle-static-runtime regarding this logic. + if [ $(p).get ] = shared && [ $(p).get ] = static + && [ $(p).get ] != cw + { + # Skip this + } + else + { + filtered += $(p) ; + } + } + return [ build-multiple $(filtered) ] ; + } + else + { + errors.error "Unknown build type" ; + } + } + + rule build-multiple ( property-sets * ) + { + local usage-requirements = [ property-set.empty ] ; + local result ; + for local p in $(property-sets) + { + local r = [ alias-target-class.generate $(p) ] ; + if $(r) + { + usage-requirements = [ $(usage-requirements).add $(r[1]) ] ; + result += $(r[2-]) ; + } + } + return $(usage-requirements) [ sequence.unique $(result) ] ; + } +} + +rule declare_top_level_targets ( libraries * : headers * ) +{ + declare_install_and_stage_proper_targets $(libraries) : $(headers) ; + + targets.create-metatarget top-level-target : [ project.current ] + : install + : install-proper install-unversioned + ; + targets.create-metatarget top-level-target : [ project.current ] + : stage + : stage-proper stage-unversioned + ; + + p = [ project.current ] ; + $(p).mark-target-as-explicit install stage ; + + # This target is built by default, and will forward to 'stage' + # after producing some explanations. + targets.create-metatarget top-level-target : [ project.current ] + : forward + : explain stage + ; +} + + +stage-abs = [ path.native [ path.root $(stage-locate)/lib [ path.pwd ] ] ] ; + +############################################################################## +# +# 4. Add hook to report configuration before the build, and confirmation +# with setup instructions after the build +# +############################################################################## + +message explain : +"\nBuilding the Boost C++ Libraries.\n\n" ; +p = [ project.current ] ; +$(p).mark-target-as-explicit explain ; + +rule pre-build ( ) +{ + local tl = [ modules.peek : top-level-targets ] ; + if stage in $(tl) || install in $(tl) + { + # FIXME: remove if when Boost regression tests use trunk + # bjam. + if PAD in [ RULENAMES ] + { + configure.print-component-configuration ; + } + } +} +IMPORT $(__name__) : pre-build : : $(__name__).pre-build ; +build-system.set-pre-build-hook $(__name__).pre-build ; + +# FIXME: revive stage_abs +rule post-build ( ok ? ) +{ + if forward in [ modules.peek : top-level-targets ] + { + if $(ok) + { + ECHO +"\n\nThe Boost C++ Libraries were successfully built! + +The following directory should be added to compiler include paths: + + $(BOOST_ROOT) + +The following directory should be added to linker library paths: + + $(stage-abs) +" ; + } + } +} +IMPORT $(__name__) : post-build : : $(__name__).post-build ; +build-system.set-post-build-hook $(__name__).post-build ; + + +############################################################################## +# +# 5. Top-level setup +# +############################################################################## + + +# Decides which libraries are to be installed by looking at --with- +# --without- arguments. Returns the list of directories under "libs" +# which must be built and installed. +# +rule libraries-to-install ( existing-libraries * ) +{ + local argv = [ modules.peek : ARGV ] ; + local with-parameter = [ MATCH --with-(.*) : $(argv) ] ; + local without-parameter = [ MATCH --without-(.*) : $(argv) ] ; + + if ! $(with-parameter) && ! $(without-parameter) + { + # Nothing is specified on command line. See if maybe + # project-config.jam has some choices. + local project-config-libs = [ modules.peek project-config : libraries ] ; + with-parameter = [ MATCH --with-(.*) : $(project-config-libs) ] ; + without-parameter = [ MATCH --without-(.*) : $(project-config-libs) ] ; + } + + # Do some checks. + if $(with-parameter) && $(without-parameter) + { + ECHO "error: both --with- and --without- specified" ; + EXIT ; + } + + local wrong = [ set.difference $(with-parameter) : $(existing-libraries) ] ; + if $(wrong) + { + ECHO "error: wrong library name '$(wrong[1])' in the --with- option." ; + EXIT ; + } + local wrong = [ set.difference $(without-parameter) : $(existing-libraries) ] ; + if $(wrong) + { + ECHO "error: wrong library name '$(wrong[1])' in the --without- option." ; + EXIT ; + } + + if $(with-parameter) + { + return [ set.intersection $(existing-libraries) : $(with-parameter) ] ; + } + else + { + return [ set.difference $(existing-libraries) : $(without-parameter) ] ; + } +} + +rule declare_targets ( all-libraries * : headers * ) +{ + configure.register-components $(all-libraries) ; + + # Select the libraries to install. + libraries = [ libraries-to-install $(all-libraries) ] ; + configure.components-building $(libraries) ; + + if [ option.get "show-libraries" : : true ] + { + ECHO "The following libraries require building:" ; + for local l in $(libraries) + { + ECHO " - $(l)" ; + } + EXIT ; + } + + declare_top_level_targets $(libraries) : $(headers) ; +}