All of lore.kernel.org
 help / color / mirror / Atom feed
From: John Snow <jsnow@redhat.com>
To: qemu-devel@nongnu.org
Cc: Eric Blake <eblake@redhat.com>,
	Markus Armbruster <armbru@redhat.com>,
	Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com>,
	John Snow <jsnow@redhat.com>
Subject: [PATCH] qapi/control: Turn the reference to qmp-spec.rst into a link
Date: Tue, 29 Sep 2026 15:24:03 -0400	[thread overview]
Message-ID: <20260929192403.2972132-1-jsnow@redhat.com> (raw)

Add a new anchor to qmp-spec that allows us to cross-reference the
Out-of-band execution section of the spec directly.

Amend the documentation in qapi/control.json to use this new cross
reference instead of a plaintext "see also".

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: John Snow <jsnow@redhat.com>
---
 docs/interop/qmp-spec.rst | 2 ++
 qapi/control.json         | 3 +--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/interop/qmp-spec.rst b/docs/interop/qmp-spec.rst
index 563344160e6..ea713a96ac0 100644
--- a/docs/interop/qmp-spec.rst
+++ b/docs/interop/qmp-spec.rst
@@ -119,6 +119,8 @@ Where:
 
 The actual commands are documented in the :doc:`qemu-qmp-ref`.
 
+.. _out-of-band execution:
+
 Out-of-band execution
 ---------------------
 
diff --git a/qapi/control.json b/qapi/control.json
index ef63a8a261b..e97fe317af7 100644
--- a/qapi/control.json
+++ b/qapi/control.json
@@ -44,8 +44,7 @@
 #     client connection, used for agreeing on particular QMP extension
 #     behaviors.
 #
-# @oob: QMP ability to support out-of-band requests.  (Please refer to
-#     qmp-spec.rst for more information on OOB)
+# @oob: QMP ability to support :ref:`out-of-band execution` requests.
 #
 # Since: 2.12
 ##
-- 
2.55.0



             reply	other threads:[~2026-09-29 19:24 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-09-29 19:24 John Snow [this message]
2026-10-05 19:32 ` [PATCH] qapi/control: Turn the reference to qmp-spec.rst into a link Eric Blake
2026-10-07 18:42 ` John Snow
2026-10-08  4:28   ` Markus Armbruster
  -- strict thread matches above, loose matches on Subject: below --
2026-09-28  6:32 Markus Armbruster
2026-09-28 18:03 ` John Snow
2026-09-29  4:43   ` Markus Armbruster

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260929192403.2972132-1-jsnow@redhat.com \
    --to=jsnow@redhat.com \
    --cc=armbru@redhat.com \
    --cc=eblake@redhat.com \
    --cc=pierrick.bouvier@oss.qualcomm.com \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.