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@xxxxxxxxxx> > > --- > > 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 :| -- libvir-list mailing list libvir-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/libvir-list