2
0
mirror of https://github.com/boostorg/build.git synced 2026-02-12 12:02:24 +00:00

Clarify restrictions and role of dashes in values of features (#317)

This commit is contained in:
Mateusz Loskot
2018-06-21 16:01:17 +02:00
committed by Rene Rivera
parent 13cc13b821
commit 71f02a509c

View File

@@ -1301,8 +1301,9 @@ not contain the '`>`' character.
Each feature in a build configuration has one or more associated
__value__s. Feature values for non-free features may not contain the
'`<`', '`:`', or '`=`' characters. Feature values for free features may
not contain the '`<`' character.
punctuation characters of pointy bracket (`<`), colon (`:` ),
equal sign (`=`) and dashes (`-`). Feature values for free
features may not contain the pointy bracket (`<`) character.
A _property_ is a (feature,value) pair, expressed as <feature>value.
@@ -1315,9 +1316,9 @@ hierarchy.
A _value-string_ for a feature *F* is a string of the form
`value-subvalue1-subvalue2`...`-subvalueN`, where `value` is a legal
value for *F* and `subvalue1`...`subvalueN` are legal values of some of
*F*'s subfeatures. For example, the properties
`<toolset>gcc <toolset-version>3.0.1` can be expressed more concisely
using a value-string, as `<toolset>gcc-3.0.1`.
*F*'s subfeatures separated with dashes (`-`).
For example, the properties `<toolset>gcc <toolset-version>3.0.1` can
be expressed more concisely using a value-string, as `<toolset>gcc-3.0.1`.
A _property set_ is a set of properties (i.e. a collection without
duplicates), for instance: `<toolset>gcc <runtime-link>static`.