Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/1.1/patches/2221132/?format=api
{ "id": 2221132, "url": "http://patchwork.ozlabs.org/api/1.1/patches/2221132/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260408045531.3006678-8-jsnow@redhat.com/", "project": { "id": 14, "url": "http://patchwork.ozlabs.org/api/1.1/projects/14/?format=api", "name": "QEMU Development", "link_name": "qemu-devel", "list_id": "qemu-devel.nongnu.org", "list_email": "qemu-devel@nongnu.org", "web_url": "", "scm_url": "", "webscm_url": "" }, "msgid": "<20260408045531.3006678-8-jsnow@redhat.com>", "date": "2026-04-08T04:55:28", "name": "[v2,07/10] qapi: re-order QAPI doc block sections", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "09b6850551a7da4720c7fbcc3e421e6f436c9627", "submitter": { "id": 64343, "url": "http://patchwork.ozlabs.org/api/1.1/people/64343/?format=api", "name": "John Snow", "email": "jsnow@redhat.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260408045531.3006678-8-jsnow@redhat.com/mbox/", "series": [ { "id": 499174, "url": "http://patchwork.ozlabs.org/api/1.1/series/499174/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=499174", "date": "2026-04-08T04:55:23", "name": "qapi: enforce section ordering", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/499174/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2221132/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2221132/checks/", "tags": {}, "headers": { "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=V2xJLxpx;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from lists.gnu.org (lists1p.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4frXxB4Vxqz1xv0\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 09 Apr 2026 05:21:34 +1000 (AEST)", "from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces@nongnu.org>)\n\tid 1wAYRB-0007EP-1M; Wed, 08 Apr 2026 15:19:41 -0400", "from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <jsnow@redhat.com>) id 1wAY2H-0005ZP-1N\n for qemu-devel@nongnu.org; Wed, 08 Apr 2026 14:53:57 -0400", "from us-smtp-delivery-124.mimecast.com ([170.10.133.124])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <jsnow@redhat.com>) id 1wAKyD-0005XT-8J\n for qemu-devel@nongnu.org; Wed, 08 Apr 2026 00:56:55 -0400", "from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-122-MFaz0xMyMMa7Uq8c1rOLtA-1; Wed,\n 08 Apr 2026 00:56:49 -0400", "from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id D777219560B5; Wed, 8 Apr 2026 04:56:46 +0000 (UTC)", "from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.7])\n by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id C6E5D1955F2B; Wed, 8 Apr 2026 04:56:38 +0000 (UTC)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1775624212;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=m5Ulh2KIa7g5Gbcr6yBI+yN2C6y5JN4BDtX1lJgvtR0=;\n b=V2xJLxpxs8IUcHwK0qrfPyJMHEugR3+gIQSuJ/Gwv5Yi49DUHBmi4g+QttEtvEJuQ0mfz7\n k8Rfwszy+2JW47lHHvxB+Ypn9blVX2u7HBB0YK1uKMl3qNYKBBqnicnsZpV4DjunzyrtHX\n Kg6l9rVEnp5lKVoEGPEWSf08t1SJhG0=", "X-MC-Unique": "MFaz0xMyMMa7Uq8c1rOLtA-1", "X-Mimecast-MFC-AGG-ID": "MFaz0xMyMMa7Uq8c1rOLtA_1775624207", "From": "John Snow <jsnow@redhat.com>", "To": "qemu-devel@nongnu.org", "Cc": "Kashyap Chamarthy <kchamart@redhat.com>,\n Stefan Berger <stefanb@linux.vnet.ibm.com>,\n Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,\n Michael Roth <michael.roth@amd.com>,\n =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= <philmd@linaro.org>,\n qemu-block@nongnu.org, Pierrick Bouvier <pierrick.bouvier@linaro.org>,\n Yanan Wang <wangyanan55@huawei.com>, Hanna Reitz <hreitz@redhat.com>,\n Peter Xu <peterx@redhat.com>, Igor Mammedov <imammedo@redhat.com>,\n \"Michael S. Tsirkin\" <mst@redhat.com>, Kevin Wolf <kwolf@redhat.com>,\n\t=?utf-8?q?Marc-Andr=C3=A9_Lureau?= <marcandre.lureau@redhat.com>,\n Stefano Garzarella <sgarzare@redhat.com>, =?utf-8?q?Daniel_P=2E_Berrang?=\n\t=?utf-8?q?=C3=A9?= <berrange@redhat.com>, Lukas Straub <lukasstraub2@web.de>,\n Jason Wang <jasowang@redhat.com>, Alex Williamson <alex@shazbot.org>,\n Paolo Bonzini <pbonzini@redhat.com>, Fabiano Rosas <farosas@suse.de>,\n Zhao Liu <zhao1.liu@intel.com>,\n Richard Henderson <richard.henderson@linaro.org>, =?utf-8?q?C=C3=A9dric_Le_?=\n\t=?utf-8?q?Goater?= <clg@redhat.com>, Stefan Hajnoczi <stefanha@redhat.com>,\n Peter Maydell <peter.maydell@linaro.org>, Eric Blake <eblake@redhat.com>,\n\t=?utf-8?q?Alex_Benn=C3=A9e?= <alex.bennee@linaro.org>,\n Kostiantyn Kostiuk <kkostiuk@redhat.com>, Jiri Pirko <jiri@resnulli.us>,\n Markus Armbruster <armbru@redhat.com>, John Snow <jsnow@redhat.com>,\n Ani Sinha <anisinha@redhat.com>,\n Marcel Apfelbaum <marcel.apfelbaum@gmail.com>", "Subject": "[PATCH v2 07/10] qapi: re-order QAPI doc block sections", "Date": "Wed, 8 Apr 2026 00:55:28 -0400", "Message-ID": "<20260408045531.3006678-8-jsnow@redhat.com>", "In-Reply-To": "<20260408045531.3006678-1-jsnow@redhat.com>", "References": "<20260408045531.3006678-1-jsnow@redhat.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-Scanned-By": "MIMEDefang 3.0 on 10.30.177.12", "Received-SPF": "pass client-ip=170.10.133.124; envelope-from=jsnow@redhat.com;\n helo=us-smtp-delivery-124.mimecast.com", "X-Spam_score_int": "-25", "X-Spam_score": "-2.6", "X-Spam_bar": "--", "X-Spam_report": "(-2.6 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.54,\n DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001,\n RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001,\n SPF_HELO_PASS=-0.001,\n SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no", "X-Spam_action": "no action", "X-BeenThere": "qemu-devel@nongnu.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "qemu development <qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org" }, "content": "A forthcoming patch will enforce a rigid source order of QAPI Doc block\nsections:\n\n(1) Intro\n(2) Members\n(3) Returns\n(4) Errors\n(5) Features\n(6) Details\n(7) Since\n\nThis patch specifically ensures the source ordering of items #1-6, with\nthe positioning of \"Since:\" left for a subsequent patch, as it is a much\nlarger commit.\n\nSigned-off-by: John Snow <jsnow@redhat.com>\n\n---\n\n[Many changes to the *.ir files, generally :feat: lines moving\nlower. All changes are just relative re-orderings of the field list\nsection of the output, and all of these changes are intentional. --js]\n\nSigned-off-by: John Snow <jsnow@redhat.com>\n---\n qapi/accelerator.json | 4 +--\n qapi/block-core.json | 44 +++++++++++++-------------\n qapi/block-export.json | 20 ++++++------\n qapi/block.json | 8 ++---\n qapi/machine-s390x.json | 8 ++---\n qapi/machine.json | 56 ++++++++++++++++-----------------\n qapi/misc.json | 4 +--\n qapi/qom.json | 6 ++--\n qapi/virtio.json | 32 +++++++++----------\n tests/qapi-schema/doc-good.json | 8 ++---\n tests/qapi-schema/doc-good.txt | 10 +++---\n 11 files changed, 100 insertions(+), 100 deletions(-)", "diff": "diff --git a/qapi/accelerator.json b/qapi/accelerator.json\nindex 0cf5e0f9d94..d333a772384 100644\n--- a/qapi/accelerator.json\n+++ b/qapi/accelerator.json\n@@ -43,12 +43,12 @@\n #\n # Query accelerator statistics\n #\n+# Returns: accelerator statistics\n+#\n # Features:\n #\n # @unstable: This command is meant for debugging.\n #\n-# Returns: accelerator statistics\n-#\n # Since: 10.1\n ##\n { 'command': 'x-accel-stats',\ndiff --git a/qapi/block-core.json b/qapi/block-core.json\nindex abdcddb0a09..400ceda9e87 100644\n--- a/qapi/block-core.json\n+++ b/qapi/block-core.json\n@@ -1955,14 +1955,14 @@\n # `job-dismiss`. When true, this job will automatically disappear\n # without user intervention. Defaults to true. (Since 3.1)\n #\n+# Errors:\n+# - If @device does not exist, DeviceNotFound\n+#\n # Features:\n #\n # @deprecated: Members @base and @top are deprecated. Use @base-node\n # and @top-node instead.\n #\n-# Errors:\n-# - If @device does not exist, DeviceNotFound\n-#\n # Since: 1.3\n #\n # .. qmp-example::\n@@ -1993,14 +1993,14 @@\n # 'backup'. The operation can be stopped before it has completed\n # using the `job-cancel` or `block-job-cancel` command.\n #\n+# Errors:\n+# - If @device is not a valid block device, GenericError\n+#\n # Features:\n #\n # @deprecated: This command is deprecated. Use `blockdev-backup`\n # instead.\n #\n-# Errors:\n-# - If @device is not a valid block device, GenericError\n-#\n # Since: 1.6\n #\n # .. qmp-example::\n@@ -2558,14 +2558,14 @@\n #\n # Get bitmap SHA256.\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Errors:\n # - If @node is not a valid block device, DeviceNotFound\n # - If @name is not found or if hashing has failed, GenericError\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 2.10\n ##\n { 'command': 'x-debug-block-dirty-bitmap-sha256',\n@@ -3068,15 +3068,15 @@\n # the name of the parameter), but since QEMU 2.7 it can have other\n # values.\n #\n+# Errors:\n+# - If no background operation is active on this device,\n+# DeviceNotActive\n+#\n # Features:\n #\n # @deprecated: This command is deprecated. Use `job-pause`\n # instead.\n #\n-# Errors:\n-# - If no background operation is active on this device,\n-# DeviceNotActive\n-#\n # Since: 1.3\n ##\n { 'command': 'block-job-pause', 'data': { 'device': 'str' },\n@@ -3097,15 +3097,15 @@\n # the name of the parameter), but since QEMU 2.7 it can have other\n # values.\n #\n+# Errors:\n+# - If no background operation is active on this device,\n+# DeviceNotActive\n+#\n # Features:\n #\n # @deprecated: This command is deprecated. Use `job-resume`\n # instead.\n #\n-# Errors:\n-# - If no background operation is active on this device,\n-# DeviceNotActive\n-#\n # Since: 1.3\n ##\n { 'command': 'block-job-resume', 'data': { 'device': 'str' },\n@@ -3137,15 +3137,15 @@\n # the name of the parameter), but since QEMU 2.7 it can have other\n # values.\n #\n+# Errors:\n+# - If no background operation is active on this device,\n+# DeviceNotActive\n+#\n # Features:\n #\n # @deprecated: This command is deprecated. Use `job-complete`\n # instead.\n #\n-# Errors:\n-# - If no background operation is active on this device,\n-# DeviceNotActive\n-#\n # Since: 1.3\n ##\n { 'command': 'block-job-complete', 'data': { 'device': 'str' },\ndiff --git a/qapi/block-export.json b/qapi/block-export.json\nindex dd724acf1cb..d44b509968e 100644\n--- a/qapi/block-export.json\n+++ b/qapi/block-export.json\n@@ -249,15 +249,15 @@\n # The export name will be used as the id for the resulting block\n # export.\n #\n-# Features:\n-#\n-# @deprecated: This command is deprecated. Use `block-export-add`\n-# instead.\n-#\n # Errors:\n # - if the server is not running\n # - if an export with the same name already exists\n #\n+# Features:\n+#\n+# @deprecated: This command is deprecated. Use `block-export-add`\n+# instead.\n+#\n # Since: 1.3\n ##\n { 'command': 'nbd-server-add',\n@@ -297,16 +297,16 @@\n # @mode: Mode of command operation. See `BlockExportRemoveMode`\n # description. Default is 'safe'.\n #\n-# Features:\n-#\n-# @deprecated: This command is deprecated. Use `block-export-del`\n-# instead.\n-#\n # Errors:\n # - if the server is not running\n # - if export is not found\n # - if mode is 'safe' and there are existing connections\n #\n+# Features:\n+#\n+# @deprecated: This command is deprecated. Use `block-export-del`\n+# instead.\n+#\n # Since: 2.12\n ##\n { 'command': 'nbd-server-remove',\ndiff --git a/qapi/block.json b/qapi/block.json\nindex 46955bbb3e3..54bc0056318 100644\n--- a/qapi/block.json\n+++ b/qapi/block.json\n@@ -109,13 +109,13 @@\n # @force: If true, eject regardless of whether the drive is locked.\n # If not specified, the default value is false.\n #\n-# Features:\n-#\n-# @deprecated: Member @device is deprecated. Use @id instead.\n-#\n # Errors:\n # - If @device is not a valid block device, DeviceNotFound\n #\n+# Features:\n+#\n+# @deprecated: Member @device is deprecated. Use @id instead.\n+#\n # .. note:: Ejecting a device with no media results in success.\n #\n # Since: 0.14\ndiff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json\nindex ea430e1b889..e67f180a272 100644\n--- a/qapi/machine-s390x.json\n+++ b/qapi/machine-s390x.json\n@@ -108,12 +108,12 @@\n ##\n # @query-s390x-cpu-polarization:\n #\n-# Features:\n-#\n-# @unstable: This command is experimental.\n-#\n # Returns: the machine's CPU polarization\n #\n+# Features:\n+#\n+# @unstable: This command is experimental.\n+#\n # Since: 8.2\n ##\n { 'command': 'query-s390x-cpu-polarization', 'returns': 'CpuPolarizationInfo',\ndiff --git a/qapi/machine.json b/qapi/machine.json\nindex 012f61e2a7e..0a4b758b2d5 100644\n--- a/qapi/machine.json\n+++ b/qapi/machine.json\n@@ -1676,12 +1676,12 @@\n #\n # Query interrupt statistics\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: interrupt statistics\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-irq',\n@@ -1693,12 +1693,12 @@\n #\n # Query TCG compiler statistics\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: TCG compiler statistics\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-jit',\n@@ -1711,12 +1711,12 @@\n #\n # Query NUMA topology information\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: topology information\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-numa',\n@@ -1728,12 +1728,12 @@\n #\n # Query system ramblock information\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: system ramblock information\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-ramblock',\n@@ -1745,12 +1745,12 @@\n #\n # Query information on the registered ROMS\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: registered ROMs\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-roms',\n@@ -1762,12 +1762,12 @@\n #\n # Query information on the USB devices\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: USB device information\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 6.2\n ##\n { 'command': 'x-query-usb',\n@@ -1831,12 +1831,12 @@\n #\n # Query information on interrupt controller devices\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: Interrupt controller devices information\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 9.1\n ##\n { 'command': 'x-query-interrupt-controllers',\ndiff --git a/qapi/misc.json b/qapi/misc.json\nindex 28c641fe2fe..05866837f09 100644\n--- a/qapi/misc.json\n+++ b/qapi/misc.json\n@@ -209,14 +209,14 @@\n #\n # @cpu-index: The CPU to use for commands that require an implicit CPU\n #\n+# Returns: the output of the command as a string\n+#\n # Features:\n #\n # @savevm-monitor-nodes: If present, HMP command savevm only snapshots\n # monitor-owned nodes if they have no parents. This allows the\n # use of 'savevm' with -blockdev. (since 4.2)\n #\n-# Returns: the output of the command as a string\n-#\n # Since: 0.14\n #\n # .. note:: This command only exists as a stop-gap. Its use is highly\ndiff --git a/qapi/qom.json b/qapi/qom.json\nindex 568b7d4b997..fd88be07e13 100644\n--- a/qapi/qom.json\n+++ b/qapi/qom.json\n@@ -161,12 +161,12 @@\n # @paths: The absolute or partial path for each object, as described\n # in `qom-get`.\n #\n-# Errors:\n-# - If any path is not valid or is ambiguous\n-#\n # Returns: A list where each element is the result for the\n # corresponding element of @paths.\n #\n+# Errors:\n+# - If any path is not valid or is ambiguous\n+#\n # Since 10.1\n ##\n { 'command': 'qom-list-get',\ndiff --git a/qapi/virtio.json b/qapi/virtio.json\nindex 09dd0e6d05a..447fc182625 100644\n--- a/qapi/virtio.json\n+++ b/qapi/virtio.json\n@@ -28,12 +28,12 @@\n #\n # Return a list of all realized VirtIODevices\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: List of gathered VirtIODevices\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 7.2\n #\n # .. qmp-example::\n@@ -197,12 +197,12 @@\n #\n # @path: Canonical QOM path of the VirtIODevice\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: Status of the virtio device\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 7.2\n #\n # .. qmp-example::\n@@ -566,12 +566,12 @@\n #\n # @queue: VirtQueue index to examine\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: Status of the queue\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # .. note:: last_avail_idx will not be displayed in the case where the\n # selected VirtIODevice has a running vhost device and the\n # VirtIODevice VirtQueue index (queue) does not exist for the\n@@ -701,12 +701,12 @@\n #\n # @queue: vhost_virtqueue index to examine\n #\n-# Features:\n-#\n-# @unstable: This command is meant for debugging.\n-#\n # Returns: Status of the vhost_virtqueue\n #\n+# Features:\n+#\n+# @unstable: This command is meant for debugging.\n+#\n # Since: 7.2\n #\n # .. qmp-example::\ndiff --git a/tests/qapi-schema/doc-good.json b/tests/qapi-schema/doc-good.json\nindex 9103fed472e..5b567824280 100644\n--- a/tests/qapi-schema/doc-good.json\n+++ b/tests/qapi-schema/doc-good.json\n@@ -161,14 +161,14 @@\n # @arg2: description starts on the same line\n # remainder indented differently\n #\n-# Features:\n-# @cmd-feat1: a feature\n-# @cmd-feat2: another feature\n-#\n # Returns: @Object\n #\n # Errors: some\n #\n+# Features:\n+# @cmd-feat1: a feature\n+# @cmd-feat2: another feature\n+#\n # .. note:: @arg3 is undocumented\n #\n # TODO: frobnicate\ndiff --git a/tests/qapi-schema/doc-good.txt b/tests/qapi-schema/doc-good.txt\nindex ded699dd596..226c3d27a36 100644\n--- a/tests/qapi-schema/doc-good.txt\n+++ b/tests/qapi-schema/doc-good.txt\n@@ -115,17 +115,17 @@ Command cmd (Since: 2.10)\n \n * **arg3** (\"boolean\") -- Not documented\n \n- Features:\n- * **cmd-feat1** -- a feature\n-\n- * **cmd-feat2** -- another feature\n-\n Return:\n \"Object\" -- \"Object\"\n \n Errors:\n some\n \n+ Features:\n+ * **cmd-feat1** -- a feature\n+\n+ * **cmd-feat2** -- another feature\n+\n Note:\n \n \"arg3\" is undocumented\n", "prefixes": [ "v2", "07/10" ] }