aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/global_root.md10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/markdown/snippets/global_root.md b/docs/markdown/snippets/global_root.md
new file mode 100644
index 0000000..8590f82
--- /dev/null
+++ b/docs/markdown/snippets/global_root.md
@@ -0,0 +1,10 @@
+## New `meson.global_build_root()` and `meson.global_source_root()` methods
+
+Returns the root source and build directory of the main project.
+
+Those are direct replacement for `meson.build_root()` and `meson.source_root()`
+that have been deprecated since 0.56.0. In some rare occasions they could not be
+replaced by `meson.project_source_root()` or `meson.current_source_dir()`, in
+which case the new methods can now be used instead. Old methods are still
+deprecated because their names are not explicit enough and created many issues
+when a project is being used as a subproject.