From nobody Sat Sep 26 20:00:30 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=1790023991; cv=none; d=zohomail.com; s=zohoarc; b=S3mJsmvRCLGlWsadZ4qmHbAovhhd5CpM9K0SuaCFuBO/iuJ2TIYhn5hnCkuy0ptbo+zPuJD3U9cH+3IW7YpbCQkDG1beg3n0ciVgcriFuBsn9rm/uQoE+RbZvEnxBDcdD8uZ6FDDkRaXu5VihZcIzCyVsoC59kv0QavuHOvG9y8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790023991; 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=S89AtTXdNpjr2AAqPJOd1mhSmMhfH8axiJcWiyBL6aI=; b=iNyGHI0gZ194eFLsxPpbR4jXISCCY0d6yTkhDZKSJpkzyR+mtGlr7F+2vq4ni/vQxHlaYy1rHcRrt7O0wfN07HlzB2OREE+TSXJCc1y0tiac40frXI6/ROquXhcUdgHjJ11ZZ7i4v7ap9fFyhU37VoXgC32XX6qoWJHLbTxxSGg= 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 1790023991035434.6770822252786; Mon, 21 Sep 2026 13:53:11 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8kzu-00079R-JH; Mon, 21 Sep 2026 16:52:22 -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 1x8kzq-00078s-P2 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:18 -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 1x8kzh-0002Nf-DO for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:12 -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-226-fm4X7OtoPS6Rw-PmPkij-g-1; Mon, 21 Sep 2026 16:52:05 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 C2B8418558AD; Mon, 21 Sep 2026 20:52:02 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 9D32C41B; Mon, 21 Sep 2026 20:51:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023928; 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=S89AtTXdNpjr2AAqPJOd1mhSmMhfH8axiJcWiyBL6aI=; b=WS6Ymx8fDu+X5+//7vQbV9n1E6GT74auqr6KswnYmM/7CrkJog3OkizsUB3JHxUccjIlY5 OXwjUhOhEbGZ86NsnEhQgFDS6JXpWqiOUd56p4RNR+oT8c5u92UO9pMin8j+AoFWmVCk/P DxvvnMyiwt6OxgltHuV8nOUZ2Ves23A= X-MC-Unique: fm4X7OtoPS6Rw-PmPkij-g-1 X-Mimecast-MFC-AGG-ID: fm4X7OtoPS6Rw-PmPkij-g_1790023923 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 1/9] qapi: convert remaining simple sections Date: Mon, 21 Sep 2026 16:51:39 -0400 Message-ID: <20260921205147.1857168-2-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790023992194158500 Content-Type: text/plain; charset="utf-8" A few slipped in during the mass conversion, get those too. Signed-off-by: John Snow --- qapi/block.json | 5 ++--- qapi/machine-s390x.json | 3 +-- qapi/machine.json | 3 +-- qapi/net.json | 24 ++++++++---------------- 4 files changed, 12 insertions(+), 23 deletions(-) diff --git a/qapi/block.json b/qapi/block.json index 13c47e1eb44..68d4e47d911 100644 --- a/qapi/block.json +++ b/qapi/block.json @@ -597,9 +597,8 @@ =20 ## # @x-qemu-io: -# -# Run a qemu-io command on a block device. Take either a block -# backend name or a qdev ID to identify the device. +# Run a qemu-io command on a block 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:30 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=1790024071; cv=none; d=zohomail.com; s=zohoarc; b=RcnsFwQNBdRI3b5wPRwiCkjItvXqibbcn/Pp2SUP7vZ1QeLCf8d4xCzk/KwUOJ2Pgz73gUBtAlPeofNFxq3HkFuVMOJsCqJFQQrYecGvfSuTMjfhvR8jCJ1kGgAPwxdyl5WI9VVvni/4yGRNVHtmt2rh86VD8GCK5bJlSJ750gM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024071; 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=FB7yl4qp6AfR87nk3XwEQUDawns6VdJZVU1MgSX4vaA=; b=DNeiP+tQWfTNjJo1LDlLxzwdHf6e9v4KmP2pGAd+tC2000yAXzRWJBVSKSxrUZoUPdOHO/3ktU+MzFX8d88BVIsUTHeEH8pBGn/SrQWGvJmQOj2ZPSNx9Ij3r5ZtHcZ3vAlGsFMc9IsQvTYrqZ5EHaDYE2u/UiCc/SkN9Bjn2Yc= 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 1790024071912553.7980032814208; Mon, 21 Sep 2026 13:54:31 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l00-0007Bl-Ot; Mon, 21 Sep 2026 16:52:28 -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 1x8kzu-00079m-Vc for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:23 -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 1x8kzm-0002OD-Dv for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:19 -0400 Received: from mx-prod-mc-05.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-526-CXh-KcJSNrGcKLQniuV8cA-1; Mon, 21 Sep 2026 16:52:08 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 7613A1955F7B; Mon, 21 Sep 2026 20:52:06 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 060B9427; Mon, 21 Sep 2026 20:52:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023931; 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=FB7yl4qp6AfR87nk3XwEQUDawns6VdJZVU1MgSX4vaA=; b=QtcohUi5x/TnBrdvy4n9mJ0ZQ7zzIcuhbHyngaSl01MX3gyJJccI+kQc8AQpmql3bJpslx jhGPSdp1OS7eFPOieL8GZuMUlxN1nJ9TNpbXZf+35wk4F/8QwGiJn+pmDm/DPwISKWCb4K Gmk6UQOc8t7m2iYR3PJjxwn4ApV7r48= X-MC-Unique: CXh-KcJSNrGcKLQniuV8cA-1 X-Mimecast-MFC-AGG-ID: CXh-KcJSNrGcKLQniuV8cA_1790023926 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 2/9] qapi: convert intro sections for unit tests Date: Mon, 21 Sep 2026 16:51:40 -0400 Message-ID: <20260921205147.1857168-3-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024074337158500 Content-Type: text/plain; charset="utf-8" Signed-off-by: John Snow --- tests/qapi-schema/doc-good.json | 10 +++++----- tests/qapi-schema/doc-good.out | 13 +++++-------- 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..00721d5c522 100644 --- a/tests/qapi-schema/doc-good.json +++ b/tests/qapi-schema/doc-good.json @@ -94,12 +94,11 @@ =20 ## # @Variant1: +# A paragraph # -# A paragraph +# Another paragraph # -# Another paragraph -# -# @var1 is undocumented +# @var1 is undocumented # # Features: # @variant1-feat: a feature @@ -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..8c0818a3f0d 100644 --- a/tests/qapi-schema/doc-good.out +++ b/tests/qapi-schema/doc-good.out @@ -126,13 +126,11 @@ doc symbol=3DBase minimally indented doc symbol=3DVariant1 Intro + A paragraph =20 - Plain -A paragraph + Another paragraph =20 -Another paragraph - -@var1 is undocumented + @var1 is undocumented Member=3Dvar1 =20 Feature=3Dvariant1-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:30 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=1790024035; cv=none; d=zohomail.com; s=zohoarc; b=HDW93/zf0TdcHneZa36DH7eERl0mlLrp8drX6w6i7FmH3DGwtOcp+gAxs5ZWMEDtxVi5GP0ifOwFVfmVyBxwSuvZG8gN+6lUjBRuGNM88aVIE/X37Q9m24TsxRra17aijq/As0eVkQQdhVBY0mV5VK+vWI2uvNStc8aKKK2ynMI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024035; 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=E7Shf5G7XXtEUzZFGzu4HnLvjZW29BMVPNmFfHfMHgaHP3++K7YGpAa+P/3hpNBac8nKnXncK/usSwb6j3I2mGbFmpa/2yYUN3UXO1NNEKa88WJ9F+CnLHnsvCfQt28mS0ctvVEOo+2id2x6shY0LkZN0vFREzcoizCyvMj6dKE= 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 1790024035199524.9820487678672; Mon, 21 Sep 2026 13:53:55 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l07-0007Hv-DP; Mon, 21 Sep 2026 16:52:35 -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 1x8l03-0007EG-If for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:31 -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 1x8l00-0002Oq-89 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:31 -0400 Received: from mx-prod-mc-05.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-349-BzizFMuTMaq1v3tQzoBoRA-1; Mon, 21 Sep 2026 16:52:11 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AEE9C19540E3; Mon, 21 Sep 2026 20:52:09 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id AD19A41B; Mon, 21 Sep 2026 20:52:06 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023933; 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=J0kyas801bM/fFCDZbJY118ZyKhyMKrBzuUT/Fx2FqqXpSpB5iS1K6BL6iWMtmCdh6Fank HliGExSUhomHE8i23RlopYGPaRajLSqLOS+83IhkLmgfHDjqkmcYhXxnA/FGRKnvlUrtQf d9ev1CSWHNFxpptIbPGM4Wk5oXc4IMQ= X-MC-Unique: BzizFMuTMaq1v3tQzoBoRA-1 X-Mimecast-MFC-AGG-ID: BzizFMuTMaq1v3tQzoBoRA_1790023929 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 3/9] qapi: convert trivial intros for qga/qapi-schema.json Date: Mon, 21 Sep 2026 16:51:41 -0400 Message-ID: <20260921205147.1857168-4-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024036239158500 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 --- 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:30 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=1790023993; cv=none; d=zohomail.com; s=zohoarc; b=YOSQI+jKqDKOzeAB2cT+URuU8lUJ6M13aYFifM4A8IpIUOAwZt7Rfty2UWzLasfboa/U4qHIRj4IDtzLWAR/VckIMUsH1dMdGKZf3V271VLYXAya4MwJhsjtThBkTbKkEF6tVxxX2mKD/FSUBnE37TYsjvU3ioZqp9yTVH/mL5s= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790023993; 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=QssvCFyUYJ9xPjIz/lOdzL8M7W20ZYDgO8LMHSJEMOHclXehZP05g4CyLcbiO/ODbmYjABkxXkX1zA2cyVYTJDfVV6EnVqRDNh1uKNJlNYxL4fQZlHRpfCML6oyGkr/A34L4KleToaQ2UFFQJ5t7mbGkjDuwsPPhhsYpgoV5slo= 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 1790023993177676.6167901768481; Mon, 21 Sep 2026 13:53:13 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l04-0007Ep-I6; Mon, 21 Sep 2026 16:52:32 -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 1x8l02-0007DP-Pl for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:30 -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 1x8kzy-0002PV-J1 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:29 -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-86-JfHzVtg6PWKTMIvpLVBJRg-1; Mon, 21 Sep 2026 16:52:14 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 AD0041829E2E; Mon, 21 Sep 2026 20:52:12 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E6A2241B; Mon, 21 Sep 2026 20:52:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023935; 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=fj0t8bG0/DcDlnICu+bqXCyasb1o6IGmvXBxToo2IaR6JO13xONanjBhbpULHEq8q0XnTa VZFeWGfJwKqRJV39Eqc9QtdEG9CHXQoPH3SnTOZRhw7U/YxmVt53l67MI94REY13bvymm0 79JrEQRS/CTV7qSnZGU8L3/7GFWzB9A= X-MC-Unique: JfHzVtg6PWKTMIvpLVBJRg-1 X-Mimecast-MFC-AGG-ID: JfHzVtg6PWKTMIvpLVBJRg_1790023932 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 4/9] qapi: convert simple intros for qga/qapi-schema.json Date: Mon, 21 Sep 2026 16:51:42 -0400 Message-ID: <20260921205147.1857168-5-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790023993945158500 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 --- 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:30 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=1790024059; cv=none; d=zohomail.com; s=zohoarc; b=nGvHVYlGkxg8+2jbtiKhMJr3do9vlIifnUYvKj+s51D/MDby10T9DOurQ/d60dK47afICocZuiSLTw/zedvj7a8O1tevg8iH0phquY3GvlQ6j+TD0AW1vrsb2HeucQ1kLO+AKY4tUl4grg7QPvwLNWnsBLV7WNwcjVmLIA6hqA8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024059; 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=na8E4gEiwuNt6xm9+YIZGpohbgTwmihNVa8GNXWVjjA=; b=dws+NArmQzXFOCLS7FyTJSpX5ovc2ocd7gj0A+9lhg+MRBZl5yqcQWvAGCYOg7e27Q6JKYw1+RQ+BLltLgyv285wfs5NeZnq4UaaHxH8jhtmk3sdNt4AsiNqcRjp4Q7Z9BjwO4D+ihfi1N7lGNhFXIyrvHylKjn4ZHu/50HzQ2E= 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 1790024059081344.9830344182086; Mon, 21 Sep 2026 13:54:19 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l06-0007Fp-5F; Mon, 21 Sep 2026 16:52:34 -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 1x8l02-0007DT-Su for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:31 -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 1x8kzy-0002QY-Jo for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:30 -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-443-4P73zSpsNt-_1Mny77qVew-1; Mon, 21 Sep 2026 16:52:17 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 EBD82182E6BB; Mon, 21 Sep 2026 20:52:15 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id E5B8E426; Mon, 21 Sep 2026 20:52:12 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023940; 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=na8E4gEiwuNt6xm9+YIZGpohbgTwmihNVa8GNXWVjjA=; b=eTN16u3gcybGerLJLS4HdSEEKQW/Vc0s4fTYWuW0ydRlIq6awWMx5WVYppHPceXOCg3dxb w/nJ8/lIqtdQR2LOo/7SabY/7+a1a8iAn2BdUIikQ+9ujBqDSEeCAIS9wDzjDkD7c0jqRe X0Z25/MIctOHBIT0Xd4AepTRvNRhKxU= X-MC-Unique: 4P73zSpsNt-_1Mny77qVew-1 X-Mimecast-MFC-AGG-ID: 4P73zSpsNt-_1Mny77qVew_1790023936 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 5/9] qapi: split intros at natural cutoff points for qga/qapi-schema.json Date: Mon, 21 Sep 2026 16:51:43 -0400 Message-ID: <20260921205147.1857168-6-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: -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_H2=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: 1790024060237158500 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 generated for this definition. Signed-off-by: John Snow --- 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:30 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=1790024009; cv=none; d=zohomail.com; s=zohoarc; b=WbGQsKjsHRlX62F7rD4l+ZeoIWGnhlVbOF0e+ECWsRvdRM/X44SZ70cU9NTZvEzwQg9R4lG86xCKATZNBYad/+2yiwRc/d3zGUDQEpRdbZ+Xg5luusbL0ej9uFInar58NzttT5MMsoGW4vnOP44JeaUzX+odfqDBzsS/L7YWs5c= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024009; 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=dbPvTH3GBrI7Iz+z2rnREF7r7xDTQlAeV3WW7A8dP9OX1rFusTVOANxjoIKKM6yoB7+Po7I7d/lNKZKrSXT83u5RCb2awUCpQuH3HyLlTF4O5ylLfZw9GmRS4bvg61rd/s9uTF+7sVuEWlg5C5lhhJFH1bYTaeR216Ng4XdVWPg= 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 1790024009668611.8018628178693; Mon, 21 Sep 2026 13:53:29 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l04-0007Er-SZ; Mon, 21 Sep 2026 16:52:32 -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 1x8l02-0007DN-P4 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:30 -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 1x8kzy-0002Rf-Jd for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:30 -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-458-YNNM_jMcOzKACUfjwvu2dQ-1; Mon, 21 Sep 2026 16:52:21 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 186D71954231; Mon, 21 Sep 2026 20:52:19 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 2F3FD40E; Mon, 21 Sep 2026 20:52:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023945; 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=V+Zj/oQSFlLBfZQ/eRlVIwmuOUqQHO57nAi8DWgfQ1q+ybILXYL6+7rHTuyfzsC4ASonYq CSke6ER0ho/YJAmaC7Omlh0kFp8gOICoG6YpDJfaE1FIS6mO0hmiPi0KlOCXWSrQpKX2XT BzUHVTMkb8Y7KZo3miTzVTJDsEUyaA0= X-MC-Unique: YNNM_jMcOzKACUfjwvu2dQ-1 X-Mimecast-MFC-AGG-ID: YNNM_jMcOzKACUfjwvu2dQ_1790023939 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 6/9] qapi: split intros for qga/qapi-schema.json Date: Mon, 21 Sep 2026 16:51:44 -0400 Message-ID: <20260921205147.1857168-7-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024016088158500 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 --- 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:30 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=1790024039; cv=none; d=zohomail.com; s=zohoarc; b=YLF7ieabnx4hlIMALHVlOIvPKyzE2J0wfmdKbn27bUHNPGwn1JAZ5TjTMHG4QMQrZZ7lyCxfM1MYcLeE72g5Hq3ZDpXdz4O6TGIDNj0wsXfzMKq8fBgWY2CDno4IQxX6EW29t5yNSgN/CeVY+2uY0Qsfd+0kLTdwOepRwcbfsmQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024039; 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=FThRuPelXeC0G5s3Fdoo4Im65xgB0AzF/G6WLYavFUBnO9Tlb1qhVFNCUQzZwFQhkTTWRi0vHwWHHqbpgiLe9VWhk1EJAeFHEl65mesOggH/5gyZBocUwFhYXSHHYYWrJ+u9mNgb8kXWSjRGyJs/eg9HYrPFE2QPacxgTHpNJLM= 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 179002403911884.0896639036689; Mon, 21 Sep 2026 13:53:59 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l07-0007Hw-DU; Mon, 21 Sep 2026 16:52:35 -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 1x8l04-0007Es-KP for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:32 -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 1x8l02-0002SY-2f for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:32 -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-121-KC4eHw2sMNW1iAzjjznquw-1; Mon, 21 Sep 2026 16:52:24 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 6A700192DD6A; Mon, 21 Sep 2026 20:52:22 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 5005140E; Mon, 21 Sep 2026 20:52:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023948; 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=fJ9ta7HB6z7XeSjpZsmQ/0anFwNecS4fSdSWYb+RWtYX+iTNpbJIEFfbl46XywfZVgLhzN 4CZpkj/HmuaskqdflLrfaRxeP2XSZQdMhNflx2/7VmkyAx+0n66T/ETtiR27dgQSaSf2Rg 8KQBpUyAYBn25UQ5XD8Mm1Isa3Iwlww= X-MC-Unique: KC4eHw2sMNW1iAzjjznquw-1 X-Mimecast-MFC-AGG-ID: KC4eHw2sMNW1iAzjjznquw_1790023942 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 7/9] qapi: convert intro sections for docs/interop/firmware.json Date: Mon, 21 Sep 2026 16:51:45 -0400 Message-ID: <20260921205147.1857168-8-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024040202158500 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 --- 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:30 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=1790024010; cv=none; d=zohomail.com; s=zohoarc; b=OsUsXD0XohuOh4Nts7mTN1hha3+RqllHLu68Z1J+/ZkvZClgLQRd9vwC+kigSNCOKkXHIeQ8B+DZtlmEr4DdesI8iBPSXQrvlSj+zSwH2Ogoz0seGtFEfGgC3i6wKRNR60/cR0pI6miUibT1M7pcrp7Vu7olAlj46SY1AfO5/Yw= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024010; 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=b1cLILPZL2pykLKP9hliGMYq+MD+YERMbDyOgKJCdxpHkigbaFTOhdSZ5Iy8L+DmC6zf+v2+OhuOFxl02yjAc4r+r+bcbEZ8eiGwOhQs1OELY3aR8GtGtkTGQMcHIMmwfrVLZ8MuDMOyrM0Qhrr5Q/EFNZYgX+iCjO022szrZcA= 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 1790024010740662.0548446127808; Mon, 21 Sep 2026 13:53:30 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l0A-0007Lc-8i; Mon, 21 Sep 2026 16:52:38 -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 1x8l06-0007HV-K1 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:34 -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 1x8l05-0002Uu-57 for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:34 -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-240-hbECGmAAOcC2Cmg2_sX8sQ-1; Mon, 21 Sep 2026 16:52:28 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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 AB892185BE92; Mon, 21 Sep 2026 20:52:26 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id A20BB40E; Mon, 21 Sep 2026 20:52:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023952; 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=EK6H3C+oeKhDXW08F6J+VaCwranemg1cDtTd6Sg+lKcQXLSq1Lbl4rNOGe2+mLN0l4tmQy ym+Du85P8qG/tk8rIA2NRA5g2oMp3dYvnM3Fm8+WxKx73cyYV9OEITTdkhbsa9N7ED9nb+ rEyskF4EP6jFA4BFvSEtvnuaF3t3aKU= X-MC-Unique: hbECGmAAOcC2Cmg2_sX8sQ-1 X-Mimecast-MFC-AGG-ID: hbECGmAAOcC2Cmg2_sX8sQ_1790023947 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 8/9] qapi: convert intro sections for docs/interop/vhost-user.json Date: Mon, 21 Sep 2026 16:51:46 -0400 Message-ID: <20260921205147.1857168-9-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024012272158500 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 --- 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 From nobody Sat Sep 26 20:00:30 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=1790024002; cv=none; d=zohomail.com; s=zohoarc; b=hntAOkEFvIbkwXEq6926+mwMKnzeSF0DlxqECYK7ecBpcKaqZcRMZeo0aDtlIqr/Q6I9H510JtS8UuhZkh3uAN2/T86DVwZb49kWnHp0teFhNN1EtAB4XNrTZPQBrtiA/ilrTZjNchksZsl+XgTG6ZgJmT+u7srMeHtRDmdkeCA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1790024002; 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=9eoRhbGgJJZvM/qRy1HTiD4N9gH8Dh1xG3yQ31kINZ0=; b=TZjjZimBDD8gJV1odQY3ROtz2MfWBcNERQISEfL4eJtbD4GoIrx1I2k+f2RT22z1KmDeGPF90/vUNwKFAaf7OE60ESDxnHuYuSYggfwsYWmXAJ8KKMHHXs5eVIcg3q8FUwcKqX6aY0rcDWqsiIMSeLsQOcWrkdz8faDVQNVu7i8= 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 1790024002651514.4655066154569; Mon, 21 Sep 2026 13:53:22 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x8l0C-0007Ny-A1; Mon, 21 Sep 2026 16:52:40 -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 1x8l0A-0007LR-3z for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:38 -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 1x8l07-0002Vw-As for qemu-devel@nongnu.org; Mon, 21 Sep 2026 16:52:37 -0400 Received: from mx-prod-mc-05.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-298-4pYhymLlOcafPRgMm8WwBg-1; Mon, 21 Sep 2026 16:52:31 -0400 Received: from mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.95]) (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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 91BA419772FC; Mon, 21 Sep 2026 20:52:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.125]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id CE4F5756; Mon, 21 Sep 2026 20:52:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790023954; 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=9eoRhbGgJJZvM/qRy1HTiD4N9gH8Dh1xG3yQ31kINZ0=; b=i6qweb0hOmrW6nfCJi7SzR9OHkUNLGPpr1yhiiJFdPeVMnyiFoMSHJNiU8n/OwmgTDST2n AaeDC0Ix/CObac5Xaz2Ap623nhoA9WcpwaXCNgRx4XaRXQQwEDop5QpGxZRpfGV9jzmy8I sR/5XAMo+qwsy4wSQxp06q7q3haT6/k= X-MC-Unique: 4pYhymLlOcafPRgMm8WwBg-1 X-Mimecast-MFC-AGG-ID: 4pYhymLlOcafPRgMm8WwBg_1790023949 From: John Snow To: qemu-devel@nongnu.org Cc: Michael Roth , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Kashyap Chamarthy , Kevin Wolf , Michael Tokarev , Hanna Reitz , Stefano Garzarella , Jason Wang , Zhao Liu , Kostiantyn Kostiuk , Markus Armbruster , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , qemu-block@nongnu.org, qemu-trivial@nongnu.org, Laurent Vivier , Eric Blake , "Michael S. Tsirkin" , Pierrick Bouvier , John Snow Subject: [PATCH 9/9] tests/qapi: generate output in source order Date: Mon, 21 Sep 2026 16:51:47 -0400 Message-ID: <20260921205147.1857168-10-jsnow@redhat.com> In-Reply-To: <20260921205147.1857168-1-jsnow@redhat.com> References: <20260921205147.1857168-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: 1790024004120158500 Content-Type: text/plain; charset="utf-8" Rewrite the test doc generator to produce output in source order, instead of arbitrarily. Signed-off-by: John Snow --- tests/qapi-schema/doc-good.out | 82 +++++++++++++++++----------------- tests/qapi-schema/test-qapi.py | 9 ++-- 2 files changed, 46 insertions(+), 45 deletions(-) diff --git a/tests/qapi-schema/doc-good.out b/tests/qapi-schema/doc-good.out index 8c0818a3f0d..a8e71d182bc 100644 --- a/tests/qapi-schema/doc-good.out +++ b/tests/qapi-schema/doc-good.out @@ -54,15 +54,15 @@ event EVT_BOXED Object boxed=3DTrue feature feat3 doc freeform - Plain + section=3DPlain ******* Section ******* doc freeform - Plain + section=3DPlain Just text, no heading. doc freeform - Plain + section=3DPlain Subsection =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 @@ -106,84 +106,84 @@ Examples: - *verbatim* - {braces} doc symbol=3DEnum - Intro + section=3DIntro =20 - Member=3Done + arg=3Done The _one_ {and only}, description on the same line - Member=3Dtwo + arg=3Dtwo =20 - Feature=3Denum-feat + feature=3Denum-feat Also _one_ {and only} - Feature=3Denum-member-feat + feature=3Denum-member-feat a member feature - Plain + section=3DPlain @two is undocumented doc symbol=3DBase - Intro + section=3DIntro =20 - Member=3Dbase1 + arg=3Dbase1 description starts on a new line, minimally indented doc symbol=3DVariant1 - Intro + section=3DIntro A paragraph =20 Another paragraph =20 @var1 is undocumented - Member=3Dvar1 + arg=3Dvar1 =20 - Feature=3Dvariant1-feat + feature=3Dvariant1-feat a feature - Feature=3Dmember-feat + feature=3Dmember-feat a member feature doc symbol=3DVariant2 - Intro + section=3DIntro =20 doc symbol=3DObject - Intro + section=3DIntro =20 - Feature=3Dunion-feat1 + feature=3Dunion-feat1 a feature doc symbol=3DAlternate - Intro + section=3DIntro =20 - Member=3Di + arg=3Di description starts on the same line remainder indented the same @b is undocumented - Member=3Db + arg=3Db =20 - Feature=3Dalt-feat + feature=3Dalt-feat a feature doc freeform - Plain + section=3DPlain Another subsection =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D doc symbol=3Dcmd - Intro + section=3DIntro =20 - Member=3Darg1 + arg=3Darg1 description starts on a new line, indented - Member=3Darg2 + arg=3Darg2 description starts on the same line remainder indented differently - Member=3Darg3 + arg=3Darg3 =20 - Feature=3Dcmd-feat1 + feature=3Dcmd-feat1 a feature - Feature=3Dcmd-feat2 + feature=3Dcmd-feat2 another feature - Plain + section=3DPlain .. note:: @arg3 is undocumented - Returns + section=3DReturns @Object - Errors + section=3DErrors some - Todo + section=3DTodo frobnicate - Plain + section=3DPlain .. admonition:: Notes =20 - Lorem ipsum dolor sit amet @@ -207,24 +207,24 @@ Examples:: =20 Note:: Ceci n'est pas une note - Since + section=3DSince 2.10 doc symbol=3Dcmd-boxed - Intro + section=3DIntro If you're bored enough to read this, go see a video of boxed cats - Feature=3Dcmd-feat1 + feature=3Dcmd-feat1 a feature - Feature=3Dcmd-feat2 + feature=3Dcmd-feat2 another feature - Plain + section=3DPlain .. qmp-example:: =20 -> "this example" =20 <- ... has no title ... doc symbol=3DEVT_BOXED - Intro + section=3DIntro =20 - Feature=3Dfeat3 + feature=3Dfeat3 a feature diff --git a/tests/qapi-schema/test-qapi.py b/tests/qapi-schema/test-qapi.py index 5beb96e894f..27885147b4d 100755 --- a/tests/qapi-schema/test-qapi.py +++ b/tests/qapi-schema/test-qapi.py @@ -118,11 +118,12 @@ def test_frontend(fname): else: print('doc freeform') for section in doc.all_sections: - if isinstance(section, QAPIDoc.ArgSection): - print(' %s=3D%s' % (section.kind, section.name)) + if section.kind =3D=3D QAPIDoc.Kind.MEMBER: + print(' arg=3D%s\n%s' % (section.name, section.text)) + elif section.kind =3D=3D QAPIDoc.Kind.FEATURE: + print(' feature=3D%s\n%s' % (section.name, section.text= )) else: - print(' %s' % section.kind) - print(section.text) + print(' section=3D%s\n%s' % (section.kind, section.text= )) =20 =20 def open_test_result(dir_name, file_name, update): --=20 2.55.0