qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Qemu-devel] [PATCH v4 1/2] docs: document support lifetime for feat


From: Daniel P. Berrange
Subject: Re: [Qemu-devel] [PATCH v4 1/2] docs: document support lifetime for features
Date: Mon, 17 Jul 2017 09:59:27 +0100
User-agent: Mutt/1.8.3 (2017-05-23)

On Fri, Jul 14, 2017 at 02:06:17PM -0300, Eduardo Habkost wrote:
> On Fri, Jul 14, 2017 at 11:15:48AM +0100, Daniel P. Berrange wrote:
> > There is currently no explicit guidance on the duration of support
> > for features such as versioned machine types, which have a finite
> > useful lifespan. Thus apps / users cannot predict how much time
> > they might be able to use a feature for, before it is removed (if
> > ever).
> > 
> > This adds a new appendix that lists items which have finite lifecycles,
> > such as machine types. For items which are generally expected to be
> > supported indefinitely, it sets out the policy around deprecation
> > and removal, should it be needed.
> > 
> > Signed-off-by: Daniel P. Berrange <address@hidden>
> > ---
> >  qemu-doc.texi | 37 +++++++++++++++++++++++++++++++++++++
> >  1 file changed, 37 insertions(+)
> > 
> > diff --git a/qemu-doc.texi b/qemu-doc.texi
> > index 48af5155c7..f067015d4b 100644
> > --- a/qemu-doc.texi
> > +++ b/qemu-doc.texi
> > @@ -38,6 +38,7 @@
> >  * QEMU Guest Agent::
> >  * QEMU User space emulator::
> >  * Implementation notes::
> > +* Support lifetime::
> >  * License::
> >  * Index::
> >  @end menu
> > @@ -3128,6 +3129,42 @@ Run the emulation in single step mode.
> >  
> >  @include qemu-tech.texi
> >  
> > address@hidden Support lifetime
> > address@hidden Support lifetime
> > +
> > +In general features are intended to be supported indefinitely once
> > +introduced into QEMU.
> > +
> > +In the event that a feature needs to be removed, it will be listed
> > +in the ``Deprecated features'' appendix of this document. The feature
> > +will remain functional for 2 major releases prior to actual removal.
> 
> Is a "major release" a x.0 release?  So if we decide to to
> deprecate a feature in QEMU 2.10, does this mean we will be able
> to remove it only on QEMU 4.0?
> 
> This doesn't sound like a predictable feature lifetime, if we
> don't have a predictable policy for major release numbering.

No, when I say "major" release there I meant non-bugfix releases.
eg 2.8, 2.9, 2.10, etc.  Lets remove the word "major" to avoid
such confusion



Regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|



reply via email to

[Prev in Thread] Current Thread [Next in Thread]