qapi: Clean up "Returns" sections

Drop list markup, since there's just one item left.

Drop "on success" where it is redundant with "Returns:".

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240227113921.236097-7-armbru@redhat.com>

diff --git a/qapi/block-core.json b/qapi/block-core.json
index 94b01deffc51ec5dbd1e292139fa8f9dff320056..1874f880a8decbf0e1278679cc18f792ba619359 100644 (file)
--- a/qapi/block-core.json
+++ b/qapi/block-core.json
@@ -2457,7 +2457,7 @@
 # @unstable: This command is meant for debugging.
 #
 # Returns:
-#     - BlockDirtyBitmapSha256 on success
+#     BlockDirtyBitmapSha256
 #
 # Errors:
 #     - If @node is not a valid block device, DeviceNotFound
@@ -6084,7 +6084,7 @@
 # @name: optional the snapshot's name to be deleted
 #
 # Returns:
-#     - SnapshotInfo on success
+#     SnapshotInfo
 #
 # Errors:
 #     - If @device is not a valid block device, GenericError

diff --git a/qapi/machine.json b/qapi/machine.json
index 7d3ca33683b49f9ac59993138647a3a1d0694974..bb5a17890944f9bff8d863cf67d554631a8275f0 100644 (file)
--- a/qapi/machine.json
+++ b/qapi/machine.json
@@ -1090,7 +1090,7 @@
 # Return information about the balloon device.
 #
 # Returns:
-#     - @BalloonInfo on success
+#     @BalloonInfo
 #
 # Errors:
 #     - If the balloon driver is enabled but not functional because
@@ -1156,7 +1156,7 @@
 # message from the guest.
 #
 # Returns:
-#     - @HvBalloonInfo on success
+#     @HvBalloonInfo
 #
 # Errors:
 #     - If no hv-balloon device is present, guest memory status

diff --git a/qapi/misc.json b/qapi/misc.json
index 015388aa3eed11c893b31966dd99de5a0c81c3da..1b0c5dad8824b0ff51f29a5087965169ba38b750 100644 (file)
--- a/qapi/misc.json
+++ b/qapi/misc.json
@@ -332,7 +332,7 @@
 # @opaque: A free-form string that can be used to describe the fd.
 #
 # Returns:
-#     - @AddfdInfo on success
+#     @AddfdInfo
 #
 # Errors:
 #     - If file descriptor was not received, GenericError