Re: [Qemu-devel] [PATCH for-2.10 10/10] migration: Use JSON null instead of "" to reset parameter to default

[Eric Blake]

On 07/18/2017 01:39 PM, Markus Armbruster wrote:

>>> +++ b/qapi-schema.json
>>> @@ -116,6 +116,13 @@
>>>  { 'command': 'qmp_capabilities' }
>>>  
>>>  ##
>>> +# @StrOrNull:
>>
>> A little light on the documentation.
> 
> Care to suggest improvements?  I figure the schema is obvious enough
> without any, but the generated documentation could perhaps use some.

Perhaps:

Specifies a string value or the explicit lack of a string (often used as
an optional parameter type, where omitting the parameter has different
semantics than supplying null).
@s a JSON string
@n an explicit NULL


and certainly worth having

Since: 2.10

-- 
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3266
Virtualization:  qemu.org | libvirt.org

signature.asc
Description: OpenPGP digital signature