From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists1p.gnu.org (lists1p.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 35544CA5FA6 for ; Mon, 28 Sep 2026 19:26:55 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists1p.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1xBGzd-0003jW-V4; Mon, 28 Sep 2026 15:26: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 1xBGzb-0003iT-Sr for qemu-devel@nongnu.org; Mon, 28 Sep 2026 15:26:27 -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 1xBGza-000362-A9 for qemu-devel@nongnu.org; Mon, 28 Sep 2026 15:26:27 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1790623585; 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=z2HWAQ86+atIeFzN4ZREQoRqGPBcElYrTFTxdHTUDMs=; b=TXLFKxJdrboIQKX64T1FAQoIOTZZaFiysowYlplIl7cm+YLyiEzNb0VAJadiCSlFuvkueS GTJC0Iq7Y8lY7Zyvnco49SpHx7/1k+nveyBaeNPdE95Y/jKv5XddjVb1SqmDm1Amkrl+69 3aRMp8xfB6N+FHzkiDaP+pYcVy9XoVc= 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-327-QpYCTreNNF6qsswZbs3-VA-1; Mon, 28 Sep 2026 15:26:22 -0400 X-MC-Unique: QpYCTreNNF6qsswZbs3-VA-1 X-Mimecast-MFC-AGG-ID: QpYCTreNNF6qsswZbs3-VA_1790623581 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 7E5E118301DB; Mon, 28 Sep 2026 19:26:20 +0000 (UTC) Received: from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.64.217]) by mx-prod-int-10.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 1DE235BC; Mon, 28 Sep 2026 19:26:17 +0000 (UTC) From: John Snow To: qemu-devel@nongnu.org Cc: Zhao Liu , Igor Mammedov , Vladimir Sementsov-Ogievskiy , Jason Wang , Eric Blake , Markus Armbruster , Paolo Bonzini , Hanna Reitz , Ani Sinha , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Fabiano Rosas , Peter Xu , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Kevin Wolf , "Michael S. Tsirkin" , qemu-block@nongnu.org, John Snow , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PATCH v3 05/10] qapi: convert/split intros for misc-i386.json commands Date: Mon, 28 Sep 2026 15:25:52 -0400 Message-ID: <20260928192557.509157-6-jsnow@redhat.com> In-Reply-To: <20260928192557.509157-1-jsnow@redhat.com> References: <20260928192557.509157-1-jsnow@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Scanned-By: MIMEDefang 3.6 on 10.30.177.95 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: -22 X-Spam_score: -2.3 X-Spam_bar: -- X-Spam_report: (-2.3 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.238, 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+qemu-devel=archiver.kernel.org@nongnu.org Sender: qemu-devel-bounces+qemu-devel=archiver.kernel.org@nongnu.org Convert or split apart the existing intro for commands in misc-i386.json into introduction and details sections. The introduction is indented, remaining plaintext/details paragraphs are not. For commands that have automatically generated documentation inserted at parse time, these new split points serve as the new insertion point. This affects the rendered documentation for `query-sev` in particular, whose "Returns:" documentation is pushed upwards. Signed-off-by: John Snow --- qapi/misc-i386.json | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/qapi/misc-i386.json b/qapi/misc-i386.json index 78ec9aec647..6e0ab46b8ea 100644 --- a/qapi/misc-i386.json +++ b/qapi/misc-i386.json @@ -5,10 +5,9 @@ ## # @rtc-reset-reinjection: -# -# Reset the RTC interrupt reinjection backlog. Can be used if another -# mechanism to synchronize guest time is in effect, for example QEMU -# guest agent's `guest-set-time` command. +# Reset the RTC interrupt reinjection backlog. Can be used if +# another mechanism to synchronize guest time is in effect, for +# example QEMU guest agent's `guest-set-time` command. # # Use of this command is only applicable for x86 machines with an RTC, # and on other machines will silently return without performing any @@ -119,8 +118,7 @@ ## # @query-sev: -# -# Return information about SEV/SEV-ES/SEV-SNP. +# Return information about SEV/SEV-ES/SEV-SNP. # # If unavailable due to an incompatible configuration the returned # @enabled field is set to 'false' and the state of all other fields @@ -149,8 +147,7 @@ ## # @query-sev-launch-measure: -# -# Query the SEV/SEV-ES guest launch information. +# Query the SEV/SEV-ES guest launch information. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. The launch @@ -199,8 +196,7 @@ ## # @query-sev-capabilities: -# -# Get SEV capabilities. +# Get SEV capabilities. # # This is only supported on AMD X86 platforms with KVM enabled. # @@ -220,8 +216,7 @@ ## # @sev-inject-launch-secret: -# -# Inject a secret blob into a SEV/SEV-ES guest's memory. +# Inject a secret blob into a SEV/SEV-ES guest's memory. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. SEV-SNP guests do @@ -257,8 +252,7 @@ ## # @query-sev-attestation-report: -# -# Get the SEV attestation report. +# Get the SEV attestation report. # # This is only valid on x86 machines configured with KVM and the # 'sev-guest' confidential virtualization object. The attestation -- 2.55.0