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 <berra...@redhat.com> > > --- > > 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 > > > > +@node Support lifetime > > +@appendix 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 :|
