summaryrefslogtreecommitdiff
path: root/doc/concepts
diff options
context:
space:
mode:
authorKlaus Aehlig <klaus.aehlig@huawei.com>2022-11-15 17:13:38 +0100
committerKlaus Aehlig <klaus.aehlig@huawei.com>2022-11-16 15:09:05 +0100
commitc3b10ee7c9320ed6cf5daec6310b0296812ea86a (patch)
tree1ea7b015ea9cc2a30fb896f689b4ea5da0e41cc0 /doc/concepts
parent7027ce395a7aa835dd261fce0a554265c9753006 (diff)
downloadjustbuild-c3b10ee7c9320ed6cf5daec6310b0296812ea86a.tar.gz
Make "config" accept a computed target
... and thus allowing the "business logic" in the configuration target (e.g., setting defaults and derived options) to be shared by many targets.
Diffstat (limited to 'doc/concepts')
-rw-r--r--doc/concepts/built-in-rules.org9
1 files changed, 5 insertions, 4 deletions
diff --git a/doc/concepts/built-in-rules.org b/doc/concepts/built-in-rules.org
index 0da0297f..28784193 100644
--- a/doc/concepts/built-in-rules.org
+++ b/doc/concepts/built-in-rules.org
@@ -125,10 +125,11 @@ map is empty.
** ~"configure"~
-The ~"configure"~ rule allows to configure a target with a given configuration.
-Similar to the ~"export"~ rule, the field ~"target"~ must name a single target
-(not a list). The ~"config"~ field is evaluated and must result in a map, which
-is used as configuration for the given target.
+The ~"configure"~ rule allows to configure a target with a given
+configuration. The field ~"target"~ is evaluated and the result
+of the evaluation must name a single target (not a list). The
+~"config"~ field is evaluated and must result in a map, which is
+used as configuration for the given target.
This rule uses the given configuration to overlay the current environment for
evaluating the given target, and thereby performs a configuration transition. It