Re: [PATCH 4/5] qapi: convert simple event intros for machine.json

[Markus Armbruster <armbru@redhat.com>]

John Snow <jsnow@redhat.com> writes:

> Signed-off-by: John Snow <jsnow@redhat.com>
> ---
>  qapi/machine.json | 14 ++++++--------
>  1 file changed, 6 insertions(+), 8 deletions(-)
>
> diff --git a/qapi/machine.json b/qapi/machine.json
> index 9d709cb53e0..cf905afd4f1 100644
> --- a/qapi/machine.json
> +++ b/qapi/machine.json
> @@ -1125,10 +1125,9 @@
>  
>  ##
>  # @BALLOON_CHANGE:
> -#
> -# Emitted when the guest changes the actual BALLOON level.  This value
> -# is equivalent to the @actual field return by the `query-balloon`
> -# command
> +#     Emitted when the guest changes the actual BALLOON level.  This
> +#     value is equivalent to the @actual field return by the
> +#     `query-balloon` command

@actual does not refer to the argument here, it refers to
query-balloon's result.  Harmless until we turn it into a link.  Not
fixable now, because we lack markup for such non-local references.

Yet another note of future work:

5. Implement markup for non-local argument / member / feature
references, and put it to use.

>  #
>  # @actual: the logical size of the VM in bytes.  Formula used:
>  #     logical_vm_size = vm_ram_size - balloon_size
> @@ -1556,10 +1555,9 @@
>  
>  ##
>  # @MEMORY_DEVICE_SIZE_CHANGE:
> -#
> -# Emitted when the size of a memory device changes.  Only emitted for
> -# memory devices that can actually change the size (e.g., virtio-mem
> -# due to guest action).
> +#     Emitted when the size of a memory device changes.  Only emitted
> +#     for memory devices that can actually change the size (e.g.,
> +#     virtio-mem due to guest action).
>  #
>  # @id: device's ID
>  #