[PATCH v2 01/30] qemu-doc: Belatedly document QMP command arg & result deprecation

[Markus Armbruster]

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 at 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.
 
+ at subsection blockdev-open-tray, blockdev-close-tray argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+ at subsection eject argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+ at subsection blockdev-change-medium argument device (since 2.8.0)
+
+Use argument ``id'' instead.
+
+ at 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.
 
+ at subsection query-named-block-nodes result encryption_key_missing (since 2.10.0)
+
+Always false.
+
+ at subsection query-block result inserted.encryption_key_missing (since 2.10.0)
+
+Always false.
+
+ at 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.
 
- at subsection query-block result field dirty-bitmaps[i].status (since 4.0)
+ at subsection block-commit arguments base and top (since 3.1.0)
+
+Use arguments ``base-node'' and ``top-node'' instead.
+
+ at 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