From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110641; cv=none; d=zohomail.com; s=zohoarc; b=Jn3jKCeM5aNXE2VKnYrz40Ym/katrD7MImu2EkUE6Xn91NfYnGFwc2HrxOS5bBSPNpk3WD/hZ/gfdxy+Inh4cI+MSeDvv+aClaloaeOdsbbPWcS5WoatkuQNC07kjkeW8pM6FM8/vg6aHa824tGFqfUSDQK6eyutEdg1cBerdhA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110641; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=hO6U0r43tcwIk1YxVH+Jad9U+KcRDjTIv+P59ADGJEo=; b=Lh7e4LtbGN5GHGjKTpJCuRqjn9ci0uiJ3akzvhguLJguqab06yyo7DOve6xm27Uc0/lj0HfjX7QWrA6/L+jldr4133KWwJ88FLSS7XnK134CIjveZ4hBNNNkGbJhVcRZYs5FzrHJtEdwZoa8K1+12QlFwoZaZasmxz0TX1K05mc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110641445480.3611948562602; Tue, 22 Sep 2026 13:57:21 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Xf-0000KP-0W; Tue, 22 Sep 2026 16:56:43 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XP-0000Fs-UT for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:28 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XO-00045D-EJ for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:27 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-155-xlp_FLPXNHGSAHfsHoZIAA-1; Tue, 22 Sep 2026 16:56:21 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 1EE7F1944A85; Tue, 22 Sep 2026 20:56:19 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id EA3E41956087; Tue, 22 Sep 2026 20:56:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110585; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=hO6U0r43tcwIk1YxVH+Jad9U+KcRDjTIv+P59ADGJEo=; b=LQf2oY0QY9MkvaeDBtXCrEzriKdO/WR66brcdXVn1IVMJPe6XrIYJa2Ia7NeDSRzu1mQ74 E09PD7bKfgh8nFpYRcaysxzUdU5SSdd4yryznN/sMMR/ygMajKoAC4tfV5bFhk8iyvnEWl zL2S+Y3PgLPDcqfGTEX4/lNYQP91SBE= X-MC-Unique: xlp_FLPXNHGSAHfsHoZIAA-1 X-Mimecast-MFC-AGG-ID: xlp_FLPXNHGSAHfsHoZIAA_1790110579 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 1/8] qapi: convert/split remaining qapi/qmp intro sections Date: Tue, 22 Sep 2026 16:55:58 -0400 Message-ID: <20260922205605.501602-2-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110643252158500 Content-Type: text/plain; charset="utf-8" A few slipped in during the mass conversion, get those too. Mostly trivial conversion, with the exception of @x-qemu-io which introduces a new split. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block.json | 5 +++-- qapi/machine-s390x.json | 3 +-- qapi/machine.json | 3 +-- qapi/net.json | 24 ++++++++---------------- 4 files changed, 13 insertions(+), 22 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 13c47e1eb44..0a88d405a26 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -597,9 +597,10 @@ =20 ## # @x-qemu-io: +# Run a qemu-io command on a block device. # -# Run a qemu-io command on a block device. Take either a block -# backend name or a qdev ID to identify the device. +# Take either a block backend name or a qdev ID to identify the +# device. # # @device: the block backend name, node-name to run the # command on. diff --git a/qapi/machine-s390x.json b/qapi/machine-s390x.json index 670a1f9d926..8d8cbe2fb75 100644 --- a/qapi/machine-s390x.json +++ b/qapi/machine-s390x.json @@ -138,8 +138,7 @@ =20 ## # @BootCertificates: -# -# Boot certificates for secure IPL. +# Boot certificates for secure IPL. # # @path: path to an X.509 certificate file or a directory containing # certificate files. diff --git a/qapi/machine.json b/qapi/machine.json index 1220116bf7d..6eb14c62851 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1390,8 +1390,7 @@ =20 ## # @SpMemDeviceInfo: -# -# sp-mem device state information +# sp-mem device state information # # @id: device's ID # diff --git a/qapi/net.json b/qapi/net.json index 2a186a71b93..f0312dfb714 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -1275,8 +1275,7 @@ =20 ## # @UsernetInfo: -# -# Information about a user-mode network stack (slirp). +# Information about a user-mode network stack (slirp). # # @hub-id: The hub id, if available. # @@ -1295,8 +1294,7 @@ =20 ## # @x-query-usernet: -# -# Query user-mode network stack connection states. +# Query user-mode network stack connection states. # # Features: # @@ -1319,8 +1317,7 @@ =20 ## # @NetFilterInfo: -# -# Information about a netfilter attached to a network client. +# Information about a netfilter attached to a network client. # # @name: filter object name (QOM path component) # @@ -1339,8 +1336,7 @@ =20 ## # @NetworkClientInfo: -# -# Information about a network client. +# Information about a network client. # # @name: unique network client identifier # @@ -1369,8 +1365,7 @@ =20 ## # @NetHubPortInfo: -# -# Information about a hub port. +# Information about a hub port. # # @name: hub port identifier # @@ -1385,8 +1380,7 @@ =20 ## # @NetHubInfo: -# -# Information about a network hub. +# Information about a network hub. # # @id: hub identifier # @@ -1401,8 +1395,7 @@ =20 ## # @NetworkInfo: -# -# Information about the network configuration. +# Information about the network configuration. # # @hubs: network hubs and their ports # @@ -1417,8 +1410,7 @@ =20 ## # @x-query-network: -# -# Query the network configuration including hubs and clients. +# Query the network configuration including hubs and clients. # # Features: # --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110628; cv=none; d=zohomail.com; s=zohoarc; b=NmEo2keYU7uWQceYvJYHr3oTzb8P+sKY/2kNOTNq0USgC0gnKUOk4/te7REMbu1RTXLPFrW9RE1a7fx0FK13P0nQkZv5cqjLpqjNSh+FEfGmhCpnSPgXrBqWTad4DRuy3kyqeUfw6DKPFpX613lmRFLlVhidH3lEJwC7jOHIekM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110628; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=XK1aSGSt1xTWF7/Prx8zJTaU+O+Uyrct5dy+1HkNSpU=; b=CTkRxsId2KtX3O5QkcOTW8MN/e5yzzSQsGOemyKRAjXnkpxm0fF4EZX8r1a6GK4Cp5G3QUgZ6g1F9NGDySSu2ERABIw2lgU+1LguHcekONv3QlmF8EFOSIr6/VKEjV/nRBNbm9lvp/1WZKJ6mYZrWQFAYxaHardZHxFwFcmaYjA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110628245514.7050039439679; Tue, 22 Sep 2026 13:57:08 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Xb-0000Iw-7i; Tue, 22 Sep 2026 16:56:39 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XT-0000Gi-Qn for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:33 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XS-00045l-CQ for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:31 -0400 Received: from mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-86-MvC125T2PFWCF9OmYGe4Bw-1; Tue, 22 Sep 2026 16:56:24 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 8621B1800BCE; Tue, 22 Sep 2026 20:56:22 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5CF421956086; Tue, 22 Sep 2026 20:56:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110589; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=XK1aSGSt1xTWF7/Prx8zJTaU+O+Uyrct5dy+1HkNSpU=; b=CzB3fo+orkxLKqKwtHxFK1CDWfj0N8NOPBFfOM9xD7c77vKj0BxlvgxZ9hw1OZJTPdiYjw h8JI5aJ9l4e18m9Ux4lw3oU1RYq8wRabT9x/3KSdi2BTPb3v5ibYjFHCXCZu9HwebUkZE8 SO9Rsh4yeYA+vXdbJY7VETJnhk/Zm6c= X-MC-Unique: MvC125T2PFWCF9OmYGe4Bw-1 X-Mimecast-MFC-AGG-ID: MvC125T2PFWCF9OmYGe4Bw_1790110583 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 2/8] qapi: convert intro sections for unit tests Date: Tue, 22 Sep 2026 16:55:59 -0400 Message-ID: <20260922205605.501602-3-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110631439158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- tests/qapi-schema/doc-good.json | 8 ++++---- tests/qapi-schema/doc-good.out | 15 ++++++--------- tests/qapi-schema/doc-interleaved-section.err | 2 +- tests/qapi-schema/doc-interleaved-section.json | 3 +-- 4 files changed, 12 insertions(+), 16 deletions(-) diff --git a/tests/qapi-schema/doc-good.json b/tests/qapi-schema/doc-good.j= son index fac13425b72..d9a84ccd729 100644 --- a/tests/qapi-schema/doc-good.json +++ b/tests/qapi-schema/doc-good.json @@ -94,10 +94,9 @@ =20 ## # @Variant1: +# A paragraph # -# A paragraph -# -# Another paragraph +# Another paragraph # # @var1 is undocumented # @@ -206,7 +205,8 @@ =20 ## # @cmd-boxed: -# If you're bored enough to read this, go see a video of boxed cats +# If you're bored enough to read this, go see a video of boxed +# cats # # Features: # @cmd-feat1: a feature diff --git a/tests/qapi-schema/doc-good.out b/tests/qapi-schema/doc-good.out index 371dd25ffc7..eaaf119dea8 100644 --- a/tests/qapi-schema/doc-good.out +++ b/tests/qapi-schema/doc-good.out @@ -126,15 +126,13 @@ doc symbol=3DBase minimally indented doc symbol=3DVariant1 Intro + A paragraph =20 - Plain -A paragraph - -Another paragraph - -@var1 is undocumented + Another paragraph Member=3Dvar1 =20 + Plain +@var1 is undocumented Feature=3Dvariant1-feat a feature Feature=3Dmember-feat @@ -213,9 +211,8 @@ Note:: 2.10 doc symbol=3Dcmd-boxed Intro - - Plain -If you're bored enough to read this, go see a video of boxed cats + If you're bored enough to read this, go see a video of boxed + cats Feature=3Dcmd-feat1 a feature Feature=3Dcmd-feat2 diff --git a/tests/qapi-schema/doc-interleaved-section.err b/tests/qapi-sch= ema/doc-interleaved-section.err index e5d1ef54c1b..85f01fa57a7 100644 --- a/tests/qapi-schema/doc-interleaved-section.err +++ b/tests/qapi-schema/doc-interleaved-section.err @@ -1 +1 @@ -doc-interleaved-section.json:15:1: description of '@foobar:' follows a sec= tion +doc-interleaved-section.json:14:1: description of '@foobar:' follows a sec= tion diff --git a/tests/qapi-schema/doc-interleaved-section.json b/tests/qapi-sc= hema/doc-interleaved-section.json index eec01ed5650..bc0937b8601 100644 --- a/tests/qapi-schema/doc-interleaved-section.json +++ b/tests/qapi-schema/doc-interleaved-section.json @@ -2,8 +2,7 @@ =20 ## # @TestStruct: -# -# body +# body # # @integer: foo # blah --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110709; cv=none; d=zohomail.com; s=zohoarc; b=R1e6xVtKEh/EqmRv0GGUwW+N30Og+XQp94AW5yXE6RQbBHOQmIyitpcsrDfQxaZavSKOXHAQBgEgTKmX1aStrl0IvhhqQYezr16g5Fx+k5Sbfkd6CMsuY5s0wWCqu+gbsy+QVTwkgacC6QXaqLYvOH489gCj2nIU6kTwDUzJBII= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110709; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=5gN993fdzIrodL0oCE+Xx9RLSQHyCaqE50JE7Y/kbs8=; b=DYpoTmN8zTRHG7EwXGySXjjqysAZAMuRZfcS1O/6a6hdixYXAju3qAla2EXpT+y3bI7bE6bcEZu/nRUe70bxjB7aYEDs49u+vVYHDpGjAvsz3u8YOGmLha+um66Xi75pD0nO/DMyKvBgkmBCfOmEt/wv+TbgfWkHlDU6Covk0ZI= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110709098930.8881794910325; Tue, 22 Sep 2026 13:58:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Xq-0000Py-Ph; Tue, 22 Sep 2026 16:56:59 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XX-0000Hl-Ku for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:37 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XU-000461-9S for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:34 -0400 Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-255-xn8LWe7cMMudj4R7WIzWjw-1; Tue, 22 Sep 2026 16:56:28 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 21FA9193E886; Tue, 22 Sep 2026 20:56:26 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id C977D1956087; Tue, 22 Sep 2026 20:56:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110591; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=5gN993fdzIrodL0oCE+Xx9RLSQHyCaqE50JE7Y/kbs8=; b=gB59f0O9wCt9ERiptz4NOyyDt47JDuS3hnOtdMcIkhhMOMHmxGTIh/RutMCS3YCM8Qp1Dm SrwuQEKCNbCbWJ16mOoTmg6yhLtbqWvvaTDI1tUPUmYOsf/tGPA9aAMhewjvOEUGtODMop 1PYOX9i8K4OLXLNT8F/SI2m1hLzyubo= X-MC-Unique: xn8LWe7cMMudj4R7WIzWjw-1 X-Mimecast-MFC-AGG-ID: xn8LWe7cMMudj4R7WIzWjw_1790110586 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 3/8] qapi: convert trivial intros for qga/qapi-schema.json Date: Tue, 22 Sep 2026 16:56:00 -0400 Message-ID: <20260922205605.501602-4-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110709633158500 Content-Type: text/plain; charset="utf-8" These are all single-sentence introductions immediately followed by a non-plaintext section; no new insertion point is created. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qga/qapi-schema.json | 137 +++++++++++++++---------------------------- 1 file changed, 48 insertions(+), 89 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index 8cd0ba048b8..90110af5730 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -120,8 +120,7 @@ =20 ## # @guest-ping: -# -# Ping the guest agent, a non-error return implies success +# Ping the guest agent, a non-error return implies success # # Since: 0.15.0 ## @@ -129,9 +128,8 @@ =20 ## # @guest-get-time: -# -# Get the information about guest's System Time relative to the Epoch -# of 1970-01-01 in UTC. +# Get the information about guest's System Time relative to the +# Epoch of 1970-01-01 in UTC. # # Returns: Time in nanoseconds. # @@ -168,8 +166,7 @@ =20 ## # @GuestAgentCommandInfo: -# -# Information about guest agent commands. +# Information about guest agent commands. # # @name: name of the command # @@ -185,8 +182,7 @@ =20 ## # @GuestAgentInfo: -# -# Information about guest agent. +# Information about guest agent. # # @version: guest agent version # @@ -200,8 +196,7 @@ =20 ## # @guest-info: -# -# Get some information about the guest agent. +# Get some information about the guest agent. # # Since: 0.15.0 ## @@ -228,8 +223,7 @@ =20 ## # @guest-file-open: -# -# Open a file in the guest and retrieve a file handle for it +# Open a file in the guest and retrieve a file handle for it # # @path: Full path to the file in the guest to open. # @@ -245,8 +239,7 @@ =20 ## # @guest-file-close: -# -# Close an open file in the guest +# Close an open file in the guest # # @handle: filehandle returned by `guest-file-open` # @@ -257,8 +250,7 @@ =20 ## # @GuestFileRead: -# -# Result of guest agent file-read operation +# Result of guest agent file-read operation # # @count: number of bytes read (note: count is *before* # base64-encoding is applied) @@ -292,8 +284,7 @@ =20 ## # @GuestFileWrite: -# -# Result of guest agent file-write operation +# Result of guest agent file-write operation # # @count: number of bytes written (note: count is actual bytes # written, after base64-decoding of provided buffer) @@ -307,8 +298,7 @@ =20 ## # @guest-file-write: -# -# Write to an open file in the guest. +# Write to an open file in the guest. # # @handle: filehandle returned by `guest-file-open` # @@ -325,8 +315,7 @@ =20 ## # @GuestFileSeek: -# -# Result of guest agent file-seek operation +# Result of guest agent file-seek operation # # @position: current file position # @@ -339,8 +328,7 @@ =20 ## # @QGASeek: -# -# Symbolic names for use in `guest-file-seek` +# Symbolic names for use in `guest-file-seek` # # @set: Set to the specified offset (same effect as 'whence':0) # @@ -354,8 +342,7 @@ =20 ## # @GuestFileWhence: -# -# Controls the meaning of offset to `guest-file-seek`. +# Controls the meaning of offset to `guest-file-seek`. # # @value: Integral value (0 for set, 1 for cur, 2 for end), available # for historical reasons, and might differ from the host's or @@ -390,8 +377,7 @@ =20 ## # @guest-file-flush: -# -# Write file changes buffered in userspace to disk/kernel buffers +# Write file changes buffered in userspace to disk/kernel buffers # # @handle: filehandle returned by `guest-file-open` # @@ -402,8 +388,7 @@ =20 ## # @GuestFsfreezeStatus: -# -# An enumeration of filesystem freeze states +# An enumeration of filesystem freeze states # # @thawed: filesystems thawed/unfrozen # @@ -476,8 +461,7 @@ =20 ## # @guest-fsfreeze-thaw: -# -# Unfreeze all frozen guest filesystems +# Unfreeze all frozen guest filesystems # # Returns: Number of file systems thawed by this call # @@ -524,8 +508,8 @@ =20 ## # @guest-fstrim: -# -# Discard (or "trim") blocks which are not in use by the filesystem. +# Discard (or "trim") blocks which are not in use by the +# filesystem. # # @minimum: Minimum contiguous free range to discard, in bytes. Free # ranges smaller than this may be ignored (this is a hint and the @@ -649,8 +633,7 @@ =20 ## # @GuestIpAddressType: -# -# An enumeration of supported IP address types +# An enumeration of supported IP address types # # @ipv4: IP version 4 # @@ -735,8 +718,7 @@ =20 ## # @guest-network-get-interfaces: -# -# Get list of guest IP addresses, MAC addresses and netmasks. +# Get list of guest IP addresses, MAC addresses and netmasks. # # Since: 1.1 ## @@ -782,9 +764,8 @@ =20 ## # @guest-set-vcpus: -# -# Attempt to reconfigure (currently: enable/disable) logical -# processors inside the guest. +# Attempt to reconfigure (currently: enable/disable) logical +# processors inside the guest. # # @vcpus: The logical processors to be reconfigured. This list is # processed node by node in order. In each node @logical-id is @@ -825,8 +806,7 @@ =20 ## # @GuestDiskBusType: -# -# An enumeration of bus type of disks +# An enumeration of bus type of disks # # @ide: IDE disks # @@ -984,8 +964,7 @@ =20 ## # @GuestDiskSmart: -# -# Disk type related smart information. +# Disk type related smart information. # # @type: disk bus type # @@ -1147,8 +1126,7 @@ =20 ## # @GuestMemoryBlockResponseType: -# -# An enumeration of memory block operation result. +# An enumeration of memory block operation result. # # @success: the operation of online/offline memory block is # successful. @@ -1191,9 +1169,8 @@ =20 ## # @guest-set-memory-blocks: -# -# Attempt to reconfigure (currently: enable/disable) state of memory -# blocks inside the guest. +# Attempt to reconfigure (currently: enable/disable) state of +# memory blocks inside the guest. # # @mem-blks: The memory blocks to be reconfigured. This list is # processed node by node in order. In each node @phys-index is @@ -1236,8 +1213,7 @@ =20 ## # @guest-get-memory-block-info: -# -# Get information relating to guest memory blocks. +# Get information relating to guest memory blocks. # # Since: 2.3 ## @@ -1303,8 +1279,7 @@ =20 ## # @GuestExecCaptureOutputMode: -# -# An enumeration of `guest-exec` capture modes. +# An enumeration of `guest-exec` capture modes. # # @none: do not capture any output # @@ -1326,8 +1301,7 @@ =20 ## # @GuestExecCaptureOutput: -# -# Controls what `guest-exec` output gets captures. +# Controls what `guest-exec` output gets captures. # # @flag: captures both stdout and stderr if true. Equivalent to # `GuestExecCaptureOutputMode`::all. (since 2.5) @@ -1342,8 +1316,7 @@ =20 ## # @guest-exec: -# -# Execute a command in the guest +# Execute a command in the guest # # @path: path or executable name to execute # @@ -1411,8 +1384,7 @@ =20 ## # @guest-get-users: -# -# Retrieves a list of currently active users on the VM. +# Retrieves a list of currently active users on the VM. # # Returns: A unique list of users. # @@ -1438,8 +1410,7 @@ =20 ## # @guest-get-timezone: -# -# Retrieves the timezone information from the guest. +# Retrieves the timezone information from the guest. # # Since: 2.10 ## @@ -1512,8 +1483,7 @@ =20 ## # @guest-get-osinfo: -# -# Retrieve guest operating system information +# Retrieve guest operating system information # # Since: 2.10 ## @@ -1544,8 +1514,7 @@ =20 ## # @GuestDeviceId: -# -# Id of the device +# Id of the device # # @type: device type # @@ -1581,8 +1550,7 @@ =20 ## # @guest-get-devices: -# -# Retrieve information about device drivers in Windows guest +# Retrieve information about device drivers in Windows guest # # Since: 5.2 ## @@ -1605,9 +1573,8 @@ =20 ## # @guest-ssh-get-authorized-keys: -# -# Return the public keys from user .ssh/authorized_keys on Unix -# systems (not implemented for other systems). +# Return the public keys from user .ssh/authorized_keys on Unix +# systems (not implemented for other systems). # # @username: the user account to add the authorized keys # @@ -1620,9 +1587,8 @@ =20 ## # @guest-ssh-add-authorized-keys: -# -# Append public keys to user .ssh/authorized_keys on Unix systems (not -# implemented for other systems). +# Append public keys to user .ssh/authorized_keys on Unix systems +# (not implemented for other systems). # # @username: the user account to add the authorized keys # @@ -1736,8 +1702,7 @@ =20 ## # @guest-get-diskstats: -# -# Retrieve information about disk stats. +# Retrieve information about disk stats. # # Returns: List of disk stats of guest. # @@ -1750,8 +1715,7 @@ =20 ## # @GuestCpuStatsType: -# -# Guest operating systems supporting CPU statistics +# Guest operating systems supporting CPU statistics # # @linux: Linux # @@ -1763,8 +1727,7 @@ =20 ## # @GuestLinuxCpuStats: -# -# CPU statistics of Linux +# CPU statistics of Linux # # @cpu: CPU index in guest OS # @@ -1808,8 +1771,7 @@ =20 ## # @GuestCpuStats: -# -# Get statistics of each CPU in millisecond. +# Get statistics of each CPU in millisecond. # # @type: guest operating system # @@ -1823,8 +1785,7 @@ =20 ## # @guest-get-cpustats: -# -# Retrieve information about CPU stats. +# Retrieve information about CPU stats. # # Returns: List of CPU stats of guest. # @@ -1837,8 +1798,7 @@ =20 ## # @GuestLoadAverage: -# -# Statistics about process load information +# Statistics about process load information # # @load1m: 1-minute load avage # @@ -1941,8 +1901,7 @@ =20 ## # @guest-network-get-route: -# -# Retrieve information about route of network. +# Retrieve information about route of network. # # Returns: List of route info of guest. # --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110661; cv=none; d=zohomail.com; s=zohoarc; b=Y6LSR/IA7BbD3CfaJ2gPu473QXg6QIz1ZPxJB2PkuBHxsvJTV0RPH6S31iPIEOwgobgL3yHrx8YowhfSgQy740fPJae9/Fo8ohu0yIVZVGZc64Xv0wO0se9xJQ0XZ3j3d4FXRSXDtPEwhuYQCUCxpAORFjy0JPP1oLSBbtCR6uA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110661; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=jiuQzypKOo2UN4XSnEnDQmXYroFTjnqbNw1e7bjBSrs=; b=IdMBZjeuMASyk1KpBBzdHz22CC3JyYVvRZUCRe6MzcZwqMO8k3uOMG/mhBPxJl3CCODt6gZSweamL+ohQKRcuLo3L1jJvczsV452Jw3t1LuWvPfkDFyG5whRt0BR0TyD8WkPrs8kfaSfbBRAKityJw11h9aQIHBIFlpwXXbMvvw= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110661445287.4057622170859; Tue, 22 Sep 2026 13:57:41 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Xk-0000Oz-Uk; Tue, 22 Sep 2026 16:56:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xb-0000JG-Aj for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:40 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97XY-00046e-Fz for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:37 -0400 Received: from mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-209-8ByOnC5vP6WeKUPZWXEW7w-1; Tue, 22 Sep 2026 16:56:31 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 5AE8519560BB; Tue, 22 Sep 2026 20:56:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 62ED21956086; Tue, 22 Sep 2026 20:56:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110595; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=jiuQzypKOo2UN4XSnEnDQmXYroFTjnqbNw1e7bjBSrs=; b=SDejb2cAdhMn6ZSTKBRAxrzAyEg3C0kWVSBEax/AMtgkGeDr/oDWO74JZJ4uCNRuheGnXo EsuysVlgis2ddoUR3MtQlvVOOLHkWQ8sPm1bSYxicwYruVkbET14JEP/tWTdg8OCtB0ZSK 4S+rbjnlzhcQBjoRMS9i17pILaEVHZ0= X-MC-Unique: 8ByOnC5vP6WeKUPZWXEW7w-1 X-Mimecast-MFC-AGG-ID: 8ByOnC5vP6WeKUPZWXEW7w_1790110589 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 4/8] qapi: convert simple intros for qga/qapi-schema.json Date: Tue, 22 Sep 2026 16:56:01 -0400 Message-ID: <20260922205605.501602-5-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110663425158500 Content-Type: text/plain; charset="utf-8" These are all single-paragraph introductions immediately followed by a non-plaintext section, so no new insertion point is created by this conversion. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qga/qapi-schema.json | 40 ++++++++++++++++++---------------------- 1 file changed, 18 insertions(+), 22 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index 90110af5730..b592b14a011 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -205,9 +205,9 @@ =20 ## # @guest-shutdown: -# -# Initiate guest-activated shutdown. Note: this is an asynchronous -# shutdown request, with no guarantee of successful shutdown. +# Initiate guest-activated shutdown. Note: this is an +# asynchronous shutdown request, with no guarantee of successful +# shutdown. # # @mode: "halt", "powerdown" (default), or "reboot" # @@ -266,10 +266,10 @@ =20 ## # @guest-file-read: -# -# Read from an open file in the guest. Data will be base64-encoded. -# As this command is just for limited, ad-hoc debugging, such as log -# file access, the number of bytes to read is limited to 48 MB. +# Read from an open file in the guest. Data will be +# base64-encoded. As this command is just for limited, ad-hoc +# debugging, such as log file access, the number of bytes to read +# is limited to 48 MB. # # @handle: filehandle returned by `guest-file-open` # @@ -357,10 +357,9 @@ =20 ## # @guest-file-seek: -# -# Seek to a position in the file, as with fseek(), and return the -# current file position afterward. Also encapsulates ftell()'s -# functionality, with offset=3D0 and whence=3D1. +# Seek to a position in the file, as with fseek(), and return the +# current file position afterward. Also encapsulates ftell()'s +# functionality, with offset=3D0 and whence=3D1. # # @handle: filehandle returned by `guest-file-open` # @@ -1254,10 +1253,9 @@ =20 ## # @guest-exec-status: -# -# Check status of process associated with PID retrieved via -# `guest-exec`. Reap the process and associated metadata if it has -# exited. +# Check status of process associated with PID retrieved via +# `guest-exec`. Reap the process and associated metadata if it +# has exited. # # @pid: pid returned from `guest-exec` # @@ -1605,10 +1603,9 @@ =20 ## # @guest-ssh-remove-authorized-keys: -# -# Remove public keys from the user .ssh/authorized_keys on Unix -# systems (not implemented for other systems). It's not an error if -# the key is already missing. +# Remove public keys from the user .ssh/authorized_keys on Unix +# systems (not implemented for other systems). It's not an error +# if the key is already missing. # # @username: the user account to remove the authorized keys # @@ -1838,9 +1835,8 @@ =20 ## # @GuestNetworkRoute: -# -# Route information. Supported on Linux (since 9.1) and Windows -# (since 11.0). +# Route information. Supported on Linux (since 9.1) and Windows +# (since 11.0). # # @iface: The destination network or host's egress network interface # in the routing table --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110697; cv=none; d=zohomail.com; s=zohoarc; b=Iajo8nUbXCy4eSjHzQjGkhFkv4pT8Zr/o0vsjtgrSGzzKcdNzhVD/8DbEz2fv5szmH7ZPf/5zuBkvWpjjfN7cmmWhAyUaXPiNIbajJXCQjuHpljm2g2oheHT2mX6r6gsU5nfLh7u91KcTW+aapWmvkvDU5m9XbBGQO9ZCj2/tQ4= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110697; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=SVKoXCiUlqOAS/0KYnSHA7TIvXWU/E1ZDQu+rckw7oo=; b=Yu1JXyXyOhn7yqYlrsgl1Ki8lA/oDwlCJdaGV4w/n3a57pIEHZoDtyCv65O6uSh9n35P6ujjpPrSaw2CfwfFup34WhvPfxvGHjRxa81Jq7mxIEorfsUxNdTZeVC5AGVMZSboh/KUOkb3iJzEaoVeUHkh3nCHfkHzk7Qj7LTyqw0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110697139410.8421020110916; Tue, 22 Sep 2026 13:58:17 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Yg-0000kQ-S5; Tue, 22 Sep 2026 16:57:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xd-0000LE-N0 for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:42 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.129.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xb-000475-Ij for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:41 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-133-U2zqS24VMxqYKiZdIqknXA-1; Tue, 22 Sep 2026 16:56:34 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id DCB35195DE4F; Tue, 22 Sep 2026 20:56:32 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 94CE01956086; Tue, 22 Sep 2026 20:56:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110598; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=SVKoXCiUlqOAS/0KYnSHA7TIvXWU/E1ZDQu+rckw7oo=; b=JEglS6ovB+EyWXBXXfcqlgs3IJveBGVB8J7SoTtCP6gvRGz1/cipzKwvkcGyoQw7fIgC3+ Bpx831pYf/22omRYCSEvk1Ej4xhWjqkgg/KUrAHAz5L4viYPAOG5xEaTjOfaANOs9odqvv iQSgGHp5t9GhUjxMzwC5d76LC1y4LZk= X-MC-Unique: U2zqS24VMxqYKiZdIqknXA-1 X-Mimecast-MFC-AGG-ID: U2zqS24VMxqYKiZdIqknXA_1790110593 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 5/8] qapi: split intros at natural cutoff points for qga/qapi-schema.json Date: Tue, 22 Sep 2026 16:56:02 -0400 Message-ID: <20260922205605.501602-6-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110699329158500 Content-Type: text/plain; charset="utf-8" Note that these intro conversions introduce a new intro/details split point. This new split point may or may not change the rendered output depending on if any documentation is auto-generated and inserted for this definition. This has tangible effects on how @guest-fsfreeze-status documentation is rendered, while the other two appear unchanged. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qga/qapi-schema.json | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index b592b14a011..19b0958b84e 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -401,8 +401,7 @@ =20 ## # @guest-fsfreeze-status: -# -# Get guest fsfreeze state. +# Get guest fsfreeze state. # # .. note:: This may fail to properly report the current state as a # result of some other guest processes having issued an fs @@ -925,9 +924,8 @@ =20 ## # @GuestNVMeSmart: -# -# NVMe smart information, based on NVMe specification, section -# +# NVMe smart information, based on NVMe specification, section +# # # TODO: document members briefly # @@ -1816,8 +1814,7 @@ =20 ## # @guest-get-load: -# -# Retrieve CPU process load information +# Retrieve CPU process load information # # .. note:: Windows does not have load average API, so QGA emulates it # by calculating the average CPU usage in the last 1, 5, 15 minutes --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110709; cv=none; d=zohomail.com; s=zohoarc; b=baglwlNVm3YnXWdWuOfL2gmlSeBnTyPGb9D6yxS9KLlQTDThhZfKvCjpDgKmMEJM4ZtzCWGat4Q4cuYlvFo9PqYiF5qOZk2B4P8s9V5vuqpIEkG8stkVt8L6JFqYxPUkV2Jh5t0EtrqLpLVwJ9fxNeQrTbquG5KLsjppLr95k9M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110709; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=e74AjzVYAvqbY//GzxliaSnz/JXsu67MDAvHJ55yQ7k=; b=e+iFINbQFnM7NVyZx0RgzojWpsrO6c0Y7B6vwZJmMqusVptGmguVH1TB7uWkAsJRHoG+R+xVkTI5MEmAZRzJf2BN0J4DCelfjJWQbOGnvAdgZril48OHW/+uqvyMRjaTUTILHBlk9OrkmqS69V8lFOQZydeksVvHlpFd1Xuw9lA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110709074406.2611618578561; Tue, 22 Sep 2026 13:58:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Yw-0000yZ-Bn; Tue, 22 Sep 2026 16:58:04 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xg-0000Na-2S for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:44 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xe-00047y-DA for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:43 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-60-d3KusHAeOIe10K8ZPyMs-w-1; Tue, 22 Sep 2026 16:56:38 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 41035195DE23; Tue, 22 Sep 2026 20:56:36 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 254FB1956086; Tue, 22 Sep 2026 20:56:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110601; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=e74AjzVYAvqbY//GzxliaSnz/JXsu67MDAvHJ55yQ7k=; b=bwx1oq05u1yhEmI2ItqfOo/4PIyMZ5e5lfldZZq/lK4U55PR7R96P7i4gB21+iDcKtwZRj jha+PGHp3hi/m110uPl/AuiJ8e6kLvIVbJLp2QW0O09sSb7AbjkYdEKipccxNmDqIJKaXG 28H9GC9ysW5Q0qzZYsTat9PoZR0uNMQ= X-MC-Unique: d3KusHAeOIe10K8ZPyMs-w-1 X-Mimecast-MFC-AGG-ID: d3KusHAeOIe10K8ZPyMs-w_1790110596 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 6/8] qapi: split intros for qga/qapi-schema.json Date: Tue, 22 Sep 2026 16:56:03 -0400 Message-ID: <20260922205605.501602-7-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110711440158500 Content-Type: text/plain; charset="utf-8" These intro section conversions all create a new insertion point that follow the introduction, but precede what now constitutes the details text. Like other intro section conversions, the details text will be moved en-masse in a later patch. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qga/qapi-schema.json | 61 +++++++++++++++++++------------------------- 1 file changed, 26 insertions(+), 35 deletions(-) diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json index 19b0958b84e..05fe4ea484d 100644 --- a/qga/qapi-schema.json +++ b/qga/qapi-schema.json @@ -48,9 +48,8 @@ =20 ## # @guest-sync-delimited: -# -# Echo back a unique integer value, and prepend to response a leading -# sentinel byte (0xFF) the client can check scan for. +# Echo back a unique integer value, and prepend to response a +# leading sentinel byte (0xFF) the client can check scan for. # # This is used by clients talking to the guest agent over the wire to # ensure the stream is in sync and doesn't contain stale data from @@ -83,8 +82,7 @@ =20 ## # @guest-sync: -# -# Echo back a unique integer value +# Echo back a unique integer value # # This is used by clients talking to the guest agent over the wire to # ensure the stream is in sync and doesn't contain stale data from @@ -140,8 +138,7 @@ =20 ## # @guest-set-time: -# -# Set guest time. +# Set guest time. # # When a guest is paused or migrated to a file then loaded from that # file, the guest OS has no idea that there was a big gap in the time. @@ -415,14 +412,14 @@ =20 ## # @guest-fsfreeze-freeze: +# Sync and freeze all freezable, local guest filesystems. If this +# command succeeded, you may call `guest-fsfreeze-thaw` later to +# unfreeze. # -# Sync and freeze all freezable, local guest filesystems. If this -# command succeeded, you may call `guest-fsfreeze-thaw` later to -# unfreeze. -# -# On error, all filesystems will be thawed. If no filesystems are -# frozen as a result of this call, then `guest-fsfreeze-status` will -# remain "thawed" and calling `guest-fsfreeze-thaw` is not necessary. +# On error, all filesystems will be thawed. If no filesystems are +# frozen as a result of this call, then `guest-fsfreeze-status` +# will remain "thawed" and calling `guest-fsfreeze-thaw` is not +# necessary. # # Returns: Number of file systems currently frozen. # @@ -438,11 +435,10 @@ =20 ## # @guest-fsfreeze-freeze-list: +# Sync and freeze specified guest filesystems. See also +# `guest-fsfreeze-freeze`. # -# Sync and freeze specified guest filesystems. See also -# `guest-fsfreeze-freeze`. -# -# On error, all filesystems will be thawed. +# On error, all filesystems will be thawed. # # @mountpoints: an array of mountpoints of filesystems to be frozen. # If omitted, every mounted filesystem is frozen. Invalid mount @@ -528,8 +524,7 @@ =20 ## # @guest-suspend-disk: -# -# Suspend guest to disk. +# Suspend guest to disk. # # This command attempts to suspend the guest using three strategies, # in this order: @@ -558,8 +553,7 @@ =20 ## # @guest-suspend-ram: -# -# Suspend guest to ram. +# Suspend guest to ram. # # This command attempts to suspend the guest using three strategies, # in this order: @@ -595,8 +589,7 @@ =20 ## # @guest-suspend-hybrid: -# -# Save guest state to disk and suspend to ram. +# Save guest state to disk and suspend to ram. # # This command attempts to suspend the guest by executing, in this # order: @@ -746,10 +739,9 @@ =20 ## # @guest-get-vcpus: +# Retrieve the list of the guest's logical processors. # -# Retrieve the list of the guest's logical processors. -# -# This is a read-only operation. +# This is a read-only operation. # # Returns: The list of all VCPUs the guest knows about. Each VCPU is # put on the list exactly once, but their order is unspecified. @@ -1106,10 +1098,9 @@ =20 ## # @guest-get-memory-blocks: +# Retrieve the list of the guest's memory blocks. # -# Retrieve the list of the guest's memory blocks. -# -# This is a read-only operation. +# This is a read-only operation. # # Returns: The list of all memory blocks the guest knows about. Each # memory block is put on the list exactly once, but their order is @@ -1346,12 +1337,12 @@ =20 ## # @guest-get-host-name: +# Return a name for the machine. # -# Return a name for the machine. -# -# The returned name is not necessarily a fully-qualified domain name, -# or even present in DNS or some other name service at all. It need -# not even be unique on your local network or site, but usually it is. +# The returned name is not necessarily a fully-qualified domain +# name, or even present in DNS or some other name service at all. +# It need not even be unique on your local network or site, but +# usually it is. # # Returns: the host name of the machine # --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110697; cv=none; d=zohomail.com; s=zohoarc; b=mxiBlbn3Ra+7h4etHZVli+odWBokRBzhkGR5/oqBcZt4D47V2XuSi770FfCD2cvOwKiXbOI3x56BbaO5INwVohQju5NVqclBWXVjjp45ox5CRZodn+r+Qo/TF9xh/E9GmwVLZrRZJciJ71yQZ57jJaBsBsJ6nSZfVJldLiDxzTQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110697; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=xwFyc4zFN9EYqJtZf8lGRUeeM53lUzuwAg5LTlqUuaA=; b=CJ6ASevht1VUVZA25DIYEs3J19fCXTEl082uRfr/pyLWhtqEWrkyDhVexLSIYv0tBAY7edoWsnUgYESUZbuBTd3TPKVd6qKGW6mW9TtUsPJ7cA7R7JsAEoYIkN58atu/lhBsM4u5nJhsBUNa2NuJlEoKNfEcIaMxNqXh6iNb+ik= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110697881114.570282262874; Tue, 22 Sep 2026 13:58:17 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Yy-0000ys-6c; Tue, 22 Sep 2026 16:58:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xj-0000P0-5N for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:48 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xf-00048B-4I for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:45 -0400 Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-336-iWM0fvXSMx6fD6iVxogo5g-1; Tue, 22 Sep 2026 16:56:41 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 609011956064; Tue, 22 Sep 2026 20:56:39 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 63BF71956086; Tue, 22 Sep 2026 20:56:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110602; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=xwFyc4zFN9EYqJtZf8lGRUeeM53lUzuwAg5LTlqUuaA=; b=UAEQRTXcnn3eVOKD+x1ErBcBqf3orJZWcJA+9q6loeKRPWkPC0VY781QFDhlFhyxdJzY6b guI4SWMkm6wlcRS41rmt89sAhClip65P9xgjCD0LxY6A3Wx2TUXv+5vqtXfxdw2G8ZkakA Nlpo4QmfDzt9NkKitsMy6hR0pXU2pU4= X-MC-Unique: iWM0fvXSMx6fD6iVxogo5g-1 X-Mimecast-MFC-AGG-ID: iWM0fvXSMx6fD6iVxogo5g_1790110599 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 7/8] qapi: convert intro sections for docs/interop/firmware.json Date: Tue, 22 Sep 2026 16:56:04 -0400 Message-ID: <20260922205605.501602-8-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110699504158500 Content-Type: text/plain; charset="utf-8" All conversions in this patch do not create a new documentation insertion point, except for one at the very end. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- docs/interop/firmware.json | 76 ++++++++++++++++---------------------- 1 file changed, 31 insertions(+), 45 deletions(-) diff --git a/docs/interop/firmware.json b/docs/interop/firmware.json index 421bee0e5ed..1efd32c6315 100644 --- a/docs/interop/firmware.json +++ b/docs/interop/firmware.json @@ -23,9 +23,8 @@ =20 ## # @FirmwareOSInterface: -# -# Lists the firmware-OS interface types provided by various firmware -# that is commonly used with QEMU virtual machines. +# Lists the firmware-OS interface types provided by various +# firmware that is commonly used with QEMU virtual machines. # # @bios: Traditional x86 BIOS interface. For example, firmware built # from the SeaBIOS project usually provides this interface. @@ -49,8 +48,7 @@ =20 ## # @FirmwareDevice: -# -# Defines the device types that firmware can be mapped into. +# Defines the device types that firmware can be mapped into. # # @flash: The firmware executable and its accompanying NVRAM file are # to be mapped into a pflash chip each. @@ -75,9 +73,8 @@ =20 ## # @FirmwareArchitecture: -# -# Enumeration of architectures for which Qemu uses additional firmware -# files. +# Enumeration of architectures for which Qemu uses additional +# firmware files. # # @aarch64: 64-bit Arm. # @@ -98,8 +95,7 @@ =20 ## # @FirmwareTarget: -# -# Defines the machine types that firmware may execute on. +# Defines the machine types that firmware may execute on. # # @architecture: Determines the emulation target (the QEMU system # emulator) that can execute the firmware. @@ -121,9 +117,8 @@ =20 ## # @FirmwareFeature: -# -# Defines the features that firmware may support, and the platform -# requirements that firmware may present. +# Defines the features that firmware may support, and the platform +# requirements that firmware may present. # # @acpi-s3: The firmware supports S3 sleep (suspend to RAM), as # defined in the ACPI specification. On the "pc-i440fx-*" machine @@ -236,8 +231,7 @@ =20 ## # @FirmwareFormat: -# -# Formats that are supported for firmware images. +# Formats that are supported for firmware images. # # @raw: Raw disk image format. # @@ -250,12 +244,11 @@ =20 ## # @FirmwareFlashFile: -# -# Defines common properties that are necessary for loading a firmware -# file into a pflash chip. The corresponding QEMU command line option -# is "-drive file=3D@filename,format=3D@format". Note however that the -# option-argument shown here is incomplete; it is completed under -# @FirmwareMappingFlash. +# Defines common properties that are necessary for loading a +# firmware file into a pflash chip. The corresponding QEMU +# command line option is "-drive file=3D@filename,format=3D@format". +# Note however that the option-argument shown here is incomplete; +# it is completed under @FirmwareMappingFlash. # # @filename: Specifies the filename on the host filesystem where the # firmware file can be found. @@ -272,9 +265,8 @@ =20 ## # @FirmwareFlashMode: -# -# Describes how the firmware build handles code versus variable -# persistence. +# Describes how the firmware build handles code versus variable +# persistence. # # @split: the executable file contains code while the NVRAM template # provides variable storage. The executable must be configured @@ -298,9 +290,9 @@ =20 ## # @FirmwareMappingFlash: -# -# Describes loading and mapping properties for the firmware executable -# and its accompanying NVRAM file, when @FirmwareDevice is @flash. +# Describes loading and mapping properties for the firmware +# executable and its accompanying NVRAM file, when @FirmwareDevice +# is @flash. # # @mode: Describes how the firmware build handles code versus variable # storage. If not present, it must be treated as if it was @@ -357,9 +349,8 @@ =20 ## # @FirmwareMappingKernel: -# -# Describes loading and mapping properties for the firmware -# executable, when @FirmwareDevice is @kernel. +# Describes loading and mapping properties for the firmware +# executable, when @FirmwareDevice is @kernel. # # @filename: Identifies the firmware executable. The firmware # executable may be shared by multiple virtual machine @@ -373,9 +364,8 @@ =20 ## # @FirmwareMemoryUefiVars: -# -# Contains information needed to set up the "uefi-vars" device -# to provide UEFI variable store access to the firmware. +# Contains information needed to set up the "uefi-vars" device to +# provide UEFI variable store access to the firmware. # # @template: The path to the UEFI JSON variable store template # compatible with the firmware. Management software instantiates @@ -406,9 +396,8 @@ =20 ## # @FirmwareMappingMemory: -# -# Describes loading and mapping properties for the firmware -# executable, when @FirmwareDevice is @memory. +# Describes loading and mapping properties for the firmware +# executable, when @FirmwareDevice is @memory. # # @filename: Identifies the firmware executable. The firmware # executable may be shared by multiple virtual machine @@ -430,9 +419,8 @@ =20 ## # @FirmwareMappingIgvm: -# -# Describes loading and mapping properties for the firmware -# executable, when @FirmwareDevice is @igvm. +# Describes loading and mapping properties for the firmware +# executable, when @FirmwareDevice is @igvm. # # @filename: Identifies the IGVM file containing the firmware # executable along with other information used to configure the @@ -448,9 +436,8 @@ =20 ## # @FirmwareMapping: -# -# Provides a discriminated structure for firmware to describe its -# loading / mapping properties. +# Provides a discriminated structure for firmware to describe its +# loading / mapping properties. # # @device: Selects the device type that the firmware must be mapped # into. @@ -467,9 +454,8 @@ =20 ## # @Firmware: -# -# Describes a firmware (or a firmware use case) to management -# software. +# Describes a firmware (or a firmware use case) to management +# software. # # It is possible for multiple @Firmware elements to match the search # criteria of management software. Applications thus need rules to --=20 2.55.0 From nobody Sat Sep 26 20:00:48 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1790110721; cv=none; d=zohomail.com; s=zohoarc; b=jPxPEJEnwacrreXGT4Ffg2erwHYhMYHGzJIk4YbQQ8bpxIi1WyJdhnHcnZc3O2z5tz69L5HIv/IsCgzQ6ax7vEP6bwAAak0FyxlcYaPqBeKFsN9EfUkPAyK29OxCFrGpM2LsBgZpkMMWQLAE0e/U2abnLbUR1r83doALZTOHb4w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790110721; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=BbTXbi2v0zTkwi8r44EEN84EGkaiyjPWQ1x+oKv7biI=; b=eaNqZflsqnfYO05Q808qGFn6sc6rdTC4mp/2yzdRgCl+wMspThrsbrlXYWbGDfEy5Jfs3OasdJ8VYttMJLnPLHZ9Cy85fmNXlgOAZUaAZ4HN0ZQCn9rvb4+bFfmrOvE63RC7hMn2KCRu0A4UbCmYwCWYzlO2pA6Gqr729RJq9dA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1790110720953775.3726918491286; Tue, 22 Sep 2026 13:58:40 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x97Z7-0001VS-BZ; Tue, 22 Sep 2026 16:58:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xm-0000QP-5h for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:52 -0400 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1x97Xk-00048u-Kb for qemu-devel@nongnu.org; Tue, 22 Sep 2026 16:56:49 -0400 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-224-fMrrji4gOouXjD0GObZ1Rg-1; Tue, 22 Sep 2026 16:56:44 -0400 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 90F8018009FC; Tue, 22 Sep 2026 20:56:42 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 9C62E1956086; Tue, 22 Sep 2026 20:56:39 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790110607; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=BbTXbi2v0zTkwi8r44EEN84EGkaiyjPWQ1x+oKv7biI=; b=H8fL8DkgpRdhu+uC0YW4zxzFOdsZK8JZNP8D07+bJ7LiSVlXWIcHb3N0myGPmcdv8Ykt+/ DBB8+nqgXGY+pJZ8V9MEgz8+tW+r8oFyNv3Jdkq1xYV1OPiHm8Q2FGxnDZyRy6TGc2YMUm y1afO8u27EjEn06JwMPJ3aIWqHXcvRA= X-MC-Unique: fMrrji4gOouXjD0GObZ1Rg-1 X-Mimecast-MFC-AGG-ID: fMrrji4gOouXjD0GObZ1Rg_1790110602 From: John Snow To: qemu-devel@nongnu.org Cc: Laurent Vivier , Kostiantyn Kostiuk , "Michael S. Tsirkin" , Zhao Liu , Michael Roth , Pierrick Bouvier , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Jason Wang , qemu-trivial@nongnu.org, =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Stefano Garzarella , Kashyap Chamarthy , Eric Blake , Hanna Reitz , Markus Armbruster , Kevin Wolf , qemu-block@nongnu.org, Michael Tokarev , John Snow Subject: [PATCH v2 8/8] qapi: convert intro sections for docs/interop/vhost-user.json Date: Tue, 22 Sep 2026 16:56:05 -0400 Message-ID: <20260922205605.501602-9-jsnow@redhat.com> In-Reply-To: <20260922205605.501602-1-jsnow@redhat.com> References: <20260922205605.501602-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists1p.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=jsnow@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1790110721450158500 Content-Type: text/plain; charset="utf-8" All conversions in this patch do not add a new insertion point, except for the very last conversion. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- docs/interop/vhost-user.json | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/docs/interop/vhost-user.json b/docs/interop/vhost-user.json index 29c84e86e55..65e681a166a 100644 --- a/docs/interop/vhost-user.json +++ b/docs/interop/vhost-user.json @@ -17,8 +17,7 @@ =20 ## # @VHostUserBackendType: -# -# List the various vhost user backend types. +# List the various vhost user backend types. # # @9p: 9p virtio console # @@ -75,8 +74,7 @@ =20 ## # @VHostUserBackendBlockFeature: -# -# List of vhost user "block" features. +# List of vhost user "block" features. # # @read-only: The --read-only command line option is supported. # @@ -91,8 +89,7 @@ =20 ## # @VHostUserBackendCapabilitiesBlock: -# -# Capabilities reported by vhost user "block" backends +# Capabilities reported by vhost user "block" backends # # @features: list of supported features. # @@ -107,8 +104,7 @@ =20 ## # @VHostUserBackendInputFeature: -# -# List of vhost user "input" features. +# List of vhost user "input" features. # # @evdev-path: The --evdev-path command line option is supported. # @@ -123,8 +119,7 @@ =20 ## # @VHostUserBackendCapabilitiesInput: -# -# Capabilities reported by vhost user "input" backends +# Capabilities reported by vhost user "input" backends # # @features: list of supported features. # @@ -139,8 +134,7 @@ =20 ## # @VHostUserBackendGPUFeature: -# -# List of vhost user "gpu" features. +# List of vhost user "gpu" features. # # @render-node: The --render-node command line option is supported. # @@ -155,8 +149,7 @@ =20 ## # @VHostUserBackendCapabilitiesGPU: -# -# Capabilities reported by vhost user "gpu" backends. +# Capabilities reported by vhost user "gpu" backends. # # @features: list of supported features. # @@ -171,8 +164,7 @@ =20 ## # @VHostUserBackendCapabilities: -# -# Capabilities reported by vhost user backends. +# Capabilities reported by vhost user backends. # # @type: The vhost user backend type. # @@ -190,8 +182,7 @@ =20 ## # @VhostUserBackend: -# -# Describes a vhost user backend to management software. +# Describes a vhost user backend to management software. # # It is possible for multiple @VhostUserBackend elements to match the # search criteria of management software. Applications thus need --=20 2.55.0