aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2020-07-01 00:04:08 +0300
committerGitHub <noreply@github.com>2020-07-01 00:04:08 +0300
commit64f36613ef5d54de9d2040da60b225c1ef11140d (patch)
tree8f490ef78cc1a6b02ca9b950ad51f5ded2218229 /docs/markdown/snippets
parentb6981bd16eb0227173a85d4b26a4b060dab16998 (diff)
parent0e98a7679a658b2a53a5de578f202a022c69f0c1 (diff)
downloadmeson-64f36613ef5d54de9d2040da60b225c1ef11140d.zip
meson-64f36613ef5d54de9d2040da60b225c1ef11140d.tar.gz
meson-64f36613ef5d54de9d2040da60b225c1ef11140d.tar.bz2
Merge pull request #7231 from mensinda/cmOverride
cmake: Add more advanced subproject configuration options
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/cmake.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/markdown/snippets/cmake.md b/docs/markdown/snippets/cmake.md
new file mode 100644
index 0000000..16da78e
--- /dev/null
+++ b/docs/markdown/snippets/cmake.md
@@ -0,0 +1,17 @@
+## Configure CMake subprojects with meson.subproject_options
+
+Meson now supports passing configuration options to CMake and overriding
+certain build details extracted from the CMake subproject.
+
+The new CMake configuration options object is very similar to the
+[configuration data object](Reference-manual.md#configuration-data-object) object
+returned by [`configuration_data`](Reference-manual.md#configuration_data). It
+is generated by the `subproject_options` function
+
+All configuration options have to be set *before* the subproject is configured
+and must be passed to the `subproject` method via the `options` key. Altering
+the configuration object won't have any effect on previous `cmake.subproject`
+calls.
+
+**Note:** The `cmake_options` kwarg for the `subproject` function is now
+deprecated since it is replaced by the new `options` system.