[libvirt] [PATCH glib 1/2] README: formally document intended platform support targets

Daniel P. Berrange berrange at redhat.com
Fri Jul 24 09:57:49 UTC 2015


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 at 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 :|




More information about the libvir-list mailing list