Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-27 Thread Markus Armbruster
John Snow writes: > With the insertions fixed to not duplicate/triplicate things, I notice > these (unintentional) changes: > > - x-debug-block-dirty-bitmap-sha256 moves returns from above errors to below > - blockdev-snapshot-delete-internal-sync ditto > - query-xen-replication-status ditto > -

Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-26 Thread John Snow
On Tue, Mar 25, 2025 at 1:47 PM John Snow wrote: > > > On Tue, Mar 25, 2025 at 5:41 AM Markus Armbruster > wrote: > >> John Snow writes: >> >> > This patch changes the qapidoc transmogrifier to generate Return value >> > documentation for any command that has a return value but hasn't >> > expl

Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-25 Thread John Snow
On Tue, Mar 25, 2025 at 5:41 AM Markus Armbruster wrote: > John Snow writes: > > > This patch changes the qapidoc transmogrifier to generate Return value > > documentation for any command that has a return value but hasn't > > explicitly documented that return value. > > > > Signed-off-by: John

Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-25 Thread John Snow
On Tue, Mar 25, 2025 at 4:54 AM Markus Armbruster wrote: > John Snow writes: > > > This patch changes the qapidoc transmogrifier to generate Return value > > documentation for any command that has a return value but hasn't > > explicitly documented that return value. > > > > Signed-off-by: John

Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-25 Thread Markus Armbruster
John Snow writes: > This patch changes the qapidoc transmogrifier to generate Return value > documentation for any command that has a return value but hasn't > explicitly documented that return value. > > Signed-off-by: John Snow [...] > diff --git a/scripts/qapi/parser.py b/scripts/qapi/parse

Re: [PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-25 Thread Markus Armbruster
John Snow writes: > This patch changes the qapidoc transmogrifier to generate Return value > documentation for any command that has a return value but hasn't > explicitly documented that return value. > > Signed-off-by: John Snow A number of commands lack return value documentation before the p

[PATCH 2/4] docs, qapi: generate undocumented return sections

2025-03-21 Thread John Snow
This patch changes the qapidoc transmogrifier to generate Return value documentation for any command that has a return value but hasn't explicitly documented that return value. Signed-off-by: John Snow --- docs/sphinx/qapidoc.py | 14 -- scripts/qapi/parser.py | 11 +++ scrip