On Thu, Jul 11, 2024, 7:22 AM Markus Armbruster <arm...@redhat.com> wrote:
> When no UUID has been specified, query-uuid returns
>
> {"UUID": "00000000-0000-0000-0000-000000000000"}
>
> The doc comment calls this "a null UUID", which I find less than
> clear. Change it to "an all-zero UUID".
>
Technically it's a "nil UUID";
https://datatracker.ietf.org/doc/html/rfc9562#name-nil-uuid
If you wanted to be pedantic, you could say "the nil UUID (all zeroes) is
returned"
but your rephrasing is clear even w/o using the standard name, so I'm fine
either way.
> Signed-off-by: Markus Armbruster <arm...@redhat.com>
>
Reviewed-by: John Snow <js...@redhat.com>
---
> qapi/machine.json | 5 ++---
> 1 file changed, 2 insertions(+), 3 deletions(-)
>
> diff --git a/qapi/machine.json b/qapi/machine.json
> index 50ff102d56..f40427f21a 100644
> --- a/qapi/machine.json
> +++ b/qapi/machine.json
> @@ -305,9 +305,8 @@
> #
> # Since: 0.14
> #
> -# .. note:: If no UUID was specified for the guest, a null UUID is
> -# returned.
> -#
> +# .. note:: If no UUID was specified for the guest, an all-zero UUID
> +# is returned.
> ##
> { 'struct': 'UuidInfo', 'data': {'UUID': 'str'} }
>
> --
> 2.45.0
>
>
