ShuriZma
/
xemu
mirror of https://github.com/xemu-project/xemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

qapi: Stop using whitespace for alignment in comments 

Perfectly aligned things look pretty, but keeping them that
way as the schema evolves requires churn, and in some cases
newly-added lines are not aligned properly.

Overall, trying to align things is just not worth the trouble.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Message-Id: <20220503073737.84223-8-abologna@redhat.com>
Message-Id: <20220503073737.84223-9-abologna@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Markus Armbruster <armbru@redhat.com>
[Two patches squashed together]
Signed-off-by: Markus Armbruster <armbru@redhat.com>
This commit is contained in:
Andrea Bolognani 2022-05-03 09:37:36 +02:00 committed by Markus Armbruster
parent 23e4645258
commit c0ac533b6f
8 changed files with 72 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
qapi/block-core.json
View File

@ -337,9 +337,9 @@
# #
# Cache mode information for a block device # Cache mode information for a block device
# #
# @writeback: true if writeback mode is enabled # @writeback: true if writeback mode is enabled
# @direct: true if the host page cache is bypassed (O_DIRECT) # @direct: true if the host page cache is bypassed (O_DIRECT)
# @no-flush: true if flush requests are ignored for the device # @no-flush: true if flush requests are ignored for the device
# #
# Since: 2.3 # Since: 2.3
## ##
@ -3333,15 +3333,14 @@
## ##
# @BlockdevOptionsSsh: # @BlockdevOptionsSsh:
# #
# @server: host address # @server: host address
# #
# @path: path to the image on the host # @path: path to the image on the host
# #
# @user: user as which to connect, defaults to current # @user: user as which to connect, defaults to current local user name
# local user name
# #
# @host-key-check: Defines how and what to check the host key against # @host-key-check: Defines how and what to check the host key against
# (default: known_hosts) # (default: known_hosts)
# #
# Since: 2.9 # Since: 2.9
## ##
@ -4662,18 +4661,18 @@
# #
# Subformat options for VMDK images # Subformat options for VMDK images
# #
# @monolithicSparse: Single file image with sparse cluster allocation # @monolithicSparse: Single file image with sparse cluster allocation
# #
# @monolithicFlat: Single flat data image and a descriptor file # @monolithicFlat: Single flat data image and a descriptor file
# #
# @twoGbMaxExtentSparse: Data is split into 2GB (per virtual LBA) sparse extent # @twoGbMaxExtentSparse: Data is split into 2GB (per virtual LBA) sparse extent
# files, in addition to a descriptor file # files, in addition to a descriptor file
# #
# @twoGbMaxExtentFlat: Data is split into 2GB (per virtual LBA) flat extent # @twoGbMaxExtentFlat: Data is split into 2GB (per virtual LBA) flat extent
# files, in addition to a descriptor file # files, in addition to a descriptor file
# #
# @streamOptimized: Single file image sparse cluster allocation, optimized # @streamOptimized: Single file image sparse cluster allocation, optimized
# for streaming over network. # for streaming over network.
# #
# Since: 4.0 # Since: 4.0
## ##
@ -4764,7 +4763,7 @@
# @BlockdevVhdxSubformat: # @BlockdevVhdxSubformat:
# #
# @dynamic: Growing image file # @dynamic: Growing image file
# @fixed: Preallocated fixed-size image file # @fixed: Preallocated fixed-size image file
# #
# Since: 2.12 # Since: 2.12
## ##
@ -4802,7 +4801,7 @@
# @BlockdevVpcSubformat: # @BlockdevVpcSubformat:
# #
# @dynamic: Growing image file # @dynamic: Growing image file
# @fixed: Preallocated fixed-size image file # @fixed: Preallocated fixed-size image file
# #
# Since: 2.12 # Since: 2.12
## ##
@ -4865,9 +4864,9 @@
# Starts a job to create an image format on a given node. The job is # Starts a job to create an image format on a given node. The job is
# automatically finalized, but a manual job-dismiss is required. # automatically finalized, but a manual job-dismiss is required.
# #
# @job-id: Identifier for the newly created job. # @job-id: Identifier for the newly created job.
# #
# @options: Options for the image creation. # @options: Options for the image creation.
# #
# Since: 3.0 # Since: 3.0
## ##
@ -4923,17 +4922,17 @@
# Starts a job to amend format specific options of an existing open block device # Starts a job to amend format specific options of an existing open block device
# The job is automatically finalized, but a manual job-dismiss is required. # The job is automatically finalized, but a manual job-dismiss is required.
# #
# @job-id: Identifier for the newly created job. # @job-id: Identifier for the newly created job.
# #
# @node-name: Name of the block node to work on # @node-name: Name of the block node to work on
# #
# @options: Options (driver specific) # @options: Options (driver specific)
# #
# @force: Allow unsafe operations, format specific # @force: Allow unsafe operations, format specific
# For luks that allows erase of the last active keyslot # For luks that allows erase of the last active keyslot
# (permanent loss of data), # (permanent loss of data),
# and replacement of an active keyslot # and replacement of an active keyslot
# (possible loss of data if IO error happens) # (possible loss of data if IO error happens)
# #
# Features: # Features:
# @unstable: This command is experimental. # @unstable: This command is experimental.

6
qapi/block.json
View File

@ -50,9 +50,9 @@
# #
# Type of Floppy drive to be emulated by the Floppy Disk Controller. # Type of Floppy drive to be emulated by the Floppy Disk Controller.
# #
# @144: 1.44MB 3.5" drive # @144: 1.44MB 3.5" drive
# @288: 2.88MB 3.5" drive # @288: 2.88MB 3.5" drive
# @120: 1.2MB 5.25" drive # @120: 1.2MB 5.25" drive
# @none: No drive connected # @none: No drive connected
# @auto: Automatically determined by inserted media at boot # @auto: Automatically determined by inserted media at boot
# #

6
qapi/char.json
View File

@ -376,10 +376,10 @@
# #
# Configuration info for virtual console chardevs. # Configuration info for virtual console chardevs.
# #
# @width: console width, in pixels # @width: console width, in pixels
# @height: console height, in pixels # @height: console height, in pixels
# @cols: console width, in chars # @cols: console width, in chars
# @rows: console height, in chars # @rows: console height, in chars
# #
# Since: 1.5 # Since: 1.5
## ##

10
qapi/control.json
View File

@ -192,14 +192,14 @@
# #
# Options to be used for adding a new monitor. # Options to be used for adding a new monitor.
# #
# @id: Name of the monitor # @id: Name of the monitor
# #
# @mode: Selects the monitor mode (default: readline in the system # @mode: Selects the monitor mode (default: readline in the system
# emulator, control in qemu-storage-daemon) # emulator, control in qemu-storage-daemon)
# #
# @pretty: Enables pretty printing (QMP only) # @pretty: Enables pretty printing (QMP only)
# #
# @chardev: Name of a character device to expose the monitor on # @chardev: Name of a character device to expose the monitor on
# #
# Since: 5.0 # Since: 5.0
## ##

42
qapi/crypto.json
View File

@ -311,8 +311,8 @@
# #
# Defines state of keyslots that are affected by the update # Defines state of keyslots that are affected by the update
# #
# @active: The slots contain the given password and marked as active # @active: The slots contain the given password and marked as active
# @inactive: The slots are erased (contain garbage) and marked as inactive # @inactive: The slots are erased (contain garbage) and marked as inactive
# #
# Since: 5.1 # Since: 5.1
## ##
@ -327,30 +327,30 @@
# #
# @state: the desired state of the keyslots # @state: the desired state of the keyslots
# #
# @new-secret: The ID of a QCryptoSecret object providing the password to be # @new-secret: The ID of a QCryptoSecret object providing the password to be
# written into added active keyslots # written into added active keyslots
# #
# @old-secret: Optional (for deactivation only) # @old-secret: Optional (for deactivation only)
# If given will deactivate all keyslots that # If given will deactivate all keyslots that
# match password located in QCryptoSecret with this ID # match password located in QCryptoSecret with this ID
# #
# @iter-time: Optional (for activation only) # @iter-time: Optional (for activation only)
# Number of milliseconds to spend in # Number of milliseconds to spend in
# PBKDF passphrase processing for the newly activated keyslot. # PBKDF passphrase processing for the newly activated keyslot.
# Currently defaults to 2000. # Currently defaults to 2000.
# #
# @keyslot: Optional. ID of the keyslot to activate/deactivate. # @keyslot: Optional. ID of the keyslot to activate/deactivate.
# For keyslot activation, keyslot should not be active already # For keyslot activation, keyslot should not be active already
# (this is unsafe to update an active keyslot), # (this is unsafe to update an active keyslot),
# but possible if 'force' parameter is given. # but possible if 'force' parameter is given.
# If keyslot is not given, first free keyslot will be written. # If keyslot is not given, first free keyslot will be written.
# #
# For keyslot deactivation, this parameter specifies the exact # For keyslot deactivation, this parameter specifies the exact
# keyslot to deactivate # keyslot to deactivate
# #
# @secret: Optional. The ID of a QCryptoSecret object providing the # @secret: Optional. The ID of a QCryptoSecret object providing the
# password to use to retrieve current master key. # password to use to retrieve current master key.
# Defaults to the same secret that was used to open the image # Defaults to the same secret that was used to open the image
# #
# Since: 5.1 # Since: 5.1
## ##

8
qapi/migration.json
View File

@ -1191,10 +1191,10 @@
# ask the client to automatically reconnect using the new parameters # ask the client to automatically reconnect using the new parameters
# once migration finished successfully. Only implemented for SPICE. # once migration finished successfully. Only implemented for SPICE.
# #
# @protocol: must be "spice" # @protocol: must be "spice"
# @hostname: migration target hostname # @hostname: migration target hostname
# @port: spice tcp port for plaintext channels # @port: spice tcp port for plaintext channels
# @tls-port: spice tcp port for tls-secured channels # @tls-port: spice tcp port for tls-secured channels
# @cert-subject: server certificate subject # @cert-subject: server certificate subject
# #
# Since: 0.14 # Since: 0.14

4
qapi/sockets.json
View File

@ -167,9 +167,9 @@
# #
# Available SocketAddress types # Available SocketAddress types
# #
# @inet: Internet address # @inet: Internet address
# #
# @unix: Unix domain socket # @unix: Unix domain socket
# #
# @vsock: VMCI address # @vsock: VMCI address
# #

17
qapi/ui.json
View File

@ -1018,8 +1018,8 @@
# #
# Keyboard input event. # Keyboard input event.
# #
# @key: Which key this event is for. # @key: Which key this event is for.
# @down: True for key-down and false for key-up events. # @down: True for key-down and false for key-up events.
# #
# Since: 2.0 # Since: 2.0
## ##
@ -1033,7 +1033,7 @@
# Pointer button input event. # Pointer button input event.
# #
# @button: Which button this event is for. # @button: Which button this event is for.
# @down: True for key-down and false for key-up events. # @down: True for key-down and false for key-up events.
# #
# Since: 2.0 # Since: 2.0
## ##
@ -1353,12 +1353,11 @@
# #
# Display (user interface) options. # Display (user interface) options.
# #
# @type: Which DisplayType qemu should use. # @type: Which DisplayType qemu should use.
# @full-screen: Start user interface in fullscreen mode (default: off). # @full-screen: Start user interface in fullscreen mode (default: off).
# @window-close: Allow to quit qemu with window close button (default: on). # @window-close: Allow to quit qemu with window close button (default: on).
# @show-cursor: Force showing the mouse cursor (default: off). # @show-cursor: Force showing the mouse cursor (default: off). (since: 5.0)
# (since: 5.0) # @gl: Enable OpenGL support (default: off).
# @gl: Enable OpenGL support (default: off).
# #
# Since: 2.12 # Since: 2.12
## ##