mirror of
https://github.com/qemu/qemu.git
synced 2025-09-27 00:22:24 +00:00
6c10778826
Remove the QAPI doc section heading syntax, use plain rST section headings instead. Tests and documentation are updated to match. Interestingly, Plain rST headings work fine before this patch, except for over- and underlining with '=', which the doc parser rejected as invalid QAPI doc section heading in free-form comments. Signed-off-by: John Snow <jsnow@redhat.com> Message-ID: <20250618165353.1980365-5-jsnow@redhat.com> Reviewed-by: Markus Armbruster <armbru@redhat.com> [Add more detail to commit message] Signed-off-by: Markus Armbruster <armbru@redhat.com>
72 lines
1.6 KiB
Python
72 lines
1.6 KiB
Python
# -*- Mode: Python -*-
|
|
# vim: filetype=python
|
|
|
|
##
|
|
# ********************
|
|
# Compatibility policy
|
|
# ********************
|
|
##
|
|
|
|
##
|
|
# @CompatPolicyInput:
|
|
#
|
|
# Policy for handling "funny" input.
|
|
#
|
|
# @accept: Accept silently
|
|
#
|
|
# @reject: Reject with an error
|
|
#
|
|
# @crash: abort() the process
|
|
#
|
|
# Since: 6.0
|
|
##
|
|
{ 'enum': 'CompatPolicyInput',
|
|
'data': [ 'accept', 'reject', 'crash' ] }
|
|
|
|
##
|
|
# @CompatPolicyOutput:
|
|
#
|
|
# Policy for handling "funny" output.
|
|
#
|
|
# @accept: Pass on unchanged
|
|
#
|
|
# @hide: Filter out
|
|
#
|
|
# Since: 6.0
|
|
##
|
|
{ 'enum': 'CompatPolicyOutput',
|
|
'data': [ 'accept', 'hide' ] }
|
|
|
|
##
|
|
# @CompatPolicy:
|
|
#
|
|
# Policy for handling deprecated management interfaces.
|
|
#
|
|
# This is intended for testing users of the management interfaces.
|
|
#
|
|
# Limitation: covers only syntactic aspects of QMP, i.e. stuff tagged
|
|
# with feature 'deprecated' or 'unstable'. We may want to extend it
|
|
# to cover semantic aspects and CLI.
|
|
#
|
|
# Limitation: deprecated-output policy @hide is not implemented for
|
|
# enumeration values. They behave the same as with policy @accept.
|
|
#
|
|
# @deprecated-input: how to handle deprecated input (default 'accept')
|
|
#
|
|
# @deprecated-output: how to handle deprecated output (default
|
|
# 'accept')
|
|
#
|
|
# @unstable-input: how to handle unstable input (default 'accept')
|
|
# (since 6.2)
|
|
#
|
|
# @unstable-output: how to handle unstable output (default 'accept')
|
|
# (since 6.2)
|
|
#
|
|
# Since: 6.0
|
|
##
|
|
{ 'struct': 'CompatPolicy',
|
|
'data': { '*deprecated-input': 'CompatPolicyInput',
|
|
'*deprecated-output': 'CompatPolicyOutput',
|
|
'*unstable-input': 'CompatPolicyInput',
|
|
'*unstable-output': 'CompatPolicyOutput' } }
|