[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v2 1/2] docs: document deprecated features in append
From: |
Daniel P. Berrange |
Subject: |
[Qemu-devel] [PATCH v2 1/2] docs: document deprecated features in appendix |
Date: |
Tue, 6 Jun 2017 12:05:55 +0100 |
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[1] was made and provides text explaining
what to use instead.
Signed-off-by: Daniel P. Berrange <address@hidden>
[1] This is a lie. I've only listed one deprecated feature. Once
we agree on the general concept, we can fill out the doc
with the rest of the currently deprecated features.
---
qemu-doc.texi | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 965ba59..29f89d8 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -37,6 +37,7 @@
* QEMU Guest Agent::
* QEMU User space emulator::
* Implementation notes::
+* Deprecations::
* License::
* Index::
@end menu
@@ -3016,6 +3017,19 @@ Run the emulation in single step mode.
@include qemu-tech.texi
address@hidden Deprecations
address@hidden Deprecations
+
+The following is a list of features which have been marked as deprecated,
+pending removal in a future release:
+
address@hidden -drive boot=on|off (since v1.3.0)
+Since release 1.3.0, the ``boot=on|off'' parameter to ``-drive''
+is no longer honoured. It is currently ignored, but a future verson
+will reject this parameter with an error. Applications should use
+the ``bootindex=N'' parameter to set an absolute ordering between
+devices instead.
+
@node License
@appendix License
--
2.9.3