docs: Add CMake build type release note snippet

1 files changed, 15 insertions, 0 deletions

diff --git a/docs/markdown/snippets/cmake_build_type.md b/docs/markdown/snippets/cmake_build_type.md
new file mode 100644
index 000000000..af9e84dc8
--- /dev/null
+++ b/docs/markdown/snippets/cmake_build_type.md
@@ -0,0 +1,15 @@
+## Meson now propagates its build type to CMake
+
+When the CMake build type variable, `CMAKE_BUILD_TYPE`, is not set via the
+`add_cmake_defines` method of the [`cmake options` object](CMake-module.md#cmake-options-object),
+it is inferred from the [Meson build type](Builtin-options.md#details-for-buildtype).
+Build types of the two build systems do not match perfectly. The mapping from
+Meson build type to CMake build type is as follows:
+
+- `debug` -> `Debug`
+- `debugoptimized` -> `RelWithDebInfo`
+- `release` -> `Release`
+- `minsize` -> `MinSizeRel`
+
+No CMake build type is set for the `plain` Meson build type. The inferred CMake
+build type overrides any `CMAKE_BUILD_TYPE` environment variable.