docs: document deprecation policy & deprecated features in appendix
commiteb22aeca65f3769af33ba559757b42f24f743c18
authorDaniel P. Berrange <berrange@redhat.com>
Tue, 25 Jul 2017 11:36:38 +0000 (25 12:36 +0100)
committerPaolo Bonzini <pbonzini@redhat.com>
Tue, 1 Aug 2017 15:27:33 +0000 (1 17:27 +0200)
treefe34d6bf886a80d603e13164cc037c3d2e531b36
parent0ec846bface0f9733ca61ba18e3d4b72bfd9f8ca
docs: document deprecation policy & deprecated features in appendix

The deprecation of features in QEMU is totally adhoc currently,
with no way for the user to get a list of what is deprecated
in each release. This adds an appendix to the doc that records
when each deprecation was made and provides text explaining
what to use instead, if anything.

Since there has been no formal policy around removal of deprecated
features in the past, any deprecations prior to 2.10.0 are to be
treated as if they had been made at the 2.10.0 release. Thus the
earliest that existing deprecations will be deleted is the start
of the 2.12.0 cycle.

Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
Message-Id: <20170725113638.7019-1-berrange@redhat.com>
Reviewed-by: Thomas Huth <thuth@redhat.com>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
qemu-doc.texi