[libvirt] [PATCH glib 0/2] Clarify min required versions of deps
This sets out a policy for deciding when it is reasonable to increase the min required versions of external deps, and then updates current min versions accordingly. The aim is to ensure libvirt-glib is easily buildable on latest enterprise and community distros, to maximise the pool of possible contributors to the project and simplify life for the distro maintainers packaging it. Daniel P. Berrange (2): README: formally document intended platform support targets configure.ac: update min required versions README | 67 +++++++++++++++++++++++++++++++++++++++++++++++++----------- configure.ac | 8 +++----- 2 files changed, 58 insertions(+), 17 deletions(-) -- 2.4.3
Give users an indication of what distro platforms the project intends to be buildable on. This policy will be used to decide when it is appropriate to increase the minimum required versions of external dependancies. Signed-off-by: Daniel P. Berrange <berrange@redhat.com> --- README | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 55 insertions(+), 12 deletions(-) diff --git a/README b/README index 3108e3c..798545f 100644 --- a/README +++ b/README @@ -26,18 +26,61 @@ The latest official releases can be found at: NB: at this time, libvirt-glib is *NOT* considered API/ABI stable. Future releases may still include API/ABI incompatible changes. -Dependencies -============ - -- Required: - - glib-2.0 - - gobject-2.0 - - libxml-2.0 - - libvirt - -- Optional: - - gobject-introspection - - Vala (build-time only) +Dependencies / supported platforms +================================== + +The libvirt-glib projects attempts to be moderately conservative +about updating the minimum required versions of external package +dependencies, to strike a balance between enabling use of new +features while minimizing inconvenience for downstream developers +on distro platforms with specific shipped version. + +There are roughly two classes of Linux distro - short lifetime +(Fedora, Ubuntu non-LTS, etc) and extended lifetime (RHEL, CentOS, +Debian, Ubuntu LTS). Based on this classification, the libvirt-glib +project will generally aim to ensure build support for + + - Most recent 2 releases of short lifetime distros + - Most recent major release of extended lifetime distros, + with most recent 2 minor updates + +The project will consider RHEL, Fedora, Debian, Ubuntu LTS, Ubuntu, +OpenSUSE and SUSE (SLES/SLED) distros to be a representative subset +of distros when determining min required versions of external deps +that is reasonable to target. Other distros of similar release vintage +will typically have similar versions to at least one of these distros. +In the case of Debian, the project may at times choose to require use +of an update from the backports repository. + +As an example, as of July 1st 2015, this policy would aim to pick the +min versions based on what's available across the following sample +distros: + + - RHEL: 7.0, 7.1 + - Fedora: 21, 22 + - Ubuntu LTS: 14.04 (Trusty) + - Ubuntu: 14.10 (Utopic), 15.04 (Vivid) + - Suse: 12.0 + - OpenSUSE: 13.1, 13.2 + - Debian: 8.0 (Jessie) + +At any time, it may be possible to build on versions of distros +that are older than those implied by this policy, but the project +will not guarantee this remains the case in future releases. The +min required package versions of external dependancies may be +raised in future releases based on this distro build target policy. + +The packages required to build libvirt-glib are + + - glib-2.0 + - gobject-2.0 + - libxml-2.0 + - libvirt + +Functionality is optionally enhanced by the following packages: + + - gobject-introspection + - Vala (build-time only) Patches sumissions ================== -- 2.4.3
Hey, On Wed, Jul 22, 2015 at 03:14:22PM +0100, Daniel P. Berrange wrote:
Give users an indication of what distro platforms the project intends to be buildable on. This policy will be used to decide when it is appropriate to increase the minimum required versions of external dependancies.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com> --- README | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 55 insertions(+), 12 deletions(-)
diff --git a/README b/README index 3108e3c..798545f 100644 --- a/README +++ b/README @@ -26,18 +26,61 @@ The latest official releases can be found at: NB: at this time, libvirt-glib is *NOT* considered API/ABI stable. Future releases may still include API/ABI incompatible changes.
-Dependencies -============ - -- Required: - - glib-2.0 - - gobject-2.0 - - libxml-2.0 - - libvirt - -- Optional: - - gobject-introspection - - Vala (build-time only) +Dependencies / supported platforms +================================== + +The libvirt-glib projects attempts to be moderately conservative +about updating the minimum required versions of external package +dependencies, to strike a balance between enabling use of new +features while minimizing inconvenience for downstream developers +on distro platforms with specific shipped version.
'versions' rather than 'version' ?
+ +There are roughly two classes of Linux distro - short lifetime +(Fedora, Ubuntu non-LTS, etc) and extended lifetime (RHEL, CentOS, +Debian, Ubuntu LTS). Based on this classification, the libvirt-glib +project will generally aim to ensure build support for + + - Most recent 2 releases of short lifetime distros + - Most recent major release of extended lifetime distros, + with most recent 2 minor updates + +The project will consider RHEL, Fedora, Debian, Ubuntu LTS, Ubuntu, +OpenSUSE and SUSE (SLES/SLED) distros to be a representative subset +of distros when determining min required versions of external deps +that is reasonable to target. Other distros of similar release vintage +will typically have similar versions to at least one of these distros. +In the case of Debian, the project may at times choose to require use +of an update from the backports repository. + +As an example, as of July 1st 2015, this policy would aim to pick the +min versions based on what's available across the following sample +distros: + + - RHEL: 7.0, 7.1 + - Fedora: 21, 22 + - Ubuntu LTS: 14.04 (Trusty) + - Ubuntu: 14.10 (Utopic), 15.04 (Vivid) + - Suse: 12.0 + - OpenSUSE: 13.1, 13.2 + - Debian: 8.0 (Jessie) + +At any time, it may be possible to build on versions of distros +that are older than those implied by this policy, but the project +will not guarantee this remains the case in future releases. The +min required package versions of external dependancies may be
'dependencies'
+raised in future releases based on this distro build target policy. + +The packages required to build libvirt-glib are + + - glib-2.0 + - gobject-2.0 + - libxml-2.0 + - libvirt + +Functionality is optionally enhanced by the following packages: + + - gobject-introspection + - Vala (build-time only)
Good for me, ACK.
Patches sumissions ==================
While at it, can you fix this 'submission' typo? Christophe
On Thu, Jul 23, 2015 at 09:57:59AM +0200, Christophe Fergeau wrote:
Hey,
On Wed, Jul 22, 2015 at 03:14:22PM +0100, Daniel P. Berrange wrote:
Give users an indication of what distro platforms the project intends to be buildable on. This policy will be used to decide when it is appropriate to increase the minimum required versions of external dependancies.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com> --- README | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 55 insertions(+), 12 deletions(-)
diff --git a/README b/README index 3108e3c..798545f 100644 --- a/README +++ b/README @@ -26,18 +26,61 @@ The latest official releases can be found at: NB: at this time, libvirt-glib is *NOT* considered API/ABI stable. Future releases may still include API/ABI incompatible changes.
-Dependencies -============ - -- Required: - - glib-2.0 - - gobject-2.0 - - libxml-2.0 - - libvirt - -- Optional: - - gobject-introspection - - Vala (build-time only) +Dependencies / supported platforms +================================== + +The libvirt-glib projects attempts to be moderately conservative +about updating the minimum required versions of external package +dependencies, to strike a balance between enabling use of new +features while minimizing inconvenience for downstream developers +on distro platforms with specific shipped version.
'versions' rather than 'version' ?
+ +There are roughly two classes of Linux distro - short lifetime +(Fedora, Ubuntu non-LTS, etc) and extended lifetime (RHEL, CentOS, +Debian, Ubuntu LTS). Based on this classification, the libvirt-glib +project will generally aim to ensure build support for + + - Most recent 2 releases of short lifetime distros + - Most recent major release of extended lifetime distros, + with most recent 2 minor updates + +The project will consider RHEL, Fedora, Debian, Ubuntu LTS, Ubuntu, +OpenSUSE and SUSE (SLES/SLED) distros to be a representative subset +of distros when determining min required versions of external deps +that is reasonable to target. Other distros of similar release vintage +will typically have similar versions to at least one of these distros. +In the case of Debian, the project may at times choose to require use +of an update from the backports repository. + +As an example, as of July 1st 2015, this policy would aim to pick the +min versions based on what's available across the following sample +distros: + + - RHEL: 7.0, 7.1 + - Fedora: 21, 22 + - Ubuntu LTS: 14.04 (Trusty) + - Ubuntu: 14.10 (Utopic), 15.04 (Vivid) + - Suse: 12.0 + - OpenSUSE: 13.1, 13.2 + - Debian: 8.0 (Jessie)
I think I'll move this list of example versions ot the commit message to avoid confusing people in a few years time, as Zeeshan pointed out.
+ +At any time, it may be possible to build on versions of distros +that are older than those implied by this policy, but the project +will not guarantee this remains the case in future releases. The +min required package versions of external dependancies may be
'dependencies'
+raised in future releases based on this distro build target policy. + +The packages required to build libvirt-glib are + + - glib-2.0 + - gobject-2.0 + - libxml-2.0 + - libvirt + +Functionality is optionally enhanced by the following packages: + + - gobject-introspection + - Vala (build-time only)
Good for me, ACK.
Patches sumissions ==================
While at it, can you fix this 'submission' typo?
Christophe
Regards, Daniel -- |: http://berrange.com -o- http://www.flickr.com/photos/dberrange/ :| |: http://libvirt.org -o- http://virt-manager.org :| |: http://autobuild.org -o- http://search.cpan.org/~danberr/ :| |: http://entangle-photo.org -o- http://live.gnome.org/gtk-vnc :|
On Fri, Jul 24, 2015 at 10:57:49AM +0100, Daniel P. Berrange wrote:
On Thu, Jul 23, 2015 at 09:57:59AM +0200, Christophe Fergeau wrote:
On Wed, Jul 22, 2015 at 03:14:22PM +0100, Daniel P. Berrange wrote:
+As an example, as of July 1st 2015, this policy would aim to pick the +min versions based on what's available across the following sample +distros: + + - RHEL: 7.0, 7.1 + - Fedora: 21, 22 + - Ubuntu LTS: 14.04 (Trusty) + - Ubuntu: 14.10 (Utopic), 15.04 (Vivid) + - Suse: 12.0 + - OpenSUSE: 13.1, 13.2 + - Debian: 8.0 (Jessie)
I think I'll move this list of example versions ot the commit message to avoid confusing people in a few years time, as Zeeshan pointed out.
Either is fine with me. We can also update that list every few years when it starts getting odd (but this most likely will never get done as we'll never look into README :) Christophe
Based on the distro target policy we have the following min versions in various distros libvirt glib2 gobject-introspection RHEL 7.0: 1.1.1 2.36.3 1.36.0 Fedora 21: 1.2.9 2.42.1 1.42.0 Ubuntu 14.10: 1.2.8 2.42.0 1.41.0 Ubuntu LTS 14.04: 1.2.2 2.40.0 1.40.0 Suse 12.0: 1.2.5 2.38.2 1.38.0 OpenSUSE 13.1: 1.1.2 2.38.2 1.38.0 Debian 8: 1.2.9 2.42.0 1.42.0 Which means we can reasonably depend on libvirt >= 1.1.1 glib2 >= 2.36.3 gobject-introspection >= 1.36.0 --- configure.ac | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/configure.ac b/configure.ac index d9b4665..a1f496d 100644 --- a/configure.ac +++ b/configure.ac @@ -9,14 +9,12 @@ AC_CANONICAL_HOST AM_SILENT_RULES([yes]) -LIBVIRT_REQUIRED=0.10.2 +LIBVIRT_REQUIRED=1.1.1 AC_SUBST([LIBVIRT_REQUIRED]) dnl used in the .spec file -GLIB2_REQUIRED=2.36.0 +GLIB2_REQUIRED=2.36.3 AC_SUBST([GLIB2_REQUIRED]) dnl used in the .spec file GLIB2_TEST_REQUIRED=2.38.0 -GOBJECT2_REQUIRED=2.10.0 -GIO_REQUIRED=2.10.0 -GOBJECT_INTROSPECTION_REQUIRED=0.10.8 +GOBJECT_INTROSPECTION_REQUIRED=1.36.0 LIBXML2_REQUIRED=2.0.0 LIBVIRT_GLIB_MAJOR_VERSION=`echo $VERSION | awk -F. '{print $1}'` -- 2.4.3
On Wed, Jul 22, 2015 at 03:14:23PM +0100, Daniel P. Berrange wrote:
Based on the distro target policy we have the following min versions in various distros
libvirt glib2 gobject-introspection RHEL 7.0: 1.1.1 2.36.3 1.36.0 Fedora 21: 1.2.9 2.42.1 1.42.0 Ubuntu 14.10: 1.2.8 2.42.0 1.41.0 Ubuntu LTS 14.04: 1.2.2 2.40.0 1.40.0 Suse 12.0: 1.2.5 2.38.2 1.38.0 OpenSUSE 13.1: 1.1.2 2.38.2 1.38.0 Debian 8: 1.2.9 2.42.0 1.42.0
Which means we can reasonably depend on
libvirt >= 1.1.1 glib2 >= 2.36.3
I'd keep glib2 >= 2.36.0 as 2.36.x glib release really are minor bug-fix only releases, no API additions.
gobject-introspection >= 1.36.0 --- configure.ac | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-)
diff --git a/configure.ac b/configure.ac index d9b4665..a1f496d 100644 --- a/configure.ac +++ b/configure.ac @@ -9,14 +9,12 @@ AC_CANONICAL_HOST
AM_SILENT_RULES([yes])
-LIBVIRT_REQUIRED=0.10.2 +LIBVIRT_REQUIRED=1.1.1 AC_SUBST([LIBVIRT_REQUIRED]) dnl used in the .spec file -GLIB2_REQUIRED=2.36.0 +GLIB2_REQUIRED=2.36.3 AC_SUBST([GLIB2_REQUIRED]) dnl used in the .spec file GLIB2_TEST_REQUIRED=2.38.0 -GOBJECT2_REQUIRED=2.10.0 -GIO_REQUIRED=2.10.0
Ah these 2 are unused, I was wondering why they were removed rather than replaced. ACK. Christophe
On Thu, Jul 23, 2015 at 10:00:14AM +0200, Christophe Fergeau wrote:
On Wed, Jul 22, 2015 at 03:14:23PM +0100, Daniel P. Berrange wrote:
Based on the distro target policy we have the following min versions in various distros
libvirt glib2 gobject-introspection RHEL 7.0: 1.1.1 2.36.3 1.36.0 Fedora 21: 1.2.9 2.42.1 1.42.0 Ubuntu 14.10: 1.2.8 2.42.0 1.41.0 Ubuntu LTS 14.04: 1.2.2 2.40.0 1.40.0 Suse 12.0: 1.2.5 2.38.2 1.38.0 OpenSUSE 13.1: 1.1.2 2.38.2 1.38.0 Debian 8: 1.2.9 2.42.0 1.42.0
Which means we can reasonably depend on
libvirt >= 1.1.1 glib2 >= 2.36.3
I'd keep glib2 >= 2.36.0 as 2.36.x glib release really are minor bug-fix only releases, no API additions.
yep, good point.
ACK.
Regards, Daniel -- |: http://berrange.com -o- http://www.flickr.com/photos/dberrange/ :| |: http://libvirt.org -o- http://virt-manager.org :| |: http://autobuild.org -o- http://search.cpan.org/~danberr/ :| |: http://entangle-photo.org -o- http://live.gnome.org/gtk-vnc :|
participants (2)
-
Christophe Fergeau -
Daniel P. Berrange