aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2018-01-02 22:25:24 +0200
committerJussi Pakkanen <jpakkane@gmail.com>2018-02-08 00:33:44 +0200
commit54d78170876e7b762aa3452faa44ec1b7cd44372 (patch)
tree7c65bb478818a90fa3d3991da4c6ca8b2c641eb2 /docs/markdown/snippets
parent0204895143d4aacf143be952f962dc47e415c187 (diff)
downloadmeson-54d78170876e7b762aa3452faa44ec1b7cd44372.zip
meson-54d78170876e7b762aa3452faa44ec1b7cd44372.tar.gz
meson-54d78170876e7b762aa3452faa44ec1b7cd44372.tar.bz2
User options can "yield to" a user option of the same name in superproject. Closes ##2853.
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/yield.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/markdown/snippets/yield.md b/docs/markdown/snippets/yield.md
new file mode 100644
index 0000000..3880e67
--- /dev/null
+++ b/docs/markdown/snippets/yield.md
@@ -0,0 +1,8 @@
+## Yielding subproject option to superproject
+
+Normally project options are specific to the current project. However
+sometimes you want to have an option whose value is the same over all
+projects. This can be achieved with the new `yield` keyword for
+options. When set to `true`, getting the value of this option in
+`meson.build` files gets the value from the option with the same name
+in the master project (if such an option exists).