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

Christophe Fergeau cfergeau at redhat.com
Thu Jul 23 07:57:59 UTC 2015


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)
> +
> +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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 819 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20150723/19ab0a85/attachment-0001.sig>


More information about the libvir-list mailing list