qapi: Add missing separators between sections

This only affects readability. The generated documentation
doesn't change.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Message-Id: <20220503073737.84223-4-abologna@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
This commit is contained in:
Andrea Bolognani 2022-05-03 09:37:32 +02:00 committed by Markus Armbruster
parent 406dfba614
commit 4ae65a5265
5 changed files with 18 additions and 0 deletions

View File

@ -1744,6 +1744,7 @@
# Since: 2.3 # Since: 2.3
# #
# Example: # Example:
#
# -> { "execute": "blockdev-backup", # -> { "execute": "blockdev-backup",
# "arguments": { "device": "src-id", # "arguments": { "device": "src-id",
# "sync": "full", # "sync": "full",
@ -2008,6 +2009,7 @@
# @on-target-error: the action to take on an error on the target, # @on-target-error: the action to take on an error on the target,
# default 'report' (no limitations, since this applies to # default 'report' (no limitations, since this applies to
# a different block device than @device). # a different block device than @device).
#
# @unmap: Whether to try to unmap target sectors where source has # @unmap: Whether to try to unmap target sectors where source has
# only zero. If true, and target unallocated sectors will read as zero, # only zero. If true, and target unallocated sectors will read as zero,
# target image sectors will be unmapped; otherwise, zeroes will be # target image sectors will be unmapped; otherwise, zeroes will be
@ -2029,6 +2031,7 @@
# When true, this job will automatically disappear from the query # When true, this job will automatically disappear from the query
# list without user intervention. # list without user intervention.
# Defaults to true. (Since 3.1) # Defaults to true. (Since 3.1)
#
# Since: 1.3 # Since: 1.3
## ##
{ 'struct': 'DriveMirror', { 'struct': 'DriveMirror',
@ -2342,6 +2345,7 @@
# When true, this job will automatically disappear from the query # When true, this job will automatically disappear from the query
# list without user intervention. # list without user intervention.
# Defaults to true. (Since 3.1) # Defaults to true. (Since 3.1)
#
# Returns: nothing on success. # Returns: nothing on success.
# #
# Since: 2.6 # Since: 2.6
@ -4139,6 +4143,7 @@
# @throttle-group: the name of the throttle-group object to use. It # @throttle-group: the name of the throttle-group object to use. It
# must already exist. # must already exist.
# @file: reference to or definition of the data source block device # @file: reference to or definition of the data source block device
#
# Since: 2.11 # Since: 2.11
## ##
{ 'struct': 'BlockdevOptionsThrottle', { 'struct': 'BlockdevOptionsThrottle',

View File

@ -105,6 +105,7 @@
# #
# Returns: - Nothing on success # Returns: - Nothing on success
# - If @device is not a valid block device, DeviceNotFound # - If @device is not a valid block device, DeviceNotFound
#
# Notes: Ejecting a device with no media results in success # Notes: Ejecting a device with no media results in success
# #
# Since: 0.14 # Since: 0.14

View File

@ -32,6 +32,7 @@
# #
# @raw: raw bytes. When encoded in JSON only valid UTF-8 sequences can be used # @raw: raw bytes. When encoded in JSON only valid UTF-8 sequences can be used
# @base64: arbitrary base64 encoded binary data # @base64: arbitrary base64 encoded binary data
#
# Since: 2.6 # Since: 2.6
## ##
{ 'enum': 'QCryptoSecretFormat', { 'enum': 'QCryptoSecretFormat',
@ -51,6 +52,7 @@
# @sha384: SHA-384. (since 2.7) # @sha384: SHA-384. (since 2.7)
# @sha512: SHA-512. (since 2.7) # @sha512: SHA-512. (since 2.7)
# @ripemd160: RIPEMD-160. (since 2.7) # @ripemd160: RIPEMD-160. (since 2.7)
#
# Since: 2.6 # Since: 2.6
## ##
{ 'enum': 'QCryptoHashAlgorithm', { 'enum': 'QCryptoHashAlgorithm',
@ -75,6 +77,7 @@
# @twofish-128: Twofish with 128 bit / 16 byte keys # @twofish-128: Twofish with 128 bit / 16 byte keys
# @twofish-192: Twofish with 192 bit / 24 byte keys # @twofish-192: Twofish with 192 bit / 24 byte keys
# @twofish-256: Twofish with 256 bit / 32 byte keys # @twofish-256: Twofish with 256 bit / 32 byte keys
#
# Since: 2.6 # Since: 2.6
## ##
{ 'enum': 'QCryptoCipherAlgorithm', { 'enum': 'QCryptoCipherAlgorithm',
@ -95,6 +98,7 @@
# @cbc: Cipher Block Chaining # @cbc: Cipher Block Chaining
# @xts: XEX with tweaked code book and ciphertext stealing # @xts: XEX with tweaked code book and ciphertext stealing
# @ctr: Counter (Since 2.8) # @ctr: Counter (Since 2.8)
#
# Since: 2.6 # Since: 2.6
## ##
{ 'enum': 'QCryptoCipherMode', { 'enum': 'QCryptoCipherMode',
@ -114,6 +118,7 @@
# @plain: 64-bit sector number truncated to 32-bits # @plain: 64-bit sector number truncated to 32-bits
# @plain64: 64-bit sector number # @plain64: 64-bit sector number
# @essiv: 64-bit sector number encrypted with a hash of the encryption key # @essiv: 64-bit sector number encrypted with a hash of the encryption key
#
# Since: 2.6 # Since: 2.6
## ##
{ 'enum': 'QCryptoIVGenAlgorithm', { 'enum': 'QCryptoIVGenAlgorithm',
@ -170,6 +175,7 @@
# @key-secret: the ID of a QCryptoSecret object providing the # @key-secret: the ID of a QCryptoSecret object providing the
# decryption key. Mandatory except when probing image for # decryption key. Mandatory except when probing image for
# metadata only. # metadata only.
#
# Since: 2.6 # Since: 2.6
## ##
{ 'struct': 'QCryptoBlockOptionsLUKS', { 'struct': 'QCryptoBlockOptionsLUKS',
@ -194,6 +200,7 @@
# @iter-time: number of milliseconds to spend in # @iter-time: number of milliseconds to spend in
# PBKDF passphrase processing. Currently defaults # PBKDF passphrase processing. Currently defaults
# to 2000. (since 2.8) # to 2000. (since 2.8)
#
# Since: 2.6 # Since: 2.6
## ##
{ 'struct': 'QCryptoBlockCreateOptionsLUKS', { 'struct': 'QCryptoBlockCreateOptionsLUKS',

View File

@ -299,6 +299,7 @@
# returning does not indicate that a guest has accepted the request or # returning does not indicate that a guest has accepted the request or
# that it has shut down. Many guests will respond to this command by # that it has shut down. Many guests will respond to this command by
# prompting the user in some way. # prompting the user in some way.
#
# Example: # Example:
# #
# -> { "execute": "system_powerdown" } # -> { "execute": "system_powerdown" }

View File

@ -1422,7 +1422,9 @@
# @state: The state the migration is currently expected to be in # @state: The state the migration is currently expected to be in
# #
# Returns: nothing on success # Returns: nothing on success
#
# Since: 2.11 # Since: 2.11
#
# Example: # Example:
# #
# -> { "execute": "migrate-continue" , "arguments": # -> { "execute": "migrate-continue" , "arguments":
@ -1736,6 +1738,7 @@
# Since: 4.2 # Since: 4.2
# #
# Example: # Example:
#
# <- { "event": "UNPLUG_PRIMARY", # <- { "event": "UNPLUG_PRIMARY",
# "data": { "device-id": "hostdev0" }, # "data": { "device-id": "hostdev0" },
# "timestamp": { "seconds": 1265044230, "microseconds": 450486 } } # "timestamp": { "seconds": 1265044230, "microseconds": 450486 } }
@ -1845,6 +1848,7 @@
# Since: 5.2 # Since: 5.2
# #
# Example: # Example:
#
# {"execute": "calc-dirty-rate", "arguments": {"calc-time": 1, # {"execute": "calc-dirty-rate", "arguments": {"calc-time": 1,
# 'sample-pages': 512} } # 'sample-pages': 512} }
# #