[glib: 1/10] docs: Add a Meson version policy
- From: Philip Withnall <pwithnall src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib: 1/10] docs: Add a Meson version policy
- Date: Tue, 10 May 2022 11:43:44 +0000 (UTC)
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',
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]