[glib: 1/10] docs: Add a Meson version policy

[Philip Withnall <pwithnall src gnome org>]

commit 7fd4ebacb36b9474b97e1678bdb01b2e9be794c4
Author: Philip Withnall <pwithnall endlessos org>
Date:   Thu May 5 19:08:19 2022 +0100

    docs: Add a Meson version policy
    
    Signed-off-by: Philip Withnall <pwithnall endlessos org>
    
    Fixes: #2596

 docs/meson-version.md | 30 ++++++++++++++++++++++++++++++
 meson.build           |  2 +-
 2 files changed, 31 insertions(+), 1 deletion(-)
---
diff --git a/docs/meson-version.md b/docs/meson-version.md
new file mode 100644
index 0000000000..e1aa7407d1
--- /dev/null
+++ b/docs/meson-version.md
@@ -0,0 +1,30 @@
+Meson version policy
+===
+
+Aims
+---
+
+ * Stable versions of GLib should be buildable from source on the majority of
+   systems which are still supported by their vendors, without requiring the
+   user to manually build a number of dependencies
+ * Unstable versions of GLib should be able to take advantage of newer build
+   system features where they would make maintenance of GLib easier, without
+   prejudicing the other aims
+
+Policy
+---
+
+ * Stable branches of GLib will not change their Meson dependency after the
+   first release of that stable series
+ * Unstable branches of GLib can bump their Meson dependency if
+   - at least that version of Meson currently available in Debian Testing; or
+   - the Python version required by the new Meson dependency is available in
+     Debian Stable *and* the oldest currently-supported Ubuntu LTS
+ * The version of Meson used by GLib should be pinned and pre-installed in the
+   CI `Dockerfile`s so that GLib is guaranteed to be built against the expected
+   version
+
+The reasoning behind allowing a version bump if the Python which Meson depends
+on is available in Debian Stable is that it’s [straightforward to install a more
+recent Meson version using
+`pip`](https://mesonbuild.com/Getting-meson.html#installing-meson-with-pip).
diff --git a/meson.build b/meson.build
index 7e1b433729..a1676a28cf 100644
--- a/meson.build
+++ b/meson.build
@@ -1,6 +1,6 @@
 project('glib', 'c', 'cpp',
   version : '2.73.0',
-  # NOTE: We keep this pinned at 0.52 because that's what Debian Stable ships
+  # NOTE: See the policy in docs/meson-version.md before changing the Meson dependency
   meson_version : '>= 0.52.0',
   default_options : [
     'buildtype=debugoptimized',