Changes between Version 8 and Version 9 of BuildSystem

Timestamp:

Oct 29, 2009, 4:56:46 PM (15 years ago)

Author:

becoulet

Comment:

--

BuildSystem

@@ -121 +121 @@
  `desc Description string without quotes`::
    Short description about the token
+ `default value`::
+   Set the token default value. `defined` and `undefined` values act as booleans.
  `parent TOKEN`::
-   Parent token is help screen. This is only for pretty-printing.
+   Parent token in help screen. This is only for pretty-printing and allow hidding unrelevant tokens if the parent token is undefined.
  `require TOKEN […]`::
-   Mandatory requirements, having at least one of the tokens on the line is mandatory, conflict yields error
+   Mandatory requirements, having at least one of the tokens on the line is mandatory, conflict yields error. May be usd to enforce definition of some mandatory configuration values.
  `depend TOKEN […]`::
-   Dependencies, having at least one of the tokens on the line is mandatory, conflict implicitly undefines the current token
+   Dependencies, having at least one of the tokens on the line is mandatory, conflict implicitly undefines the current token. May be used to disable features because of missing prerequisites.
  `provide TOKEN […]`::
-   Mandatory forced requirements, given tokens are defined, conflict yields an error
+   Defining the current token enforce definition of the specified token.
  `provide TOKEN=value`::
-   Mandatory forced requirements variant, sets a configuration token to a given value; value must not be `undefined`
+   Defining the current token enforce definition of the specified token with the given value.
  `provide TOKEN=+value`::
-   Mandatory forced requirements variant, adds a value to a configuration token
+   Defining the current token enforce definition of the specified token and concat the given value.
  `exclude TOKEN`::
-   Mandatory unrequirements, the specified token must not be defined
+   Mandatory excluded tokens, the specified token must not be defined
  `suggest TOKEN […]`::
-   Makes a token suggest other tokens when it is used. This is for help listing.
+   Makes a token suggest other tokens when it is defined. This is for help listing.
  `single TOKEN […]`::
-   Require a single one of the following tokens
+   Only one of the following tokens may be defined at the same time
+ `fallback TOKEN`::
+   The fallback token will be enabled if the current one may not be enabled
+
+The configuration tool may use multiple pass to find a valid configuration when tokens are disabled or enforced by given rules.
 
 Example:
@@ -149 +155 @@
 require CONFIG_SRL_SOCLIB CONFIG_SRL_STD
 single CONFIG_SRL_SOCLIB CONFIG_SRL_STD
+default undefined
 %config end
 }}}