Re: [PATCH v6 1/4] docs/qapi-domain: add return-nodesc

2025-07-11 Thread Markus Armbruster
John Snow writes: > This form is used to annotate a return type without an accompanying > description, for when there is no "Returns:" information in the source > doc, but we have a return type we want to generate a cross-reference to. > > The syntax is: > > :return-nodesc: TypeName > > It's prim

[PATCH v6 1/4] docs/qapi-domain: add return-nodesc

2025-07-10 Thread John Snow
This form is used to annotate a return type without an accompanying description, for when there is no "Returns:" information in the source doc, but we have a return type we want to generate a cross-reference to. The syntax is: :return-nodesc: TypeName It's primarily necessary because Sphinx alwa