On 2020/11/9 23:57, Eric Blake wrote:
> On 11/9/20 3:08 AM, Zeyu Jin wrote:
>> A multi-thread compress method parameter is added to hold the method we
>> are going to use. By default the 'zlib' method is used to maintain the
>> compatibility as before.
>>
>> Signed-off-by: Zeyu Jin <[email protected]>
>> Signed-off-by: Ying Fang <[email protected]>
>> ---
>
> Focusing on just the UI:
>
>> +++ b/qapi/migration.json
>> @@ -525,6 +525,19 @@
>> 'data': [ 'none', 'zlib',
>> { 'name': 'zstd', 'if': 'defined(CONFIG_ZSTD)' } ] }
>>
>> +##
>> +# @CompressMethod:
>> +#
>> +# An enumeration of multi-thread compression methods.
>> +#
>> +# @zlib: use zlib compression method.
>> +#
>> +# Since: 5.0
>
> This will have to be Since: 6.0, as it has missed feature freeze for 5.2.
>
Thank you for noticing. I will fix that.
>> +#
>> +##
>> +{ 'enum': 'CompressMethod',
>> + 'data': [ 'zlib' ] }
>> +
>> ##
>> # @BitmapMigrationBitmapAlias:
>> #
>> @@ -599,6 +612,9 @@
>> # compression, so set the decompress-threads to the
>> number about 1/4
>> # of compress-threads is adequate.
>> #
>> +# @compress-method: Set compression method to use in multi-thread
>> compression.
>> +# Defaults to none. (Since 5.0)
>
> Looks like it will be a recurring issue in the series, so I'll quit
> pointing it out.
>
> CompressMethod above does not have a 'none' option, so how can it
> default to none? Did you forget an enum option?
>
Actually this is a comment mistake. The default option is expected to
be 'zlib'. I will fix the comment.