aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorXavier Claessens <xavier.claessens@collabora.com>2018-09-12 16:08:38 -0400
committerNirbheek Chauhan <nirbheek.chauhan@gmail.com>2018-09-18 11:50:45 -0700
commitbbac77c31f801c4db8c8c148294f9a8a2dfd9f73 (patch)
treeb0e39dacf780519ac27858bac6b5ff5a21f23a49 /docs/markdown/snippets
parent06646fe772304631126a0baf3c057e68285aa766 (diff)
downloadmeson-bbac77c31f801c4db8c8c148294f9a8a2dfd9f73.zip
meson-bbac77c31f801c4db8c8c148294f9a8a2dfd9f73.tar.gz
meson-bbac77c31f801c4db8c8c148294f9a8a2dfd9f73.tar.bz2
Doc: Deprecate python3 module [skip ci]
The new 'python' module is a superset of its features, keeping both is confusing. Closes #4168.
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/deprecated_python3_module.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/markdown/snippets/deprecated_python3_module.md b/docs/markdown/snippets/deprecated_python3_module.md
new file mode 100644
index 0000000..2c46830
--- /dev/null
+++ b/docs/markdown/snippets/deprecated_python3_module.md
@@ -0,0 +1,18 @@
+## python3 module is deprecated
+
+A generic module `python` has been added in Meson `0.46.0` and has a superset of
+the features implemented by the previous `python3` module.
+
+In most cases, it is a simple matter of renaming:
+```meson
+py3mod = import('python3')
+python = py3mod.find_python()
+```
+
+becomes
+
+```meson
+pymod = import('python')
+python = pymod.find_installation()
+```
+