qemu-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH 10/17] tests/qapi-schema/doc-good: Improve argument descripti


From: Juan Quintela
Subject: Re: [PATCH 10/17] tests/qapi-schema/doc-good: Improve argument description tests
Date: Fri, 28 Apr 2023 20:08:48 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux)

Markus Armbruster <armbru@redhat.com> wrote:
> Improve the comments to better describe what they test.
>
> Cover argument description starting on a new line indented.  This
> style isn't documented in docs/devel/qapi-code-gen.rst.  qapi-gen.py
> accepts it, but messes up indentation: it's stripped from the first
> line, not subsequent ones.  The next commit will fix this.
>
> Signed-off-by: Markus Armbruster <armbru@redhat.com>

Reviewed-by: Juan Quintela <quintela@redhat.com>

>  ##
>  # @Alternate:
>  #
> -# @i: an integer
> +# @i: description starts on the same line
> +#     remainder indented the same
>  #     @b is undocumented
>  #
>  # Features:

Just curious, what is trying to convey this
   @b is undocumented
At the same indentation that the description of @i?




reply via email to

[Prev in Thread] Current Thread [Next in Thread]