aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorDaniel Mensinger <daniel@mensinger-ka.de>2020-05-31 22:30:24 +0200
committerDaniel Mensinger <daniel@mensinger-ka.de>2020-06-05 11:45:10 +0200
commitede2cd556c0568dabcb8826fe87bd00c376b797e (patch)
tree6f24b30a4ee5e891a8766e35ff2ff3aaeb39e701 /docs/markdown/snippets
parent08e838a235f5b1207694463dbd619dcebdc4eb61 (diff)
downloadmeson-ede2cd556c0568dabcb8826fe87bd00c376b797e.zip
meson-ede2cd556c0568dabcb8826fe87bd00c376b797e.tar.gz
meson-ede2cd556c0568dabcb8826fe87bd00c376b797e.tar.bz2
cmake: added docs
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.