From: Markus Armbruster <armbru@redhat.com>
To: John Snow <jsnow@redhat.com>
Cc: qemu-devel@nongnu.org, "Zhao Liu" <zhao1.liu@intel.com>,
"Igor Mammedov" <imammedo@redhat.com>,
"Vladimir Sementsov-Ogievskiy" <vsementsov@yandex-team.ru>,
"Jason Wang" <jasowangio@gmail.com>,
"Eric Blake" <eblake@redhat.com>,
"Paolo Bonzini" <pbonzini@redhat.com>,
"Hanna Reitz" <hreitz@redhat.com>,
"Ani Sinha" <anisinha@redhat.com>,
"Daniel P. Berrangé" <berrange@redhat.com>,
"Fabiano Rosas" <farosas@suse.de>, "Peter Xu" <peterx@redhat.com>,
"Marc-André Lureau" <marcandre.lureau@redhat.com>,
"Philippe Mathieu-Daudé" <philmd@oss.qualcomm.com>,
"Kevin Wolf" <kwolf@redhat.com>,
"Michael S. Tsirkin" <mst@redhat.com>,
qemu-block@nongnu.org,
"Philippe Mathieu-Daudé" <philmd@mailo.com>
Subject: Re: [PATCH v3 06/10] qapi: convert/split intros for commands
Date: Tue, 29 Sep 2026 08:22:18 +0200 [thread overview]
Message-ID: <87a4p037c5.fsf@pond.sub.org> (raw)
In-Reply-To: <20260928192557.509157-7-jsnow@redhat.com> (John Snow's message of "Mon, 28 Sep 2026 15:25:53 -0400")
John Snow <jsnow@redhat.com> writes:
> Convert or split apart the existing intro for any remaining commands
> in the QAPI schema 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 `netdev_add` in
> particular, whose arguments descriptions are pushed upwards.
Missing: query-stats arguments and query-gic-capabilities "Return:" move
up.
>
> Minor rephrasings are applied for `query-qmp-schema` to help
> the split flow better in rendered documentation.
>
> Signed-off-by: John Snow <jsnow@redhat.com>
Happy to adjust commit messages without a respin.
next prev parent reply other threads:[~2026-09-29 6:23 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-28 19:25 [PATCH v3 00/10] qapi: convert/split remaining QAPI/QMP intro sections John Snow
2026-09-28 19:25 ` [PATCH v3 01/10] qapi: split intro for HV_BALLOON_STATUS_REPORT John Snow
2026-09-28 19:25 ` [PATCH v3 02/10] qapi: convert/split intros for block-core.json commands John Snow
2026-09-29 6:00 ` Markus Armbruster
2026-09-29 14:58 ` John Snow
2026-09-28 19:25 ` [PATCH v3 03/10] qapi: convert/split intros for block commands John Snow
2026-09-29 6:17 ` Markus Armbruster
2026-09-29 14:59 ` John Snow
2026-09-28 19:25 ` [PATCH v3 04/10] qapi: convert/split intros for job.json commands John Snow
2026-09-28 19:25 ` [PATCH v3 05/10] qapi: convert/split intros for misc-i386.json commands John Snow
2026-09-28 19:25 ` [PATCH v3 06/10] qapi: convert/split intros for commands John Snow
2026-09-29 6:22 ` Markus Armbruster [this message]
2026-09-29 15:03 ` John Snow
2026-09-28 19:25 ` [PATCH v3 07/10] qapi: convert/split intros for enums John Snow
2026-09-28 19:25 ` [PATCH v3 08/10] qapi: split intro sections for events John Snow
2026-09-28 19:25 ` [PATCH v3 09/10] qapi: split intro sections for data structs John Snow
2026-09-28 19:25 ` [PATCH v3 10/10] qapi: split intro sections for inlinable structs John Snow
2026-09-29 6:24 ` Markus Armbruster
2026-09-29 15:03 ` John Snow
2026-09-29 6:32 ` [PATCH v3 00/10] qapi: convert/split remaining QAPI/QMP intro sections 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=87a4p037c5.fsf@pond.sub.org \
--to=armbru@redhat.com \
--cc=anisinha@redhat.com \
--cc=berrange@redhat.com \
--cc=eblake@redhat.com \
--cc=farosas@suse.de \
--cc=hreitz@redhat.com \
--cc=imammedo@redhat.com \
--cc=jasowangio@gmail.com \
--cc=jsnow@redhat.com \
--cc=kwolf@redhat.com \
--cc=marcandre.lureau@redhat.com \
--cc=mst@redhat.com \
--cc=pbonzini@redhat.com \
--cc=peterx@redhat.com \
--cc=philmd@mailo.com \
--cc=philmd@oss.qualcomm.com \
--cc=qemu-block@nongnu.org \
--cc=qemu-devel@nongnu.org \
--cc=vsementsov@yandex-team.ru \
--cc=zhao1.liu@intel.com \
/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.