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

2025-04-03 Thread John Snow
On Tue, Apr 1, 2025 at 2:07 AM Markus Armbruster wrote: > John Snow writes: > > > On Thu, Mar 27, 2025 at 5:11 AM Markus Armbruster > wrote: > > > >> John Snow writes: > >> > >> > This patch changes the qapidoc transmogrifier to generate Return value > >> > documentation for any command that h

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

2025-03-31 Thread Markus Armbruster
John Snow writes: > On Thu, Mar 27, 2025 at 5:11 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.

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

2025-03-31 Thread John Snow
On Thu, Mar 27, 2025 at 5:11 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 v2 2/4] docs, qapi: generate undocumented return sections

2025-03-27 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 Might want to briefly explain placement of the auto-generated ret

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

2025-03-26 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 | 15 +++ s