From feee18e0f99d086439f2c552ef6c7bece374cc17 Mon Sep 17 00:00:00 2001 From: Vladimir Prus Date: Wed, 14 May 2003 09:24:29 +0000 Subject: [PATCH] Document the 'variant' feature. Eventually, we need to document all builtin features; I'm doing that for 'variant' since I was changing it recently. [SVN r18393] --- boost_build_v2.html | 68 ++++++++++++++++++++++++++++++++---------- v2/boost_build_v2.html | 68 ++++++++++++++++++++++++++++++++---------- 2 files changed, 106 insertions(+), 30 deletions(-) diff --git a/boost_build_v2.html b/boost_build_v2.html index fa9eb4fe8..c94a0a00d 100644 --- a/boost_build_v2.html +++ b/boost_build_v2.html @@ -22,12 +22,12 @@ div.alert { color: red } table { align: center; border: thin; } - + + - build request, build request expansion and directly requested targets + - conditional properties + -->

Overview
+
Builtin facilities
+ +
+
+
Features
+
+
+
Features and properties
@@ -130,12 +138,12 @@ bjam there. A simple application will be built. You can also play with other projects in examples-v2. + it somewhere. + +

It is slighly better way is to copy new/user-config.jam + into one of the locations where it can be found (given in this table). This prevent you from + accidentally overwriting your config when updating.

--> @@ -628,6 +636,36 @@ boost-build /path/to/boost.build ; date. At this step, implicit dependencies are also scanned and accounted for, as described here.

+

Builtin facilities

+ +

Features

+ +
+
variant
+ +
+ The feature which combines several low-level features in order to + make building most common variants simple. + +

Allowed values: debug, release

+ +

The value on expands to

+
+    <optimization>off <debug-symbols>on <inlining>off <runtime-debugging>on
+   
+
+ +

The value off expands to

+
+<optimization>speed <debug-symbols>off <inlining>full <runtime-debugging>off
+
+ +

Rationale: Runtime debugging is on in debug build so suit + expectations of people used various IDEs. It's assumed other folks + don't have any specific expectation in this point.

+
+
+

Features and properties

Definitions

@@ -1693,11 +1731,11 @@ borland/runtime-link=static,dynamic

Last modified: Apr 25, 2003

-

© Copyright Vladimir Prus 2002-2003. Permission to copy, use, modify, - sell and distribute this document is granted provided this copyright - notice appears in all copies. This document is provided ``as is'' without - express or implied warranty, and with no claim as to its suitability for - any purpose.

+

© Copyright Vladimir Prus 2002-2003. Permission to copy, use, + modify, sell and distribute this document is granted provided this + copyright notice appears in all copies. This document is provided ``as + is'' without express or implied warranty, and with no claim as to its + suitability for any purpose.

diff --git a/v2/boost_build_v2.html b/v2/boost_build_v2.html index fa9eb4fe8..c94a0a00d 100644 --- a/v2/boost_build_v2.html +++ b/v2/boost_build_v2.html @@ -22,12 +22,12 @@ div.alert { color: red } table { align: center; border: thin; } - + + - build request, build request expansion and directly requested targets + - conditional properties + -->

Overview
+
Builtin facilities
+ +
+
+
Features
+
+
+
Features and properties
@@ -130,12 +138,12 @@ bjam there. A simple application will be built. You can also play with other projects in examples-v2. + it somewhere. + +

It is slighly better way is to copy new/user-config.jam + into one of the locations where it can be found (given in this table). This prevent you from + accidentally overwriting your config when updating.

--> @@ -628,6 +636,36 @@ boost-build /path/to/boost.build ; date. At this step, implicit dependencies are also scanned and accounted for, as described here.

+

Builtin facilities

+ +

Features

+ +
+
variant
+ +
+ The feature which combines several low-level features in order to + make building most common variants simple. + +

Allowed values: debug, release

+ +

The value on expands to

+
+    <optimization>off <debug-symbols>on <inlining>off <runtime-debugging>on
+   
+
+ +

The value off expands to

+
+<optimization>speed <debug-symbols>off <inlining>full <runtime-debugging>off
+
+ +

Rationale: Runtime debugging is on in debug build so suit + expectations of people used various IDEs. It's assumed other folks + don't have any specific expectation in this point.

+
+
+

Features and properties

Definitions

@@ -1693,11 +1731,11 @@ borland/runtime-link=static,dynamic

Last modified: Apr 25, 2003

-

© Copyright Vladimir Prus 2002-2003. Permission to copy, use, modify, - sell and distribute this document is granted provided this copyright - notice appears in all copies. This document is provided ``as is'' without - express or implied warranty, and with no claim as to its suitability for - any purpose.

+

© Copyright Vladimir Prus 2002-2003. Permission to copy, use, + modify, sell and distribute this document is granted provided this + copyright notice appears in all copies. This document is provided ``as + is'' without express or implied warranty, and with no claim as to its + suitability for any purpose.