From nobody Sat Sep 26 22:14:42 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=1789147380; cv=none; d=zohomail.com; s=zohoarc; b=dOB2F09UXsoSP5DHRnIOJvt1xBZcfKgmv0BxIwIz5ZSZvYXf/e5e82u5s2syMXJmz3kSoKCabdq29BV4ZN5a7iF6SPHST7qp83p8396otXXn0BtTH9s36nguQO5qre3JsBwLQPUYSdsv9GY9kxuedOusAuJLsGMCwbeZbv2Insk= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147380; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=6rV63i5zLz4J/LUzf54w3p9IiUX+skDQOv9c6EGZuIE=; b=Ofzqxhm5hV1Dq1DLoOS8eq93dbcqlQlH5zEDltfGB8JufklxV3NrLxW1DlVId2YVn/O/PltEOi/d/XY2AuJGpGfLiBuMRS1oUhF+H0gcDQkcxt0zfaLusync1Y6bl4xmqozvQC+BqCaIqEUx64sPF0R34z0A7n4XOTbWXJkOilA= 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 1789147380783902.1314661980092; Fri, 11 Sep 2026 10:23:00 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xB-0000yj-67; Fri, 11 Sep 2026 13:22:21 -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 1x54x7-0000xk-F3 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:17 -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 1x54x6-0004aF-1G for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:17 -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-223-QYSSMvJbOPCq-kGEp_FrtQ-1; Fri, 11 Sep 2026 13:22:11 -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 E89A118009CF; Fri, 11 Sep 2026 17:22:09 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 1A46F1956095; Fri, 11 Sep 2026 17:22:05 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147335; 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=6rV63i5zLz4J/LUzf54w3p9IiUX+skDQOv9c6EGZuIE=; b=N9lIdoy1wmPyMq8JO4LHaeRf2WsahY1X8tdYYi6NpgWCd3zDo7CIFshhMNik0dXU+3hdXz vtua6TNrCwA2pu2SGnmjz/vHv8+nNwEOr8Ewmfx1ruK4fSU3dkag1a/QCvAdzr6jzgL0vW /qViBkj246VxIC3rkEiQcShe8kOJR3I= X-MC-Unique: QYSSMvJbOPCq-kGEp_FrtQ-1 X-Mimecast-MFC-AGG-ID: QYSSMvJbOPCq-kGEp_FrtQ_1789147330 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 1/6] qapi: convert remaining simple intros for block-export.json Date: Fri, 11 Sep 2026 13:21:55 -0400 Message-ID: <20260911172200.227914-2-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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: -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: 1789147383757158500 Content-Type: text/plain; charset="utf-8" These are either structs or unions that are used in an inlinable context: i.e. the generated documentation is likely to feature a version of this documentation block that does not include the intro in context of another command, event, or structure. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block-export.json | 19 ++++++++----------- 1 file changed, 8 insertions(+), 11 deletions(-) diff --git a/qapi/block-export.json b/qapi/block-export.json index 2893c6456d5..e9f7e72c8ee 100644 --- a/qapi/block-export.json +++ b/qapi/block-export.json @@ -37,10 +37,9 @@ =20 ## # @NbdServerOptions: -# -# Keep this type consistent with the `NbdServerOptionsLegacy` type. -# The only intended difference is using `SocketAddress` instead of -# `SocketAddressLegacy`. +# Keep this type consistent with the `NbdServerOptionsLegacy` +# type. The only intended difference is using `SocketAddress` +# instead of `SocketAddressLegacy`. # # @addr: Address on which to listen (since 4.2). ## @@ -50,10 +49,9 @@ =20 ## # @NbdServerOptionsLegacy: -# -# Keep this type consistent with the `NbdServerOptions` type. The -# only intended difference is using `SocketAddressLegacy` instead of -# `SocketAddress`. +# Keep this type consistent with the `NbdServerOptions` type. The +# only intended difference is using `SocketAddressLegacy` instead +# of `SocketAddress`. # # @addr: Address on which to listen (since 1.3). ## @@ -339,9 +337,8 @@ =20 ## # @BlockExportOptions: -# -# Describes a block export, i.e. how single node should be exported on -# an external interface. +# Describes a block export, i.e. how single node should be +# exported on an external interface. # # @type: Block export type # --=20 2.55.0 From nobody Sat Sep 26 22:14:42 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=1789147381; cv=none; d=zohomail.com; s=zohoarc; b=Z4rQ0Qsa5PFV2xWFtzKk/n008A8lFfezpTFutHHHkE8p0CZ1KwwHY0WTaN6CGWHXXi+8Y9nXSx9py0kRDmEaWDnwtkb+KkxhbYsX9clPOrJWvcoGDnq8R35ELuk2UzWjuDO7BuPPbeqE6SvySNVXZtoopV4uYrx0xDyXwdVbu+E= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147381; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=ClPV5sIPWojjTAynGwc1mftqvUQ/Gr/l3qbEvnYoawE=; b=CGLQdGMOsZs8Zg3cLWOzvtWzi7MWMZY/VS60Uj5fabWzWfAz6nKehvfVLZHNjX97gEmd/kq2Rs4ugVFFdTSzrQZnLfo2yU/VzvT1lGrUSzIl3XH2ZPttExbDPZzWT8fcgXKFllk7iw9l03rO9zqZUOKeWAiiz3L7fIy5PBKFu+s= 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 1789147381072718.560202058059; Fri, 11 Sep 2026 10:23:01 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xG-000111-Ay; Fri, 11 Sep 2026 13:22:26 -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 1x54xE-0000zk-C2 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:24 -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 1x54xC-0004bn-E0 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:23 -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-67-vxhCZNUZP-mDJAJJC5-MTQ-1; Fri, 11 Sep 2026 13:22:14 -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 2291E180066A; Fri, 11 Sep 2026 17:22:13 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 547FC195608F; Fri, 11 Sep 2026 17:22:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147341; 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=ClPV5sIPWojjTAynGwc1mftqvUQ/Gr/l3qbEvnYoawE=; b=FUqPSy5jyU7bBEwAtP1CmlhRPOjkgLu2o7oBQNkX4cKjk9+D+Cx9lbYN4k9xWC6PtCh3M0 bU1z8lrcIHf5pu81UrlsuVCG7V1/NMU8cWML5Dhgr8ewXzQOyBfLXbtX/mPEwdHXiqjf/6 UtxMgzsXgL2kXLtNOTNRkUV896krNgo= X-MC-Unique: vxhCZNUZP-mDJAJJC5-MTQ-1 X-Mimecast-MFC-AGG-ID: vxhCZNUZP-mDJAJJC5-MTQ_1789147333 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 2/6] qapi: convert remaining simple intros for cxl.json Date: Fri, 11 Sep 2026 13:21:56 -0400 Message-ID: <20260911172200.227914-3-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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: -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: 1789147383847158500 Content-Type: text/plain; charset="utf-8" These are either structs or unions that are used in an inlinable context: i.e. the generated documentation is likely to feature a version of this documentation block that does not include the intro in context of another command, event, or structure. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/cxl.json | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/qapi/cxl.json b/qapi/cxl.json index 631d4def2ac..9422d5a0e2d 100644 --- a/qapi/cxl.json +++ b/qapi/cxl.json @@ -32,9 +32,8 @@ =20 ## # @CXLCommonEventBase: -# -# Common event base for a CXL Event (CXL r3.2 8.2.10.2.1 -# Table 8-55 Common Event Record Format). +# Common event base for a CXL Event (CXL r3.2 8.2.10.2.1 Table +# 8-55 Common Event Record Format). # # @path: CXL type 3 device canonical QOM path # @@ -63,8 +62,7 @@ =20 ## # @CXLGeneralMediaEvent: -# -# Event record for a General Media Event (CXL r3.2 8.2.10.2.1.1). +# Event record for a General Media Event (CXL r3.2 8.2.10.2.1.1). # # @dpa: Device Physical Address (relative to @path device). Note # lower bits include some flags. See CXL r3.2 Table 8-57 General @@ -129,8 +127,7 @@ =20 ## # @CXLDRAMEvent: -# -# Event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). +# Event record for a DRAM Event (CXL r3.2 8.2.10.2.1.2). # # @dpa: Device Physical Address (relative to @path device). Note # lower bits include some flags. See CXL r3.2 Table 8-58 DRAM @@ -211,8 +208,7 @@ =20 ## # @CXLMemModuleEvent: -# -# Event record for a Memory Module Event (CXL r3.2 8.2.10.2.1.3). +# Event record for a Memory Module Event (CXL r3.2 8.2.10.2.1.3). # # @type: Device Event Type. See CXL r3.2 Table 8-59 Memory Module # Event Record for bit definitions for bit definiions. --=20 2.55.0 From nobody Sat Sep 26 22:14:42 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=1789147394; cv=none; d=zohomail.com; s=zohoarc; b=CMlfy9OkhmER3w7nWR2SiZq2mfN9xH5Sbqe6rtiPKssKSN6WIWlH7GaF+bZteF4UWVTB4b5YNLkEGkm9ohIyufs+/v4/+2v+yy/SL10gw9sQcBvfLzej3vQHrhhO4cD/drri5599GeBkTS3umi3pl7e/9nTG9NVh8TJHWwYmOHg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147394; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=kqnCn6G38OWUssJgOIyQiwhSLKRNKgZZBvo5dTe58DE=; b=kdXP0mLMMe0hUULOINo0EkFUECK0kQ7l+AU5BubXJ93SU7edc7qpAq6CWqJR+XrLol7NIFzbH6f1myNyN1uogMARHOUEYoW7+xhuBRQsBx7Le+VkoCcw8xdA321w922yxPuEEq1j+BHojLFp0fW6An2ZPTm/oB91k8GMKo4KoR4= 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 178914739491078.25488873425934; Fri, 11 Sep 2026 10:23:14 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xF-00010I-Fg; Fri, 11 Sep 2026 13:22:25 -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 1x54xE-0000zl-E3 for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:24 -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 1x54xC-0004c4-QP for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:24 -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-120-1SOw62vbNAGvNNb27isq2w-1; Fri, 11 Sep 2026 13:22:19 -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 02B14180134B; Fri, 11 Sep 2026 17:22:17 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id B1ABF195608F; Fri, 11 Sep 2026 17:22:13 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147342; 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=kqnCn6G38OWUssJgOIyQiwhSLKRNKgZZBvo5dTe58DE=; b=ATwHrANVl1kd9IFQ34QbHM4BkhtG8C33GOP3kzNi3TSPJqlZBPZ+WhZeIm9Xkdq+Qcphjq 2x7EnP93WjtsxLkg24LwAl8c1avCX3pd6a3pb10THmUUk9qBGB2OJWWS6KYXiWygKC8TBi 5Jao7vPv7hoHRIW28hHldalhtq7uzro= X-MC-Unique: 1SOw62vbNAGvNNb27isq2w-1 X-Mimecast-MFC-AGG-ID: 1SOw62vbNAGvNNb27isq2w_1789147337 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 3/6] qapi: convert remaining simple intros for machine.json Date: Fri, 11 Sep 2026 13:21:57 -0400 Message-ID: <20260911172200.227914-4-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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=ham 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: 1789147397471158500 Content-Type: text/plain; charset="utf-8" These are either structs or unions that are used in an inlinable context: i.e. the generated documentation is likely to feature a version of this documentation block that does not include the intro in context of another command, event, or structure. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 0516112f8e8..13875fc4642 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -449,8 +449,7 @@ =20 ## # @NumaOptions: -# -# A discriminated record of NUMA options. (for OptsVisitor) +# A discriminated record of NUMA options. (for OptsVisitor) # # @type: NUMA option type # --=20 2.55.0 From nobody Sat Sep 26 22:14:42 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=1789147394; cv=none; d=zohomail.com; s=zohoarc; b=AqCAtbG4m/miEmuxrC4VYnBhbr/SR5RbvYt/KZGwQrVwD6qW33gqDskNfyVSJvtG32bwvgNNBVGSAEvGy87zeNp4P4LbsCs0Q74CPuCCdq5WqZxPUUjSB+rT6ZE0JLsYVmUr4tnQGKXz/gK2S9csf7KYs6oMWAu8uHdXgETKXeE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147394; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=rBLyZXbXlsOC8SLLzAeTtyZ5ri1ynYIY6/I844l2vDU=; b=kYkowTY2prCqofWaiS7MOB5XUuBKjjwgsd6adt0A718PzATDG6YtfRZl0pDRdgMmPvQSgQ0Ny+tiB9fKmerWP9M0mF2Xif2ZUjfwe5pP4QxJ71aYD6A3FV+xS5ljU/fkvBiNP3VbkSd5M/M0FEGkW2rO1VAQLjgHkH66KfOY3+A= 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 1789147394708984.8063037263943; Fri, 11 Sep 2026 10:23:14 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xJ-00011j-19; Fri, 11 Sep 2026 13:22:29 -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 1x54xH-00011L-HR for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:27 -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 1x54xF-0004cz-Qk for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:27 -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-84-nuqhVkaoOMOtL6xFiEWfOQ-1; Fri, 11 Sep 2026 13:22:22 -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 6355018011F5; Fri, 11 Sep 2026 17:22:20 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 601A41956095; Fri, 11 Sep 2026 17:22:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147345; 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=rBLyZXbXlsOC8SLLzAeTtyZ5ri1ynYIY6/I844l2vDU=; b=G+ktjByNjK3VSvupYNrR+BUca3Bpu/CrfRVX6LVFoS80N5L6ZOFJRXcBo9xpSD3lp7owJT IF4rO7HOmi+ITqyJmtOqKpUwCMnaAhvbU9DgeCdG1UwVfFg+i4gUS+e7SI6gcE81ykMJqT 0GL34HViVl3vvhDIAd5vWIWalN4QtRM= X-MC-Unique: nuqhVkaoOMOtL6xFiEWfOQ-1 X-Mimecast-MFC-AGG-ID: nuqhVkaoOMOtL6xFiEWfOQ_1789147340 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 4/6] qapi: convert remaining simple intros for block-core.json Date: Fri, 11 Sep 2026 13:21:58 -0400 Message-ID: <20260911172200.227914-5-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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=ham 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: 1789147397511158500 Content-Type: text/plain; charset="utf-8" These are either structs or unions that are used in an inlinable context: i.e. the generated documentation is likely to feature a version of this documentation block that does not include the intro in context of another command, event, or structure. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/block-core.json | 45 +++++++++++++++++++------------------------- 1 file changed, 19 insertions(+), 26 deletions(-) diff --git a/qapi/block-core.json b/qapi/block-core.json index 1ca147285e7..88218e38d02 100644 --- a/qapi/block-core.json +++ b/qapi/block-core.json @@ -4462,9 +4462,8 @@ =20 ## # @BlockdevOptionsCurlHttp: -# -# Driver specific block device options for HTTP connections over the -# curl backend. URLs must start with "http://". +# Driver specific block device options for HTTP connections over +# the curl backend. URLs must start with "http://". # # @cookie: List of cookies to set; format is "name1=3Dcontent1; # name2=3Dcontent2;" as explained by CURLOPT_COOKIE(3). Defaults to @@ -4488,9 +4487,8 @@ =20 ## # @BlockdevOptionsCurlHttps: -# -# Driver specific block device options for HTTPS connections over the -# curl backend. URLs must start with "https://". +# Driver specific block device options for HTTPS connections over +# the curl backend. URLs must start with "https://". # # @sslverify: Whether to verify the SSL certificate's validity # (defaults to true) @@ -4503,9 +4501,8 @@ =20 ## # @BlockdevOptionsCurlFtp: -# -# Driver specific block device options for FTP connections over the -# curl backend. URLs must start with "ftp://". +# Driver specific block device options for FTP connections over +# the curl backend. URLs must start with "ftp://". # # Since: 2.9 ## @@ -4515,9 +4512,8 @@ =20 ## # @BlockdevOptionsCurlFtps: -# -# Driver specific block device options for FTPS connections over the -# curl backend. URLs must start with "ftps://". +# Driver specific block device options for FTPS connections over +# the curl backend. URLs must start with "ftps://". # # @sslverify: Whether to verify the SSL certificate's validity # (defaults to true) @@ -4643,14 +4639,13 @@ =20 ## # @BlockdevOptionsCbw: -# -# Driver specific block device options for the copy-before-write -# driver, which does so called copy-before-write operations: when data -# is written to the filter, the filter first reads corresponding -# blocks from its file child and copies them to @target child. After -# successfully copying, the write request is propagated to file child. -# If copying fails, the original write request is failed too and no -# data is written to file child. +# Driver specific block device options for the copy-before-write +# driver, which does so called copy-before-write operations: when +# data is written to the filter, the filter first reads +# corresponding blocks from its file child and copies them to +# @target child. After successfully copying, the write request is +# propagated to file child. If copying fails, the original write +# request is failed too and no data is written to file child. # # @target: The target for copy-before-write operations. # @@ -4686,9 +4681,8 @@ =20 ## # @BlockdevOptions: -# -# Options for creating a block device. Many options are available for -# all block devices, independent of the block driver: +# Options for creating a block device. Many options are available +# for all block devices, independent of the block driver: # # @driver: block driver name # @@ -5473,9 +5467,8 @@ =20 ## # @BlockdevAmendOptionsQcow2: -# -# Driver specific image amend options for qcow2. For now, only -# encryption options can be amended +# Driver specific image amend options for qcow2. For now, only +# encryption options can be amended # # @encrypt: Encryption options to be amended # --=20 2.55.0 From nobody Sat Sep 26 22:14:42 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=1789147417; cv=none; d=zohomail.com; s=zohoarc; b=NQjcVHXbFmYcZ+YL2SUrdjHiY5wlBj1fzeAj9huaoYCHXfxMMTnWtm1c6ZELCSb2s0U3eDqrf8FmgKv86UDzc+jruREDyHh7jjKi9pVE/bMOJaBUq2nYRt89YXkxijFLhmDsanMDlYbtubfxuhJ4s6lzz1iuXzFfUBfO45/F0qM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147417; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=fVqJB7RA7wK1A3wU0gjI5S+gtvyNP6b0TlS+G7syIFw=; b=THntCkoaNKHbeQKP3mZyhFC4BWpDlXReTldEhHlPe9ic/ALk4fcPqV4OKDsrg2F1XVMoWDt2MdL0qZYc5dpok983Ome2ogQ3SMsg1zWhpmB2p87GWMhsSSCviNEpNrSELOVH0KaNnbmLpkQ3pKCSmAUgSkW1axrATtTcBRryYxY= 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 17891474179241011.6931512272515; Fri, 11 Sep 2026 10:23:37 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xN-00012p-Cr; Fri, 11 Sep 2026 13:22:33 -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 1x54xM-00012Y-3J for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22: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 1x54xK-0004eB-Hq for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22: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-517-DlBAvwGUMLuziTEn6JJrmg-1; Fri, 11 Sep 2026 13:22:26 -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 EC8891801371; Fri, 11 Sep 2026 17:22:24 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id D76DB195608F; Fri, 11 Sep 2026 17:22:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147349; 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=fVqJB7RA7wK1A3wU0gjI5S+gtvyNP6b0TlS+G7syIFw=; b=VP5suNCzrrflFa8Cv2GeQmQBxqlPrNGsh7/WWNQr013Dvu5h0DdVf1XhRfLYJ4BNZmvQyq mEAYFquV/sxwXIhJsqmzcLEztMAj3cI+BRQ+0Rxic+wTDqvpr5xdcWWDt+2YZNJHemeIiO VkOr5IpLOOJ+qkOqi48F5DqWmFcuMEM= X-MC-Unique: DlBAvwGUMLuziTEn6JJrmg-1 X-Mimecast-MFC-AGG-ID: DlBAvwGUMLuziTEn6JJrmg_1789147345 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 5/6] qapi: convert intro sections with "TODO" markers Date: Fri, 11 Sep 2026 13:21:59 -0400 Message-ID: <20260911172200.227914-6-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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: -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=ham 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: 1789147419778158500 Content-Type: text/plain; charset="utf-8" This patch converts intro sections that are immediately followed by a "TODO:" that was formerly used to demarcate the stub member insertion point. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine.json | 7 ++----- qapi/migration.json | 10 ++-------- qapi/net.json | 9 +++------ qapi/yank.json | 5 +---- 4 files changed, 8 insertions(+), 23 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 13875fc4642..108033b6d64 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1216,11 +1216,8 @@ =20 ## # @query-memory-size-summary: -# -# Return the amount of initially allocated and present hotpluggable -# (if enabled) memory in bytes. -# -# TODO: This line is a hack to separate the example from the body +# Return the amount of initially allocated and present +# hotpluggable (if enabled) memory in bytes. # # .. qmp-example:: # diff --git a/qapi/migration.json b/qapi/migration.json index 8096ef64682..70a1854fb73 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -1604,10 +1604,7 @@ =20 ## # @query-xen-replication-status: -# -# Query replication status while the vm is running. -# -# TODO: This line is a hack to separate the example from the body +# Query replication status while the vm is running. # # .. qmp-example:: # @@ -1657,10 +1654,7 @@ =20 ## # @query-colo-status: -# -# Query COLO status while the vm is running. -# -# TODO: This line is a hack to separate the example from the body +# Query COLO status while the vm is running. # # .. qmp-example:: # diff --git a/qapi/net.json b/qapi/net.json index 7aabd8b9260..7a809d9a8a6 100644 --- a/qapi/net.json +++ b/qapi/net.json @@ -1113,12 +1113,9 @@ =20 ## # @announce-self: -# -# Trigger generation of broadcast RARP frames to update network -# switches. This can be useful when network bonds fail-over the -# active slave. -# -# TODO: This line is a hack to separate the example from the body +# Trigger generation of broadcast RARP frames to update network +# switches. This can be useful when network bonds fail-over the +# active slave. # # .. qmp-example:: # diff --git a/qapi/yank.json b/qapi/yank.json index 8ac4b773653..187a0952e66 100644 --- a/qapi/yank.json +++ b/qapi/yank.json @@ -96,10 +96,7 @@ =20 ## # @query-yank: -# -# Query yank instances. See `YankInstance` for more information. -# -# TODO: This line is a hack to separate the example from the body +# Query yank instances. See `YankInstance` for more information. # # .. qmp-example:: # --=20 2.55.0 From nobody Sat Sep 26 22:14:42 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=1789147401; cv=none; d=zohomail.com; s=zohoarc; b=VXAwwPw3ZhdOvFWYZc7iyBnvOBCQs1aR05Y9MRc0dGVSlb3nOmetbnEFVkkXXp5U/OfMePogERHs/yAh/MuNaR3UMjEMkLgxx06Cv9gq6oAIjLWsmAfm/wj9wVS6ubcv/9mOBI7zchNTf9aPUM1L9RXFaX8JTyqE7otlny8r46w= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1789147401; 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:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=OhXIqCf/hAEpGNtdeyWPDfvZ8dculLK71e35WLjicQI=; b=B/j2RGLw39upBBYTnD8SolT99YvOkBqtmWp6fJn0rzz82vb+HF5Nr3hNE+YYjUQCNgaTVp0nOjvrkwiXlqxLFZNBpd5PvVOJI+suw7BUobdxp83eD0ygJRW4ebh8a2wKmdUrvpQfnmVk5jf8ExPDF8HNA+2cIG0bVjIO86b5tvA= 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 1789147401146232.91983249536474; Fri, 11 Sep 2026 10:23:21 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1x54xS-000146-MH; Fri, 11 Sep 2026 13:22: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 1x54xQ-00013u-SL for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:36 -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 1x54xP-0004fL-9R for qemu-devel@nongnu.org; Fri, 11 Sep 2026 13:22:36 -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-657-0pDL3bT_Pi6wuPwcMFl0-Q-1; Fri, 11 Sep 2026 13:22: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-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id B8D07195E90E; Fri, 11 Sep 2026 17:22:29 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.88.222]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 8F0EF195608F; Fri, 11 Sep 2026 17:22:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1789147354; 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=OhXIqCf/hAEpGNtdeyWPDfvZ8dculLK71e35WLjicQI=; b=Uyn3UF1DDhN669hOTUhsTvu1yt1XEbXbFSeHOvnyWtPQB1wRfpWtWXVB0Lo09d9+QQ679e 6yjnBso/6+MexpR+KHvXX5AQhJkL8VKaeP1yo/vf4H0cbQkrSl5c7P0lLu2lLakVbjGKyE 5cVYYbFRF4yGKmFwKiUQmoGxxleeoBQ= X-MC-Unique: 0pDL3bT_Pi6wuPwcMFl0-Q-1 X-Mimecast-MFC-AGG-ID: 0pDL3bT_Pi6wuPwcMFl0-Q_1789147350 From: John Snow To: qemu-devel@nongnu.org Cc: qemu-block@nongnu.org, Kevin Wolf , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Eric Blake , Jonathan Cameron , Lukas Straub , Paolo Bonzini , Zhao Liu , linux-cxl@vger.kernel.org, Jason Wang , Hanna Reitz , Markus Armbruster , Fabiano Rosas , Peter Xu , John Snow Subject: [PATCH 6/6] qapi: convert intro sections followed by notes/examples Date: Fri, 11 Sep 2026 13:22:00 -0400 Message-ID: <20260911172200.227914-7-jsnow@redhat.com> In-Reply-To: <20260911172200.227914-1-jsnow@redhat.com> References: <20260911172200.227914-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: 1789147401514158500 Content-Type: text/plain; charset="utf-8" These provide a rather natural cutoff point, but technically this does introduce a new intro/details split to these documentation blocks. Signed-off-by: John Snow Reviewed-by: Markus Armbruster --- qapi/machine.json | 5 ++--- qapi/migration.json | 15 +++++++-------- qapi/misc.json | 3 +-- qapi/run-state.json | 7 +++---- 4 files changed, 13 insertions(+), 17 deletions(-) diff --git a/qapi/machine.json b/qapi/machine.json index 108033b6d64..9a790da9db2 100644 --- a/qapi/machine.json +++ b/qapi/machine.json @@ -1181,9 +1181,8 @@ =20 ## # @HV_BALLOON_STATUS_REPORT: -# -# Emitted when the hv-balloon driver receives a "STATUS" message from -# the guest. +# Emitted when the hv-balloon driver receives a "STATUS" message +# from the guest. # # .. note:: This event is rate-limited. # diff --git a/qapi/migration.json b/qapi/migration.json index 70a1854fb73..c831e692feb 100644 --- a/qapi/migration.json +++ b/qapi/migration.json @@ -1241,10 +1241,10 @@ =20 ## # @migrate_cancel: -# -# Cancel the currently executing migration process. Allows a new -# migration to be started right after. When postcopy-ram is in use, -# cancelling is not allowed after the postcopy phase has started. +# Cancel the currently executing migration process. Allows a new +# migration to be started right after. When postcopy-ram is in +# use, cancelling is not allowed after the postcopy phase has +# started. # # .. note:: This command succeeds even if there is no migration # process running. @@ -1619,8 +1619,8 @@ =20 ## # @xen-colo-do-checkpoint: -# -# Xen uses this command to notify replication to trigger a checkpoint. +# Xen uses this command to notify replication to trigger a +# checkpoint. # # .. qmp-example:: # @@ -1687,8 +1687,7 @@ =20 ## # @migrate-pause: -# -# Pause a migration. Currently it only supports postcopy. +# Pause a migration. Currently it only supports postcopy. # # .. qmp-example:: # diff --git a/qapi/misc.json b/qapi/misc.json index b3c2a1421f3..ec783c067c9 100644 --- a/qapi/misc.json +++ b/qapi/misc.json @@ -103,8 +103,7 @@ =20 ## # @query-iothreads: -# -# Return a list of information about each iothread. +# Return a list of information about each iothread. # # .. note:: This list excludes the QEMU main loop thread, which is not # declared using the ``-object iothread`` command-line option. It diff --git a/qapi/run-state.json b/qapi/run-state.json index 703ca1bb5b9..8bbd9884087 100644 --- a/qapi/run-state.json +++ b/qapi/run-state.json @@ -232,10 +232,9 @@ =20 ## # @SUSPEND_DISK: -# -# Emitted when guest enters a hardware suspension state with data -# saved on disk, for example, S4 state, which is sometimes called -# hibernate state +# Emitted when guest enters a hardware suspension state with data +# saved on disk, for example, S4 state, which is sometimes called +# hibernate state # # .. note:: QEMU shuts down (similar to event `SHUTDOWN`) when # entering this state. --=20 2.55.0