Re: [PATCH 08/29] qapi: Use ':' after @argument in doc comments

[Kevin Wolf]

Am 07.02.2020 um 16:01 hat Max Reitz geschrieben:
> On 07.02.20 15:43, Markus Armbruster wrote:
> 
> [...]
> 
> >     # @file:
> >     # Node to create the image format on
> >     #
> >     # @size:
> >     # Size of the virtual disk in bytes
> >     #
> >     # @log-size:
> >     # Log size in bytes, must be a multiple of 1 MB (default: 1 MB)
> >     #
> >     # @block-size:
> >     # Block size in bytes, must be a multiple of 1 MB and not larger
> >     # than 256 MB (default: automatically choose a block size depending
> >     # on the image size)
> >     #
> >     # @subformat:
> >     # vhdx subformat (default: dynamic)
> >     #
> >     # @block-state-zero:
> >     # Force use of payload blocks of type 'ZERO'.  Non-standard, but
> >     # default.  Do not set to 'off' when using 'qemu-img convert' with
> >     # subformat=dynamic.
> 
> FWIW, I like this one.

Looks like a workable compromise to me, too.

Kevin

signature.asc
Description: PGP signature