From bd35768f727bd720b48b137105bca64c9ddf0894 Mon Sep 17 00:00:00 2001 From: Rene Rivera Date: Mon, 17 Nov 2003 16:18:48 +0000 Subject: [PATCH] Add documentation for: * Requirement Rules; std::locale-support, std::facet-support, and common-variant-tag * Install Descriptions; install, install-subinclude, and install-source. [SVN r20824] --- v1/build_system.htm | 133 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 131 insertions(+), 2 deletions(-) diff --git a/v1/build_system.htm b/v1/build_system.htm index 82db36f30..83e86c9e8 100644 --- a/v1/build_system.htm +++ b/v1/build_system.htm @@ -145,6 +145,10 @@
  • Using External Projects
    • +
  • Requirement Rules
    • + +
  • Install Descriptions
    • +
  • Feature Descriptions
  • Variant Descriptions
    • @@ -1068,6 +1072,131 @@ project boost : /home/dave/boost-cvs ; in your target's list of sources. +

    Requirement Rules

    + +

    Target requirements support the use of auxiliary rules to allow for more + complex descitions about the requirements. If specified, by using the name + of a rule in the requirements, the rule is called with the signature: ( + toolset variant : subvariant-path properties * ) and should return the + modified set of properties. There are a number of built-in rules for some + common tasks that Boost uses, and you can use:

    + +
    + + + + + + + + + + + + + + + + + + + + + + + + +
    RuleEffects
    std::locale-supportEnsures that locale support is available for the target. For + example some toolsets, like CodeWarrior, locale support is only + available on specific platforms using a static runtime.
    std::facet-supportEnsures that facet support is available for the target.
    common-variant-tag +

    Adds a constructed prefix tag to the target to conform to the + Boost common naming conventions for libraries. The tag is + constructed as:

    + +
    + [-<toolset-tag>][-<thread-tag>][-<runtime-tag>][-<version-tag>] +
    + +
      +
    • <toolset-tag> maps to an abbreviated name of the + toolset and when possible, and applicable, the version of the + toolset.
      • + +
    • <thread-tag> "mt" when multi-threading is enabled.
      • + +
    • <runtime-tag> adds these single letter tags:
      +   "s" when static linking to runtime
      +   "g" when linking to debug runtime
      +   "y" when building debug-python variants
      +   "d" when building debug variants
      +   "p" when building with stlport libraries
      +   "n" when building with stlport and using native + iostreams
      • + +
    • <version-tag> adds "major_minor" from a + <version> property. Defaults to using + $(BOOST_VERSION) if no version property is present.
      • +
    +
    +
    + +

    Install Descriptions

    + +

    Installable files and tergets are described with:

    + +
    + 
    +install name type : sources... : [options]... ;
+
    +
    + +

    Install descriptions define files and targets that can be installed by + use of a stage target.

    + + + +

    Install descriptions are meant to be used by stage targets to + collect the various sources of many install descriptions into one or more + destination directories. For this there are two rules that help in getting + the sources specified:

    + + +

    Feature Descriptions

    Features are described by stating the feature type (simple features are @@ -1410,9 +1539,9 @@ flags msvc HDRS <include> ;

    Revised 8 September, 2003 + -->8 September, 2003

    + -->

    Copyright © Dave Abrahams 2001.