On Thu, Nov 12, 2026 at 8:49 PM Daniel P. Berrangé <[email protected]> wrote:
>
> Follow the proper QAPI syntax for deprecations and mention it
> in the documentation.
>
> Reported-by: Marc-André Lureau <[email protected]>
> Reported-by: Markus Armbruster <[email protected]>
> Signed-off-by: Daniel P. Berrangé <[email protected]>

Reviewed-by: Marc-André Lureau <[email protected]>

> ---
>  docs/about/deprecated.rst |  8 ++++++++
>  qapi/trace.json           | 10 ++++++++--
>  2 files changed, 16 insertions(+), 2 deletions(-)
>
> diff --git a/docs/about/deprecated.rst b/docs/about/deprecated.rst
> index 0891bbc44de..a39feb23f5b 100644
> --- a/docs/about/deprecated.rst
> +++ b/docs/about/deprecated.rst
> @@ -182,6 +182,14 @@ execution.  This special treatment of ``"no"`` is 
> deprecated.  Use an
>  empty string instead.  In a future version, ``"no"`` will be treated as
>  a plain file name.
>
> +``ignore-unavailable`` in ``trace-event-set-state`` (since 11.2)
> +''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
> +
> +Trace events are now unconditionally built-in to all QEMU builds,
> +so the concept of an 'unavailable' trace event no longer exists.
> +The ``ignore-unavailable`` parameter in ``trace-event-set-state``
> +thus has no effect and should no longer be used.
> +
>  Human Machine Protocol (HMP) commands
>  -------------------------------------
>
> diff --git a/qapi/trace.json b/qapi/trace.json
> index 8533e378977..5792a436115 100644
> --- a/qapi/trace.json
> +++ b/qapi/trace.json
> @@ -67,10 +67,14 @@
>  # @enable: Whether to enable tracing.
>  #
>  # @ignore-unavailable: Do not match unavailable events with @name.
> -#      Deprecated: since 11.2
>  #
>  # Since: 2.2
>  #
> +# Features:
> +#
> +# @deprecated: @ignore-unavailable no longer has any effect
> +#    (since 11.2)
> +#
>  # .. qmp-example::
>  #
>  #     -> { "execute": "trace-event-set-state",
> @@ -78,4 +82,6 @@
>  #     <- { "return": {} }
>  ##
>  { 'command': 'trace-event-set-state',
> -  'data': {'name': 'str', 'enable': 'bool', '*ignore-unavailable': 'bool' } }
> +  'data': {'name': 'str', 'enable': 'bool',
> +           '*ignore-unavailable': { 'type': 'bool',
> +                                    'features': ['deprecated'] } } }
> --
> 2.56.1
>

Reply via email to