aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2022-12-21 09:55:26 -0800
committerEli Schwartz <eschwartz93@gmail.com>2023-02-15 22:58:50 -0500
commit3589815eb9dd8402deabedcd4492f33e04870c56 (patch)
treea039f474889d4be7b639dfacabb5d0b1163d80e4 /docs/yaml
parenta3098fbfa32ae4ff654f0da45bcfcd9aa7893b5f (diff)
downloadmeson-3589815eb9dd8402deabedcd4492f33e04870c56.zip
meson-3589815eb9dd8402deabedcd4492f33e04870c56.tar.gz
meson-3589815eb9dd8402deabedcd4492f33e04870c56.tar.bz2
interpreter: add a feature.enable_auto_if
It's always been strange to me we don't have an opposite method of the `disable_auto_if` method, but I've been pressed to find a case where we _need_ one, because `disable_auto_if` can't be logically contorted to work. I finally found the case where they're not equivalent: when you don't want to convert to a boolean: ```meson f = get_option('feat').disable_auto_if(not foo) g = get_option('feat').enable_auto_if(foo) dep1 = dependency('foo', required : f) dep2 = dependency('foo', required : g) ```
Diffstat (limited to 'docs/yaml')
-rw-r--r--docs/yaml/objects/feature.yaml17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/yaml/objects/feature.yaml b/docs/yaml/objects/feature.yaml
index b6a754b..01209eb 100644
--- a/docs/yaml/objects/feature.yaml
+++ b/docs/yaml/objects/feature.yaml
@@ -38,6 +38,23 @@ methods:
type: bool
description: See the table above
+- name: enable_auto_if
+ since: 1.1.0
+ returns: feature
+ description: |
+ Returns the feature, with `'auto'` converted to `'enabled'` if value is true.
+
+ | Feature / Condition | `value = true` | `value = false` |
+ | ------------------- | -------------- | --------------- |
+ | Enabled | Enabled | Enabled |
+ | Disabled | Disabled | Disabled |
+ | Auto | Enabled | Auto |
+
+ posargs:
+ value:
+ type: bool
+ description: See the table above
+
- name: require
returns: feature
since: 0.59.0