QAPI patches patches for 2023-07-26

-----BEGIN PGP SIGNATURE-----
 
 iQJGBAABCAAwFiEENUvIs9frKmtoZ05fOHC0AOuRhlMFAmTBFvUSHGFybWJydUBy
 ZWRoYXQuY29tAAoJEDhwtADrkYZTML4QAKhHciLnEudtZ6SFSqpOgt80IJnw8a+r
 z1AowVYtgPhlZ8TtQJFXpBtAZtKu8xb/QdFxomm4bdNQnWX6CXCoheF5ZJ9V3Rrz
 A3pA1wt5KTnRif6R9/Rs1dYXEr4cWagg1UNT3g2eOV3fvdDHvJMPOsqK/jWeXuC1
 T94yFMv1bZSLyiLgB7QQNYDZhIWQ06RGU6tZdWaZQReA8N8maXiZN5NnUISK32Rq
 L2X0FtgzyJQ+dLHtbXOw6kIwZdOLNauOM78skZoiZUyFVaH2aDUIg3mnfRw36hN6
 feXGtw68PkTQGexKmonPDljIacfMDApmNBelLwsvB9MTrwVV+hKZPy1ZEwPIFDJ9
 yid63pp2CtQ1TZ3dSjZ1cGbRR+g2NI5X4g1DlcFPAxydMkv9/m5NwQx8OYqVIzqg
 VXeS0++O2BM5+ORjlJxMx3RsyH2O1I8DCfwmifzYSo+3Xg/4nCV3f38czbavjCfJ
 4T3ooZx0+PRtjlOlfZTkgxV14TMV+XzQr3bsN4wbPdnjnueSE1tyoVGy8MwQ5aXi
 2oAsjrR8g7iqU6f+6PyRNn5F6D0ge+AYQ7bYS51i3Hyih/y2QUJECpL3XAgOxREb
 /68SEtr4m/GJvmQNdwwwu6e1JFo8LknwMfkfzQAOCK1npAJGsWPmJ6iY7KtWgS8F
 oDwqng/WOhvV
 =mNMX
 -----END PGP SIGNATURE-----

Merge tag 'pull-qapi-2023-07-26-v2' of https://repo.or.cz/qemu/armbru into staging

QAPI patches patches for 2023-07-26

# -----BEGIN PGP SIGNATURE-----
#
# iQJGBAABCAAwFiEENUvIs9frKmtoZ05fOHC0AOuRhlMFAmTBFvUSHGFybWJydUBy
# ZWRoYXQuY29tAAoJEDhwtADrkYZTML4QAKhHciLnEudtZ6SFSqpOgt80IJnw8a+r
# z1AowVYtgPhlZ8TtQJFXpBtAZtKu8xb/QdFxomm4bdNQnWX6CXCoheF5ZJ9V3Rrz
# A3pA1wt5KTnRif6R9/Rs1dYXEr4cWagg1UNT3g2eOV3fvdDHvJMPOsqK/jWeXuC1
# T94yFMv1bZSLyiLgB7QQNYDZhIWQ06RGU6tZdWaZQReA8N8maXiZN5NnUISK32Rq
# L2X0FtgzyJQ+dLHtbXOw6kIwZdOLNauOM78skZoiZUyFVaH2aDUIg3mnfRw36hN6
# feXGtw68PkTQGexKmonPDljIacfMDApmNBelLwsvB9MTrwVV+hKZPy1ZEwPIFDJ9
# yid63pp2CtQ1TZ3dSjZ1cGbRR+g2NI5X4g1DlcFPAxydMkv9/m5NwQx8OYqVIzqg
# VXeS0++O2BM5+ORjlJxMx3RsyH2O1I8DCfwmifzYSo+3Xg/4nCV3f38czbavjCfJ
# 4T3ooZx0+PRtjlOlfZTkgxV14TMV+XzQr3bsN4wbPdnjnueSE1tyoVGy8MwQ5aXi
# 2oAsjrR8g7iqU6f+6PyRNn5F6D0ge+AYQ7bYS51i3Hyih/y2QUJECpL3XAgOxREb
# /68SEtr4m/GJvmQNdwwwu6e1JFo8LknwMfkfzQAOCK1npAJGsWPmJ6iY7KtWgS8F
# oDwqng/WOhvV
# =mNMX
# -----END PGP SIGNATURE-----
# gpg: Signature made Wed 26 Jul 2023 05:52:05 AM PDT
# gpg:                using RSA key 354BC8B3D7EB2A6B68674E5F3870B400EB918653
# gpg:                issuer "armbru@redhat.com"
# gpg: Good signature from "Markus Armbruster <armbru@redhat.com>" [undefined]
# gpg:                 aka "Markus Armbruster <armbru@pond.sub.org>" [undefined]
# gpg: WARNING: This key is not certified with a trusted signature!
# gpg:          There is no indication that the signature belongs to the owner.
# Primary key fingerprint: 354B C8B3 D7EB 2A6B 6867  4E5F 3870 B400 EB91 8653

* tag 'pull-qapi-2023-07-26-v2' of https://repo.or.cz/qemu/armbru:
  qapi: Reformat recent doc comments to conform to current conventions
  qapi/trace: Tidy up trace-event-get-state, -set-state documentation
  qapi/qdev: Tidy up device_add documentation
  qapi/block: Tidy up block-latency-histogram-set documentation
  qapi/block-core: Tidy up BlockLatencyHistogramInfo documentation

Signed-off-by: Richard Henderson <richard.henderson@linaro.org>
This commit is contained in:
Richard Henderson 2023-07-26 07:16:19 -07:00
commit ccdd312676
10 changed files with 66 additions and 74 deletions

View File

@ -136,7 +136,7 @@
# #
# @filename: Name of the extent file # @filename: Name of the extent file
# #
# @format: Extent type (e.g. FLAT or SPARSE) # @format: Extent type (e.g. FLAT or SPARSE)
# #
# @virtual-size: Number of bytes covered by this extent # @virtual-size: Number of bytes covered by this extent
# #
@ -652,10 +652,9 @@
# 10), [10, 50), [50, 100), [100, +inf). # 10), [10, 50), [50, 100), [100, +inf).
# #
# @bins: list of io request counts corresponding to histogram # @bins: list of io request counts corresponding to histogram
# intervals. # intervals, one more element than @boundaries has. For the
# len(@bins) = len(@boundaries) + 1 # example above, @bins may be something like [3, 1, 5, 2], and
# For the example above, @bins may be something like [3, 1, 5, 2], # corresponding histogram looks like:
# and corresponding histogram looks like:
# #
# :: # ::
# #
@ -854,9 +853,8 @@
# @min_wr_latency_ns: Minimum latency of write operations in the # @min_wr_latency_ns: Minimum latency of write operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
# #
# @min_zone_append_latency_ns: Minimum latency of zone append operations # @min_zone_append_latency_ns: Minimum latency of zone append
# in the defined interval, in nanoseconds # operations in the defined interval, in nanoseconds (since 8.1)
# (since 8.1)
# #
# @min_flush_latency_ns: Minimum latency of flush operations in the # @min_flush_latency_ns: Minimum latency of flush operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
@ -867,9 +865,8 @@
# @max_wr_latency_ns: Maximum latency of write operations in the # @max_wr_latency_ns: Maximum latency of write operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
# #
# @max_zone_append_latency_ns: Maximum latency of zone append operations # @max_zone_append_latency_ns: Maximum latency of zone append
# in the defined interval, in nanoseconds # operations in the defined interval, in nanoseconds (since 8.1)
# (since 8.1)
# #
# @max_flush_latency_ns: Maximum latency of flush operations in the # @max_flush_latency_ns: Maximum latency of flush operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
@ -880,9 +877,8 @@
# @avg_wr_latency_ns: Average latency of write operations in the # @avg_wr_latency_ns: Average latency of write operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
# #
# @avg_zone_append_latency_ns: Average latency of zone append operations # @avg_zone_append_latency_ns: Average latency of zone append
# in the defined interval, in nanoseconds # operations in the defined interval, in nanoseconds (since 8.1)
# (since 8.1)
# #
# @avg_flush_latency_ns: Average latency of flush operations in the # @avg_flush_latency_ns: Average latency of flush operations in the
# defined interval, in nanoseconds. # defined interval, in nanoseconds.
@ -894,8 +890,7 @@
# the defined interval. # the defined interval.
# #
# @avg_zone_append_queue_depth: Average number of pending zone append # @avg_zone_append_queue_depth: Average number of pending zone append
# operations in the defined interval # operations in the defined interval (since 8.1).
# (since 8.1).
# #
# Since: 2.5 # Since: 2.5
## ##
@ -920,8 +915,8 @@
# #
# @wr_bytes: The number of bytes written by the device. # @wr_bytes: The number of bytes written by the device.
# #
# @zone_append_bytes: The number of bytes appended by the zoned devices # @zone_append_bytes: The number of bytes appended by the zoned
# (since 8.1) # devices (since 8.1)
# #
# @unmap_bytes: The number of bytes unmapped by the device (Since 4.2) # @unmap_bytes: The number of bytes unmapped by the device (Since 4.2)
# #
@ -931,8 +926,8 @@
# @wr_operations: The number of write operations performed by the # @wr_operations: The number of write operations performed by the
# device. # device.
# #
# @zone_append_operations: The number of zone append operations performed # @zone_append_operations: The number of zone append operations
# by the zoned devices (since 8.1) # performed by the zoned devices (since 8.1)
# #
# @flush_operations: The number of cache flush operations performed by # @flush_operations: The number of cache flush operations performed by
# the device (since 0.15) # the device (since 0.15)
@ -947,7 +942,7 @@
# 0.15). # 0.15).
# #
# @zone_append_total_time_ns: Total time spent on zone append writes # @zone_append_total_time_ns: Total time spent on zone append writes
# in nanoseconds (since 8.1) # in nanoseconds (since 8.1)
# #
# @flush_total_time_ns: Total time spent on cache flushes in # @flush_total_time_ns: Total time spent on cache flushes in
# nanoseconds (since 0.15). # nanoseconds (since 0.15).
@ -966,8 +961,8 @@
# @wr_merged: Number of write requests that have been merged into # @wr_merged: Number of write requests that have been merged into
# another request (Since 2.3). # another request (Since 2.3).
# #
# @zone_append_merged: Number of zone append requests that have been merged # @zone_append_merged: Number of zone append requests that have been
# into another request (since 8.1) # merged into another request (since 8.1)
# #
# @unmap_merged: Number of unmap requests that have been merged into # @unmap_merged: Number of unmap requests that have been merged into
# another request (Since 4.2) # another request (Since 4.2)
@ -982,9 +977,8 @@
# @failed_wr_operations: The number of failed write operations # @failed_wr_operations: The number of failed write operations
# performed by the device (Since 2.5) # performed by the device (Since 2.5)
# #
# @failed_zone_append_operations: The number of failed zone append write # @failed_zone_append_operations: The number of failed zone append
# operations performed by the zoned devices # write operations performed by the zoned devices (since 8.1)
# (since 8.1)
# #
# @failed_flush_operations: The number of failed flush operations # @failed_flush_operations: The number of failed flush operations
# performed by the device (Since 2.5) # performed by the device (Since 2.5)
@ -998,8 +992,8 @@
# @invalid_wr_operations: The number of invalid write operations # @invalid_wr_operations: The number of invalid write operations
# performed by the device (Since 2.5) # performed by the device (Since 2.5)
# #
# @invalid_zone_append_operations: The number of invalid zone append operations # @invalid_zone_append_operations: The number of invalid zone append
# performed by the zoned device (since 8.1) # operations performed by the zoned device (since 8.1)
# #
# @invalid_flush_operations: The number of invalid flush operations # @invalid_flush_operations: The number of invalid flush operations
# performed by the device (Since 2.5) # performed by the device (Since 2.5)
@ -1020,7 +1014,8 @@
# #
# @wr_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0) # @wr_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0)
# #
# @zone_append_latency_histogram: @BlockLatencyHistogramInfo. (since 8.1) # @zone_append_latency_histogram: @BlockLatencyHistogramInfo.
# (since 8.1)
# #
# @flush_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0) # @flush_latency_histogram: @BlockLatencyHistogramInfo. (Since 4.0)
# #
@ -1127,7 +1122,7 @@
# #
# @parent: This describes the file block device if it has one. # @parent: This describes the file block device if it has one.
# Contains recursively the statistics of the underlying protocol # Contains recursively the statistics of the underlying protocol
# (e.g. the host file for a qcow2 image). If there is no # (e.g. the host file for a qcow2 image). If there is no
# underlying protocol, this field is omitted # underlying protocol, this field is omitted
# #
# @backing: This describes the backing block device if it has one. # @backing: This describes the backing block device if it has one.
@ -1487,7 +1482,7 @@
# @format: the format of the overlay image, default is 'qcow2'. # @format: the format of the overlay image, default is 'qcow2'.
# #
# @mode: whether and how QEMU should create a new image, default is # @mode: whether and how QEMU should create a new image, default is
# 'absolute-paths'. # 'absolute-paths'.
## ##
{ 'struct': 'BlockdevSnapshotSync', { 'struct': 'BlockdevSnapshotSync',
'data': { '*device': 'str', '*node-name': 'str', 'data': { '*device': 'str', '*node-name': 'str',
@ -1551,7 +1546,7 @@
# #
# @bitmap: The name of a dirty bitmap to use. Must be present if sync # @bitmap: The name of a dirty bitmap to use. Must be present if sync
# is "bitmap" or "incremental". Can be present if sync is "full" # is "bitmap" or "incremental". Can be present if sync is "full"
# or "top". Must not be present otherwise. # or "top". Must not be present otherwise.
# (Since 2.4 (drive-backup), 3.1 (blockdev-backup)) # (Since 2.4 (drive-backup), 3.1 (blockdev-backup))
# #
# @bitmap-mode: Specifies the type of data the bitmap should contain # @bitmap-mode: Specifies the type of data the bitmap should contain
@ -3478,16 +3473,16 @@
# @pass-discard-other: whether discard requests for the data source # @pass-discard-other: whether discard requests for the data source
# should be issued on other occasions where a cluster gets freed # should be issued on other occasions where a cluster gets freed
# #
# @discard-no-unref: when enabled, discards from the guest will not cause # @discard-no-unref: when enabled, discards from the guest will not
# cluster allocations to be relinquished. This prevents qcow2 fragmentation # cause cluster allocations to be relinquished. This prevents
# that would be caused by such discards. Besides potential # qcow2 fragmentation that would be caused by such discards.
# performance degradation, such fragmentation can lead to increased # Besides potential performance degradation, such fragmentation
# allocation of clusters past the end of the image file, # can lead to increased allocation of clusters past the end of the
# resulting in image files whose file length can grow much larger # image file, resulting in image files whose file length can grow
# than their guest disk size would suggest. # much larger than their guest disk size would suggest. If image
# If image file length is of concern (e.g. when storing qcow2 # file length is of concern (e.g. when storing qcow2 images
# images directly on block devices), you should consider enabling # directly on block devices), you should consider enabling this
# this option. (since 8.1) # option. (since 8.1)
# #
# @overlap-check: which overlap checks to perform for writes to the # @overlap-check: which overlap checks to perform for writes to the
# image, defaults to 'cached' (since 2.2) # image, defaults to 'cached' (since 2.2)
@ -5241,9 +5236,9 @@
# #
# @subformat: vhdx subformat (default: dynamic) # @subformat: vhdx subformat (default: dynamic)
# #
# @block-state-zero: Force use of payload blocks of type # @block-state-zero: Force use of payload blocks of type 'ZERO'.
# 'ZERO'. Non-standard, but default. Do not set to 'off' when # Non-standard, but default. Do not set to 'off' when using
# using 'qemu-img convert' with subformat=dynamic. # 'qemu-img convert' with subformat=dynamic.
# #
# Since: 2.12 # Since: 2.12
## ##

View File

@ -534,8 +534,8 @@
# @boundaries-write: list of interval boundary values for write # @boundaries-write: list of interval boundary values for write
# latency histogram. # latency histogram.
# #
# @boundaries-zap: list of interval boundary values for zone append write # @boundaries-zap: list of interval boundary values for zone append
# latency histogram. # write latency histogram.
# #
# @boundaries-flush: list of interval boundary values for flush # @boundaries-flush: list of interval boundary values for flush
# latency histogram. # latency histogram.
@ -547,7 +547,7 @@
# #
# Example: # Example:
# #
# set new histograms for all io types with intervals [0, 10), [10, # Set new histograms for all io types with intervals [0, 10), [10,
# 50), [50, 100), [100, +inf): # 50), [50, 100), [100, +inf):
# #
# -> { "execute": "block-latency-histogram-set", # -> { "execute": "block-latency-histogram-set",
@ -557,7 +557,7 @@
# #
# Example: # Example:
# #
# set new histogram only for write, other histograms will remain not # Set new histogram only for write, other histograms will remain not
# changed (or not created): # changed (or not created):
# #
# -> { "execute": "block-latency-histogram-set", # -> { "execute": "block-latency-histogram-set",
@ -567,7 +567,7 @@
# #
# Example: # Example:
# #
# set new histograms with the following intervals: read, flush: [0, # Set new histograms with the following intervals: read, flush: [0,
# 10), [10, 50), [50, 100), [100, +inf) write: [0, 1000), [1000, # 10), [10, 50), [50, 100), [100, +inf) write: [0, 1000), [1000,
# 5000), [5000, +inf) # 5000), [5000, +inf)
# #
@ -579,7 +579,7 @@
# #
# Example: # Example:
# #
# remove all latency histograms: # Remove all latency histograms:
# #
# -> { "execute": "block-latency-histogram-set", # -> { "execute": "block-latency-histogram-set",
# "arguments": { "id": "drive0" } } # "arguments": { "id": "drive0" } }

View File

@ -172,8 +172,8 @@
# #
# @temperature: Device temperature in degrees Celsius. # @temperature: Device temperature in degrees Celsius.
# #
# @dirty-shutdown-count: Number of times the device has been unable # @dirty-shutdown-count: Number of times the device has been unable to
# to determine whether data loss may have occurred. # determine whether data loss may have occurred.
# #
# @corrected-volatile-error-count: Total number of correctable errors # @corrected-volatile-error-count: Total number of correctable errors
# in volatile memory. # in volatile memory.

View File

@ -61,7 +61,7 @@
# @CpuModelCompareResult: # @CpuModelCompareResult:
# #
# An enumeration of CPU model comparison results. The result is # An enumeration of CPU model comparison results. The result is
# usually calculated using e.g. CPU features or CPU generations. # usually calculated using e.g. CPU features or CPU generations.
# #
# @incompatible: If model A is incompatible to model B, model A is not # @incompatible: If model A is incompatible to model B, model A is not
# guaranteed to run where model B runs and the other way around. # guaranteed to run where model B runs and the other way around.

View File

@ -487,8 +487,8 @@
# block devices (and thus take locks) immediately at the end of # block devices (and thus take locks) immediately at the end of
# migration. (since 3.0) # migration. (since 3.0)
# #
# @x-ignore-shared: If enabled, QEMU will not migrate shared memory that is # @x-ignore-shared: If enabled, QEMU will not migrate shared memory
# accessible on the destination machine. (since 4.0) # that is accessible on the destination machine. (since 4.0)
# #
# @validate-uuid: Send the UUID of the source to allow the destination # @validate-uuid: Send the UUID of the source to allow the destination
# to ensure it is the same. (since 4.2) # to ensure it is the same. (since 4.2)
@ -512,9 +512,9 @@
# @switchover-ack: If enabled, migration will not stop the source VM # @switchover-ack: If enabled, migration will not stop the source VM
# and complete the migration until an ACK is received from the # and complete the migration until an ACK is received from the
# destination that it's OK to do so. Exactly when this ACK is # destination that it's OK to do so. Exactly when this ACK is
# sent depends on the migrated devices that use this feature. # sent depends on the migrated devices that use this feature. For
# For example, a device can use it to make sure some of its data # example, a device can use it to make sure some of its data is
# is sent and loaded in the destination before doing switchover. # sent and loaded in the destination before doing switchover.
# This can reduce downtime if devices that support this capability # This can reduce downtime if devices that support this capability
# are present. 'return-path' capability must be enabled to use # are present. 'return-path' capability must be enabled to use
# it. (since 8.1) # it. (since 8.1)

View File

@ -663,7 +663,6 @@
# @type: Specify the driver used for interpreting remaining arguments. # @type: Specify the driver used for interpreting remaining arguments.
# #
# Since: 1.2 # Since: 1.2
#
## ##
{ 'union': 'Netdev', { 'union': 'Netdev',
'base': { 'id': 'str', 'type': 'NetClientDriver' }, 'base': { 'id': 'str', 'type': 'NetClientDriver' },

View File

@ -53,12 +53,12 @@
# #
# Notes: # Notes:
# #
# Additional arguments depend on the type. # 1. Additional arguments depend on the type.
# #
# 1. For detailed information about this command, please refer to the # 2. For detailed information about this command, please refer to the
# 'docs/qdev-device-use.txt' file. # 'docs/qdev-device-use.txt' file.
# #
# 2. It's possible to list device properties by running QEMU with the # 3. It's possible to list device properties by running QEMU with the
# "-device DEVICE,help" command-line argument, where DEVICE is the # "-device DEVICE,help" command-line argument, where DEVICE is the
# device's name # device's name
# #

View File

@ -647,9 +647,10 @@
# selects a default alignment (currently the page size). # selects a default alignment (currently the page size).
# (default: 0) # (default: 0)
# #
# @offset: the offset into the target file that the region starts at. You # @offset: the offset into the target file that the region starts at.
# can use this option to back multiple regions with a single file. Must # You can use this option to back multiple regions with a single
# be a multiple of the page size. (default: 0) (since 8.1) # file. Must be a multiple of the page size.
# (default: 0) (since 8.1)
# #
# @discard-data: if true, the file contents can be destroyed when QEMU # @discard-data: if true, the file contents can be destroyed when QEMU
# exits, to avoid unnecessarily flushing data to the backing file. # exits, to avoid unnecessarily flushing data to the backing file.
@ -662,7 +663,7 @@
# #
# @pmem: specifies whether the backing file specified by @mem-path is # @pmem: specifies whether the backing file specified by @mem-path is
# in host persistent memory that can be accessed using the SNIA # in host persistent memory that can be accessed using the SNIA
# NVM programming model (e.g. Intel NVDIMM). # NVM programming model (e.g. Intel NVDIMM).
# #
# @readonly: if true, the backing file is opened read-only; if false, # @readonly: if true, the backing file is opened read-only; if false,
# it is opened read-write. (default: false) # it is opened read-write. (default: false)

View File

@ -38,6 +38,7 @@
# @vcpu: Whether this is a per-vCPU event (since 2.7). # @vcpu: Whether this is a per-vCPU event (since 2.7).
# #
# Features: # Features:
#
# @deprecated: Member @vcpu is deprecated, and always ignored. # @deprecated: Member @vcpu is deprecated, and always ignored.
# #
# Since: 2.2 # Since: 2.2
@ -56,13 +57,11 @@
# @vcpu: The vCPU to query (since 2.7). # @vcpu: The vCPU to query (since 2.7).
# #
# Features: # Features:
#
# @deprecated: Member @vcpu is deprecated, and always ignored. # @deprecated: Member @vcpu is deprecated, and always ignored.
# #
# Returns: a list of @TraceEventInfo for the matching events # Returns: a list of @TraceEventInfo for the matching events
# #
# An event is returned if its name matches the @name pattern
# (There are no longer any per-vCPU events).
#
# Since: 2.2 # Since: 2.2
# #
# Example: # Example:
@ -90,10 +89,8 @@
# @vcpu: The vCPU to act upon (all by default; since 2.7). # @vcpu: The vCPU to act upon (all by default; since 2.7).
# #
# Features: # Features:
# @deprecated: Member @vcpu is deprecated, and always ignored.
# #
# An event is enabled if its name matches the @name pattern # @deprecated: Member @vcpu is deprecated, and always ignored.
# (There are no longer any per-vCPU events).
# #
# Since: 2.2 # Since: 2.2
# #

View File

@ -1309,7 +1309,7 @@
# defaults to "off". (Since 3.1) # defaults to "off". (Since 3.1)
# #
# @show-tabs: Display the tab bar for switching between the various # @show-tabs: Display the tab bar for switching between the various
# graphical interfaces (e.g. VGA and virtual console character # graphical interfaces (e.g. VGA and virtual console character
# devices) by default. (Since 7.1) # devices) by default. (Since 7.1)
# #
# @show-menubar: Display the main window menubar. Defaults to "on". # @show-menubar: Display the main window menubar. Defaults to "on".