On Thu, Jul 17, 2025 at 10:21:15AM +0200, Markus Armbruster wrote:
> The QAPI doc generator recently started to auto-generate return
> documentation when there is no "Returns:" section (commit 636c96cd77d
> "qapi: Fix undocumented return values by generating something").
> Remove "Returns:" sections where the auto-generated text is obviously
> no worse.  For instance, guest-info's documentation changes from
> 
>     Return:
>        GuestAgentInfo -- GuestAgentInfo
> 
> to
> 
>     Return:
>        GuestAgentInfo
> 
> The auto-generated returns all are in the exact same spot.
> 
> We did this for qapi/ in commit 0462da9d6b1 (qapi: remove trivial
> "Returns:" sections).
> 
> Signed-off-by: Markus Armbruster <arm...@redhat.com>
> ---
>  qga/qapi-schema.json | 25 -------------------------
>  1 file changed, 25 deletions(-)

Reviewed-by: Daniel P. Berrangé <berra...@redhat.com>


With regards,
Daniel
-- 
|: https://berrange.com      -o-    https://www.flickr.com/photos/dberrange :|
|: https://libvirt.org         -o-            https://fstop138.berrange.com :|
|: https://entangle-photo.org    -o-    https://www.instagram.com/dberrange :|


Reply via email to