[PATCH v2 01/30] qemu-doc: Belatedly document QMP command arg & result deprecation
A number of deprecated QMP arguments and results were missed in commit
eb22aeca65 "docs: document deprecation policy & deprecated features in
appendix" (v2.10.0):
* Commit b33945cfff "block: Accept device model name for
blockdev-open/close-tray" (v2.8.0) deprecated blockdev-open-tray,
blockdev-close-tray argument @device.
* Commit fbe2d8163e "block: Accept device model name for eject"
(v2.8.0) deprecated eject argument @device.
* Commit 70e2cb3bd7 "block: Accept device model name for
blockdev-change-medium" (v2.8.0) deprecated blockdev-change-medium
argument @device.
* Commit 7a9877a026 "block: Accept device model name for
block_set_io_throttle" (v2.8.0) deprecated block_set_io_throttle
argument @device.
* Commit c01c214b69 "block: remove all encryption handling APIs"
(v2.10.0) deprecated query-named-block-nodes result
@encryption_key_missing and query-block result @inserted member
@encryption_key_missing.
* Commit c42e8742f5 "block: Use JSON null instead of "" to disable
backing file" (v2.10.0) deprecated blockdev-add empty string
argument @backing.
Since then, we missed a few more:
* Commit 3c605f4074 "commit: Add top-node/base-node options" (v3.1.0)
deprecated block-commit arguments @base and @top.
* Commit 4db6ceb0b5 "block/dirty-bitmap: add recording and busy
properties" (v4.0.0) deprecated query-named-block-nodes result
@dirty-bitmaps member @status, not just query-block.
Make up for all that.
Signed-off-by: Markus Armbruster <armbru(a)redhat.com>
---
qemu-deprecated.texi | 38 +++++++++++++++++++++++++++++++++++---
1 file changed, 35 insertions(+), 3 deletions(-)
diff --git a/qemu-deprecated.texi b/qemu-deprecated.texi
index 66eca3a1de..b9ef56fd97 100644
--- a/qemu-deprecated.texi
+++ b/qemu-deprecated.texi
@@ -150,19 +150,51 @@ Use @option{-display sdl,show-cursor=on} or
Use ``blockdev-change-medium'' or ``change-vnc-password'' instead.
+@subsection blockdev-open-tray, blockdev-close-tray argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+@subsection eject argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+@subsection blockdev-change-medium argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+@subsection block_set_io_throttle argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
@subsection migrate_set_downtime and migrate_set_speed (since 2.8.0)
Use ``migrate-set-parameters'' instead.
+@subsection query-named-block-nodes result encryption_key_missing (since 2.10.0)
+
+Always false.
+
+@subsection query-block result inserted.encryption_key_missing (since 2.10.0)
+
+Always false.
+
+@subsection blockdev-add empty string argument backing (since 2.10.0)
+
+Use argument ``null'' instead.
+
@subsection migrate-set-cache-size and query-migrate-cache-size (since 2.11.0)
Use ``migrate-set-parameters'' and ``query-migrate-parameters'' instead.
-@subsection query-block result field dirty-bitmaps[i].status (since 4.0)
+@subsection block-commit arguments base and top (since 3.1.0)
+
+Use arguments ``base-node'' and ``top-node'' instead.
+
+@subsection query-named-block-nodes and query-block result dirty-bitmaps[i].status (since
4.0)
The ``status'' field of the ``BlockDirtyInfo'' structure, returned by
-the query-block command is deprecated. Two new boolean fields,
-``recording'' and ``busy'' effectively replace it.
+these commands is deprecated. Two new boolean fields, ``recording'' and
+``busy'' effectively replace it.
@subsection query-block result field dirty-bitmaps (Since 4.2)
--
2.21.1