aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2020-02-06 09:10:01 -0800
committerDylan Baker <dylan@pnwbakers.com>2020-07-30 19:34:37 -0700
commita6164ca5a81224b7ed672401a47260f498f06e44 (patch)
treec79d79a3e701c8ce995bfbd104468e71dd45ce4a /docs/markdown/snippets
parentcc201a539674babf46f726859587afb5ed6a6867 (diff)
downloadmeson-a6164ca5a81224b7ed672401a47260f498f06e44.zip
meson-a6164ca5a81224b7ed672401a47260f498f06e44.tar.gz
meson-a6164ca5a81224b7ed672401a47260f498f06e44.tar.bz2
Allow setting project options from cross or native files
This allows adding a `[project options]` section to a cross or native file that contains the options defined for a project in it's meson_option.txt file.
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/project_options_in_machine_files.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/markdown/snippets/project_options_in_machine_files.md b/docs/markdown/snippets/project_options_in_machine_files.md
new file mode 100644
index 0000000..78b129a
--- /dev/null
+++ b/docs/markdown/snippets/project_options_in_machine_files.md
@@ -0,0 +1,37 @@
+## Project options can be set in native or cross files
+
+A new set of sections has been added to the cross and native files, `[project
+options]` and `[<subproject_name>:project options]`, where `subproject_name`
+is the name of a subproject. Any options that are allowed in the project can
+be set from this section. They have the lowest precedent, and will be
+overwritten by command line arguments.
+
+
+```meson
+option('foo', type : 'string', value : 'foo')
+```
+
+```ini
+[project options]
+foo = 'other val'
+```
+
+```console
+meson build --native-file my.ini
+```
+
+Will result in the option foo having the value `other val`,
+
+```console
+meson build --native-file my.ini -Dfoo='different val'
+```
+
+Will result in the option foo having the value `different val`,
+
+
+Subproject options are assigned like this:
+
+```ini
+[zlib:project options]
+foo = 'some val'
+```