Add unset_variable()

This should be useful for helping to control variable scope within
Meson. CMake has something similar for controlling scope.

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/markdown/snippets/unset_variable.md b/docs/markdown/snippets/unset_variable.md
new file mode 100644
index 0000000..7b2bcdb
--- /dev/null
+++ b/docs/markdown/snippets/unset_variable.md
@@ -0,0 +1,16 @@
+## `unset_variable()`
+
+`unset_variable()` can be used to unset a variable. Reading a variable after
+calling `unset_variable()` will raise an exception unless the variable is set
+again.
+
+```meson
+# tests/meson.build
+tests = ['test1', 'test2']
+
+# ...
+
+unset_variable('tests')
+
+# tests is no longer usable until it is set again
+```