From nobody Sat Nov 15 07:41:36 2025 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=1753941587; cv=none; d=zohomail.com; s=zohoarc; b=ly73hazX/M7ckWV2wx3vfoFc/XpxAK8GkwsL21Rixe5a0JyS02b/ziwxjmEp9P5EgSWT1zwO0BB3FmbHOeQuqWCeVoZsF/QZCdbcOO3XjlkuiU0hWvfsdV3h++BHdTZVm6yPdhPvt6Wf+OV6oucKHpdH7lyivntzumb7l2idQKE= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1753941587; 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=DwKA6S0KFU4nBOVzjyx4hO0ycAGxuTaHJxmqRv93Y1o=; b=R3RW5AYjPCx16E8rq+nvdEg7pXZzEomsBC0JkqoZ4VUyqIan5y7uYCEvqvqS7uh7AXyufo2M1IJzfTMn8Q1FsFaA+yhqrgIiAYutHA/2u3e3xmCF54j6pubfsbssp2RqZfwnVb3jcdJb80Zq7ug3eGdbCbKPMROfwwuOH8Y6FFk= 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 lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1753941587381134.53634557633256; Wed, 30 Jul 2025 22:59:47 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uhMID-0005ZM-TW; Thu, 31 Jul 2025 01:57:30 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uhM2C-0006fm-MZ for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:59 -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 1uhM29-0000aI-P1 for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:56 -0400 Received: from mx-prod-mc-02.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-401-GOa3E96tO7OqgO9N2vkoyg-1; Thu, 31 Jul 2025 01:40:48 -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-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 05B0A1956089; Thu, 31 Jul 2025 05:40:48 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.14]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 87BDE19560A2; Thu, 31 Jul 2025 05:40:47 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id EFE5721E6924; Thu, 31 Jul 2025 07:40:44 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1753940452; 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=DwKA6S0KFU4nBOVzjyx4hO0ycAGxuTaHJxmqRv93Y1o=; b=QfU8Fs/CdpeTHkaM/pcfEAGZWbP8GWxvvYFZ07cK9K/Wrxoxm0Yvs7AYMp5Z3rmjI/K+Ws 0ULLPbuSVtVGN2bPYFVwnEag5c6FxpTm6uY3UUGATQ1SgpuHe3jBMogjpja3QzsxCX3fte szNquoP8Fg1/1haVDSIYLQzSvwmNO6I= X-MC-Unique: GOa3E96tO7OqgO9N2vkoyg-1 X-Mimecast-MFC-AGG-ID: GOa3E96tO7OqgO9N2vkoyg_1753940448 From: Markus Armbruster To: qemu-devel@nongnu.org Cc: michael.roth@amd.com, jsnow@redhat.com, peter.maydell@linaro.org, eblake@redhat.com Subject: [PATCH 1/3] docs/devel/qapi-code-gen: Add two cross-references we missed Date: Thu, 31 Jul 2025 07:40:42 +0200 Message-ID: <20250731054044.4011789-2-armbru@redhat.com> In-Reply-To: <20250731054044.4011789-1-armbru@redhat.com> References: <20250731054044.4011789-1-armbru@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=lists.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=armbru@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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, 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: 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: 1753941588650124100 Content-Type: text/plain; charset="utf-8" Missed in commit 9c66762a601 (docs/qapi-code-gen: add cross-references). Signed-off-by: Markus Armbruster Reviewed-by: John Snow --- docs/devel/qapi-code-gen.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst index dfdbeac5a5..138921b386 100644 --- a/docs/devel/qapi-code-gen.rst +++ b/docs/devel/qapi-code-gen.rst @@ -646,9 +646,9 @@ Member 'event' names the event. This is the event name= used in the Client JSON Protocol. =20 Member 'data' defines the event-specific data. It defaults to an -empty MEMBERS object. +empty MEMBERS_ object. =20 -If 'data' is a MEMBERS object, then MEMBERS defines event-specific +If 'data' is a MEMBERS_ object, then MEMBERS defines event-specific data just like a struct type's 'data' defines struct type members. =20 If 'data' is a STRING, then STRING names a complex type whose members --=20 2.49.0 From nobody Sat Nov 15 07:41:36 2025 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=1753941453; cv=none; d=zohomail.com; s=zohoarc; b=ZjWraOLKUz/kSN5q15RdYPpvc5HO5MI304HFVOd6JjPn35ECXVPGyAilJIMAxIvfD8bJpeKhegUFy4o6oqnA3/uendYDy3wpfiFerNxG2tJaihpKV9R1CI4UjMMEhl3FT5+OWuxkHd9A7xq1o4VwCTVmS5w5jSm3afrSLXpQhHQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1753941453; 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=2l67yeJOXmVTzuN0itdgKoBWG2VnZse+KoTndM93sI0=; b=Cm2IzYkIp+hANiGFUHhOuUJPQwt7Kxf8tj4sd9cpmndsxRGZjbVhywBWIrGGPdf/O4BkTsMBXCT613eVrupeQf2Gzy9dw41/aNlJTucgUljCHnDmsZH9RkDPYRdIbjMBmmC5eCbqDQ7bnz06mCGmJY+epiRoWqGTdtBEqXwzbDU= 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 lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1753941453529127.25458578364635; Wed, 30 Jul 2025 22:57:33 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uhMIC-0005WP-3s; Thu, 31 Jul 2025 01:57:28 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uhM2C-0006fi-DH for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:59 -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 1uhM29-0000aJ-Pa for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:56 -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-641-I9fqDLAiNteBZ55fmNtXUQ-1; Thu, 31 Jul 2025 01:40:49 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (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 0AC6D19560AA; Thu, 31 Jul 2025 05:40:48 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.14]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 95D841800D85; Thu, 31 Jul 2025 05:40:47 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id F3F6721E6925; Thu, 31 Jul 2025 07:40:44 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1753940452; 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=2l67yeJOXmVTzuN0itdgKoBWG2VnZse+KoTndM93sI0=; b=fJiQ0FdV0eKOMCjIcdUAjShxmoCCYAQ57VQ1e55muxzF5H+M6tdnKuHtfcVtQfRv7TB/t0 ovGUq8nLP7gBiMScY1nnDRTH0/cp/YqmRWulPY3lW3Ri4jbFjnVefU5Q79TIIHWx99kRRa RrooktdxsGPiHmpH4drEYMr4YNk/IH8= X-MC-Unique: I9fqDLAiNteBZ55fmNtXUQ-1 X-Mimecast-MFC-AGG-ID: I9fqDLAiNteBZ55fmNtXUQ_1753940448 From: Markus Armbruster To: qemu-devel@nongnu.org Cc: michael.roth@amd.com, jsnow@redhat.com, peter.maydell@linaro.org, eblake@redhat.com Subject: [PATCH 2/3] docs/devel/qapi-code-gen: Fix typos in QAPI schema language grammar Date: Thu, 31 Jul 2025 07:40:43 +0200 Message-ID: <20250731054044.4011789-3-armbru@redhat.com> In-Reply-To: <20250731054044.4011789-1-armbru@redhat.com> References: <20250731054044.4011789-1-armbru@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 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=lists.gnu.org; Received-SPF: pass client-ip=170.10.129.124; envelope-from=armbru@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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, 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: 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: 1753941456023124100 Content-Type: text/plain; charset="utf-8" Fixes: 3248c1aaf2db (docs: update the documentation upfront about schema co= nfiguration) Signed-off-by: Markus Armbruster Reviewed-by: John Snow --- docs/devel/qapi-code-gen.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst index 138921b386..2cd51729c3 100644 --- a/docs/devel/qapi-code-gen.rst +++ b/docs/devel/qapi-code-gen.rst @@ -786,8 +786,8 @@ Configuring the schema Syntax:: =20 COND =3D STRING - | { 'all: [ COND, ... ] } - | { 'any: [ COND, ... ] } + | { 'all': [ COND, ... ] } + | { 'any': [ COND, ... ] } | { 'not': COND } =20 All definitions take an optional 'if' member. Its value must be a --=20 2.49.0 From nobody Sat Nov 15 07:41:36 2025 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=1753941463; cv=none; d=zohomail.com; s=zohoarc; b=CJ1RckPxrxI7HVnP+cJsn/pI7Q+A99jTI3SzYpkCnG2S6eG5EE8ZtcTmoMi+IYnU3rChf16TNt4/eOpt5f5kyzuEmANkBbdTUWOEm/YHd9su+NkDixbjuxmDkUUJL48FsYzzPTQ/qB4TBsG8TtIPuHrQ+ylyPIpy/D+qeke+JnQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1753941463; 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=0FC2RThKztReibi8ESu44zKPCwpuxR8vM7hXq6EN5eU=; b=FEKNIy5ogWubnBJExg8RVbT1C1WOV7pbVuQt4w0HVjZdfIDMs3mgJJ8Yo/lXGoOWvJ3gT70wZMfAtaLM1mhplAVxxt6Cm7HV2mFelOAtLXtsDOp94hM9XUN91HbbeILRan5vbHpUOOVmrQkLooRyKbgN/tY9/zh1+ItU7Hnbh10= 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 lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1753941463765451.8009313279033; Wed, 30 Jul 2025 22:57:43 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uhMI9-0005TW-Uo; Thu, 31 Jul 2025 01:57:25 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uhM2B-0006fF-Dm for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:58 -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 1uhM29-0000a4-Oa for qemu-devel@nongnu.org; Thu, 31 Jul 2025 01:40:55 -0400 Received: from mx-prod-mc-02.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-146-P5f4k6zbPeyhbOuWbif3Ig-1; Thu, 31 Jul 2025 01:40:49 -0400 Received: from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93]) (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-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 223FB195609D; Thu, 31 Jul 2025 05:40:48 +0000 (UTC) Received: from blackfin.pond.sub.org (unknown [10.45.242.14]) by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id AF1B21800D86; Thu, 31 Jul 2025 05:40:47 +0000 (UTC) Received: by blackfin.pond.sub.org (Postfix, from userid 1000) id 03E6D21E6935; Thu, 31 Jul 2025 07:40:45 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1753940451; 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=0FC2RThKztReibi8ESu44zKPCwpuxR8vM7hXq6EN5eU=; b=N7ey5OHcg0P/3uwolHFkmy9rrnHAO7KAiWQT6AoHz++LScD0CCsoLyrA5Yu7GPasZuGMin MlCk4RYcS+HJGYYUvSX1X2JV9voGJrSwYz6sHn4y+w8ZSf1C9OtI9GzUjjGufZ9r8t/H/H fY2qce8dd7aDA6eQ8Qhpt+ONte3Oa1Q= X-MC-Unique: P5f4k6zbPeyhbOuWbif3Ig-1 X-Mimecast-MFC-AGG-ID: P5f4k6zbPeyhbOuWbif3Ig_1753940448 From: Markus Armbruster To: qemu-devel@nongnu.org Cc: michael.roth@amd.com, jsnow@redhat.com, peter.maydell@linaro.org, eblake@redhat.com Subject: [PATCH 3/3] docs/devel/qapi-code-gen: Update cross-reference syntax Date: Thu, 31 Jul 2025 07:40:44 +0200 Message-ID: <20250731054044.4011789-4-armbru@redhat.com> In-Reply-To: <20250731054044.4011789-1-armbru@redhat.com> References: <20250731054044.4011789-1-armbru@redhat.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.93 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=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=armbru@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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_SBL_CSS=3.335, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, 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: 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: 1753941465965124100 Content-Type: text/plain; charset="utf-8" The new QAPI code generator creates a cross-reference target for each definition documentation. Enabled for the QEMU QMP Reference manual in commit a377f39f38f, and for the QEMU Storage Daemon QMP Reference Manual and the QEMU Guest Agent Protocol Reference in commit a6af5443440. We've put these targets to use since, but neglected to update doc comment markup documentation. Do that now. Co-developed-by: John Snow Signed-off-by: John Snow Signed-off-by: Markus Armbruster Reviewed-by: John Snow --- docs/devel/qapi-code-gen.rst | 11 ++++++++--- docs/devel/qapi-domain.rst | 1 + 2 files changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst index 2cd51729c3..d97602f464 100644 --- a/docs/devel/qapi-code-gen.rst +++ b/docs/devel/qapi-code-gen.rst @@ -943,9 +943,14 @@ The usual ****strong****, *\*emphasized\** and ````lit= eral```` markup should be used. If you need a single literal ``*``, you will need to backslash-escape it. =20 -Use ``@foo`` to reference a name in the schema. This is an rST -extension. It is rendered the same way as ````foo````, but carries -additional meaning. +Use ```foo``` to reference a definition in the schema. This generates +a link to the definition. In the event that such a cross-reference is +ambiguous, you can use `QAPI cross-reference roles +` to disambiguate. + +Use @foo to reference a member description within the current +definition. This is an rST extension. It is currently rendered the +same way as ````foo````, but carries additional meaning. =20 Example:: =20 diff --git a/docs/devel/qapi-domain.rst b/docs/devel/qapi-domain.rst index fe540d1e40..1924f12d42 100644 --- a/docs/devel/qapi-domain.rst +++ b/docs/devel/qapi-domain.rst @@ -375,6 +375,7 @@ Will allow you to add arbitrary field lists in QAPI dir= ectives:: =20 :see also: Lorem ipsum, dolor sit amet ... =20 +.. _QAPI-domain-cross-references: =20 Cross-references =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.49.0