From nobody Mon Feb 2 09:25:53 2026 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=quarantine dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1767891880; cv=none; d=zohomail.com; s=zohoarc; b=ef9uK+ms91ol6Wnu0rNsbNmLeMUH9chGLwhguiLLzmLU0osIp+Wac/y6ug223MMfJ8T5J6fq+mlOJYLjJTdugLYk18MsnVeJG0AIsZ5P7PSpYz5cr2WGRaSJ/Is55WM3RpuKClpvx3G3yqyyd0v0NccVTexicnAaEy9XAQayLQM= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1767891880; h=Content-Type:Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=XHkgffGczsjKc+JcW4hYQwviOuKk82UuO1Dcs418ofE=; b=TQWAvZnzqaWpf9b1oDMRsi8Ure6PhabIpbscfAGVSvbn8k5pOr/hAWghC6TkXqbM3V5VCqBuFyQY7H11N/W4nURQZ8WIWh3itcUsX+gw9rgLfRJamx38vowXsAaJFUDwURXh77OW55FFJAMt61x5QAy3iCFYtAbHudTeGJK4yjg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1767891880836566.4076871831048; Thu, 8 Jan 2026 09:04:40 -0800 (PST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vdtQb-0003jm-Pf; Thu, 08 Jan 2026 12:04:05 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vdtQW-0003fO-Vu for qemu-devel@nongnu.org; Thu, 08 Jan 2026 12:04:01 -0500 Received: from us-smtp-delivery-124.mimecast.com ([170.10.133.124]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vdtQU-0006pv-BT for qemu-devel@nongnu.org; Thu, 08 Jan 2026 12:04:00 -0500 Received: from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-520-pWyWZK4ePt2g8qJCsCgp_Q-1; Thu, 08 Jan 2026 12:03:52 -0500 Received: from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E207518005BB; Thu, 8 Jan 2026 17:03:49 +0000 (UTC) Received: from toolbx.redhat.com (unknown [10.42.28.44]) by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 30DCC19560BA; Thu, 8 Jan 2026 17:03:44 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1767891837; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=XHkgffGczsjKc+JcW4hYQwviOuKk82UuO1Dcs418ofE=; b=JaH/5zab+5gIpKSDq2B71NTd51OfX3hIsQqSJRtWxl4YQV5hBnzGkK7gTVvIHkqeMnv+ii /jUZO9WF1c0Sf+6bTrV0T8M4gpERW5UhPayTwcp4KYHPR5HNUFMnUSaTbLSALQBF5k8awb dVNCIPsUK8RSAA+dWX4vIy5t5vBGORA= X-MC-Unique: pWyWZK4ePt2g8qJCsCgp_Q-1 X-Mimecast-MFC-AGG-ID: pWyWZK4ePt2g8qJCsCgp_Q_1767891830 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: qemu-devel@nongnu.org Cc: =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= , Manos Pitsidianakis , Hanna Reitz , Gerd Hoffmann , Paolo Bonzini , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= , Christian Schoenebeck , "Dr. David Alan Gilbert" , =?UTF-8?q?Marc-Andr=C3=A9=20Lureau?= , devel@lists.libvirt.org, qemu-block@nongnu.org, qemu-rust@nongnu.org, Markus Armbruster , Stefan Weil , Kevin Wolf , Richard Henderson Subject: [PATCH v5 01/24] qemu-options: remove extraneous [] around arg values Date: Thu, 8 Jan 2026 17:03:15 +0000 Message-ID: <20260108170338.2693853-2-berrange@redhat.com> In-Reply-To: <20260108170338.2693853-1-berrange@redhat.com> References: <20260108170338.2693853-1-berrange@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Scanned-By: MIMEDefang 3.0 on 10.30.177.12 Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=170.10.133.124; envelope-from=berrange@redhat.com; helo=us-smtp-delivery-124.mimecast.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1767891882395158500 There are quite a few inappropriate uses of [...] around argument values. The [] are intended to indicate optionality, but in some cases it is used to wrap a set of enum values. In other cases it is being used to show the value is entirely optional, which was common behaviour for boolean values in the past. QEMU has deprecated short-form boolean options for quite a while though, and we should thus not advertize this possibility in the docs. Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: Markus Armbruster --- qemu-options.hx | 110 ++++++++++++++++++++++++------------------------ 1 file changed, 55 insertions(+), 55 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index ec92723f10..e8057fdcc9 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -25,7 +25,7 @@ SRST ERST =20 DEF("machine", HAS_ARG, QEMU_OPTION_machine, \ - "-machine [type=3D]name[,prop[=3Dvalue][,...]]\n" + "-machine [type=3D]name[,prop=3Dvalue[,...]]\n" " selects emulated machine ('-machine help' for list)\n" " property accel=3Daccel1[:accel2[:...]] selects accele= rator\n" " supported accelerators are kvm, xen, hvf, nvmm, whpx,= mshv or tcg (default: tcg)\n" @@ -227,7 +227,7 @@ SRST ERST =20 DEF("accel", HAS_ARG, QEMU_OPTION_accel, - "-accel [accel=3D]accelerator[,prop[=3Dvalue][,...]]\n" + "-accel [accel=3D]accelerator[,prop=3Dvalue[,...]]\n" " select accelerator (kvm, xen, hvf, nvmm, whpx, mshv o= r tcg; use 'help' for a list)\n" " igd-passthru=3Don|off (enable Xen integrated Intel gr= aphics passthrough, default=3Doff)\n" " kernel-irqchip=3Don|off|split controls accelerated ir= qchip support (default=3Don)\n" @@ -789,17 +789,17 @@ ERST =20 =20 DEF("audio", HAS_ARG, QEMU_OPTION_audio, - "-audio [driver=3D]driver[,prop[=3Dvalue][,...]]\n" + "-audio [driver=3D]driver[,prop=3Dvalue[,...]]\n" " specifies default audio backend when `audiodev` is no= t\n" " used to create a machine or sound device;" " options are the same as for -audiodev\n" - "-audio [driver=3D]driver,model=3Dvalue[,prop[=3Dvalue][,...]]\n" + "-audio [driver=3D]driver,model=3Dvalue[,prop=3Dvalue[,...]]\n" " specifies the audio backend and device to use;\n" " apart from 'model', options are the same as for -audi= odev.\n" " use '-audio model=3Dhelp' to show possible devices.\n= ", QEMU_ARCH_ALL) SRST -``-audio [driver=3D]driver[,model=3Dvalue][,prop[=3Dvalue][,...]]`` +``-audio [driver=3D]driver[,model=3Dvalue][,prop=3Dvalue[,...]]`` If the ``model`` option is specified, ``-audio`` is a shortcut for configuring both the guest audio hardware and the host audio backend in one go. The guest hardware model can be set with @@ -827,7 +827,7 @@ SRST ERST =20 DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev, - "-audiodev [driver=3D]driver,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev [driver=3D]driver,id=3Did[,prop=3Dvalue[,...]]\n" " specifies the audio backend to use\n" " Use ``-audiodev help`` to list the available drivers\= n" " id=3D identifier of the backend\n" @@ -840,25 +840,25 @@ DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev, " valid values: s8, s16, s32, u8, u16, u32, f32\n" " in|out.voices=3D number of voices to use\n" " in|out.buffer-length=3D length of buffer in microseco= nds\n" - "-audiodev none,id=3Did,[,prop[=3Dvalue][,...]]\n" + "-audiodev none,id=3Did,[,prop=3Dvalue[,...]]\n" " dummy driver that discards all output\n" #ifdef CONFIG_AUDIO_ALSA - "-audiodev alsa,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev alsa,id=3Did[,prop=3Dvalue[,...]]\n" " in|out.dev=3D name of the audio device to use\n" " in|out.period-length=3D length of period in microseco= nds\n" " in|out.try-poll=3D attempt to use poll mode\n" " threshold=3D threshold (in microseconds) when playbac= k starts\n" #endif #ifdef CONFIG_AUDIO_COREAUDIO - "-audiodev coreaudio,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev coreaudio,id=3Did[,prop=3Dvalue[,...]]\n" " in|out.buffer-count=3D number of buffers\n" #endif #ifdef CONFIG_AUDIO_DSOUND - "-audiodev dsound,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev dsound,id=3Did[,prop=3Dvalue[,...]]\n" " latency=3D add extra latency to playback in microseco= nds\n" #endif #ifdef CONFIG_AUDIO_OSS - "-audiodev oss,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev oss,id=3Did[,prop=3Dvalue[,...]]\n" " in|out.dev=3D path of the audio device to use\n" " in|out.buffer-count=3D number of buffers\n" " in|out.try-poll=3D attempt to use poll mode\n" @@ -867,35 +867,35 @@ DEF("audiodev", HAS_ARG, QEMU_OPTION_audiodev, " dsp-policy=3D set timing policy (0..10), -1 to use fr= agment mode\n" #endif #ifdef CONFIG_AUDIO_PA - "-audiodev pa,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev pa,id=3Did[,prop=3Dvalue[,...]]\n" " server=3D PulseAudio server address\n" " in|out.name=3D source/sink device name\n" " in|out.latency=3D desired latency in microseconds\n" #endif #ifdef CONFIG_AUDIO_PIPEWIRE - "-audiodev pipewire,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev pipewire,id=3Did[,prop=3Dvalue[,...]]\n" " in|out.name=3D source/sink device name\n" " in|out.stream-name=3D name of pipewire stream\n" " in|out.latency=3D desired latency in microseconds\n" #endif #ifdef CONFIG_AUDIO_SDL - "-audiodev sdl,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev sdl,id=3Did[,prop=3Dvalue[,...]]\n" " in|out.buffer-count=3D number of buffers\n" #endif #ifdef CONFIG_AUDIO_SNDIO - "-audiodev sndio,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev sndio,id=3Did[,prop=3Dvalue[,...]]\n" #endif #ifdef CONFIG_SPICE - "-audiodev spice,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev spice,id=3Did[,prop=3Dvalue[,...]]\n" #endif #ifdef CONFIG_DBUS_DISPLAY - "-audiodev dbus,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev dbus,id=3Did[,prop=3Dvalue[,...]]\n" #endif - "-audiodev wav,id=3Did[,prop[=3Dvalue][,...]]\n" + "-audiodev wav,id=3Did[,prop=3Dvalue[,...]]\n" " path=3D path of wav file to record\n", QEMU_ARCH_ALL) SRST -``-audiodev [driver=3D]driver,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev [driver=3D]driver,id=3Did[,prop=3Dvalue[,...]]`` Adds a new audio backend driver identified by id. There are global and driver specific properties. Some values can be set differently for input and output, they're marked with ``in|out.``. You can set @@ -954,11 +954,11 @@ SRST ``in|out.buffer-length=3Dusecs`` Sets the size of the buffer in microseconds. =20 -``-audiodev none,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev none,id=3Did[,prop=3Dvalue[,...]]`` Creates a dummy backend that discards all outputs. This backend has no backend specific properties. =20 -``-audiodev alsa,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev alsa,id=3Did[,prop=3Dvalue[,...]]`` Creates backend using the ALSA. This backend is only available on Linux. =20 @@ -977,7 +977,7 @@ SRST ``threshold=3Dthreshold`` Threshold (in microseconds) when playback starts. Default is 0. =20 -``-audiodev coreaudio,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev coreaudio,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using Apple's Core Audio. This backend is only available on Mac OS and only supports playback. =20 @@ -986,7 +986,7 @@ SRST ``in|out.buffer-count=3Dcount`` Sets the count of the buffers. =20 -``-audiodev dsound,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev dsound,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using Microsoft's DirectSound. This backend is only available on Windows and only supports playback. =20 @@ -996,7 +996,7 @@ SRST Add extra usecs microseconds latency to playback. Default is 10000 (10 ms). =20 -``-audiodev oss,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev oss,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using OSS. This backend is available on most Unix-like systems. =20 @@ -1025,7 +1025,7 @@ SRST buffer sizes specified by ``buffer`` and ``buffer-count``. This option is ignored if you do not have OSS 4. Default is 5. =20 -``-audiodev pa,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev pa,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using PulseAudio. This backend is available on most systems. =20 @@ -1041,7 +1041,7 @@ SRST Desired latency in microseconds. The PulseAudio server will try to honor this value but actual latencies may be lower or higher. =20 -``-audiodev pipewire,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev pipewire,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using PipeWire. This backend is available on most systems. =20 @@ -1056,7 +1056,7 @@ SRST ``in|out.stream-name`` Specify the name of pipewire stream. =20 -``-audiodev sdl,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev sdl,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using SDL. This backend is available on most systems, but you should use your platform's native backend if possible. @@ -1066,7 +1066,7 @@ SRST ``in|out.buffer-count=3Dcount`` Sets the count of the buffers. =20 -``-audiodev sndio,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev sndio,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend using SNDIO. This backend is available on OpenBSD and most other Unix-like systems. =20 @@ -1079,13 +1079,13 @@ SRST ``in|out.latency=3Dusecs`` Sets the desired period length in microseconds. =20 -``-audiodev spice,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev spice,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend that sends audio through SPICE. This backend requires ``-spice`` and automatically selected in that case, so usually you can ignore this option. This backend has no backend specific properties. =20 -``-audiodev wav,id=3Did[,prop[=3Dvalue][,...]]`` +``-audiodev wav,id=3Did[,prop=3Dvalue[,...]]`` Creates a backend that writes audio to a WAV file. =20 Backend specific options are: @@ -1096,21 +1096,21 @@ SRST ERST =20 DEF("device", HAS_ARG, QEMU_OPTION_device, - "-device driver[,prop[=3Dvalue][,...]]\n" + "-device driver[,prop=3Dvalue[,...]]\n" " add device (based on driver)\n" " prop=3Dvalue,... sets driver properties\n" " use '-device help' to print all possible drivers\n" " use '-device driver,help' to print all possible prope= rties\n", QEMU_ARCH_ALL) SRST -``-device driver[,prop[=3Dvalue][,...]]`` +``-device driver[,prop=3Dvalue[,...]]`` Add device driver. prop=3Dvalue sets driver properties. Valid properties depend on the driver. To get help on possible drivers and properties, use ``-device help`` and ``-device driver,help``. =20 Some drivers are: =20 -``-device ipmi-bmc-sim,id=3Did[,prop[=3Dvalue][,...]]`` +``-device ipmi-bmc-sim,id=3Did[,prop=3Dvalue[,...]]`` Add an IPMI BMC. This is a simulation of a hardware management interface processor that normally sits on a system. It provides a watchdog and the ability to reset and power control the system. You @@ -2308,19 +2308,19 @@ DEF("spice", HAS_ARG, QEMU_OPTION_spice, " [,x509-dh-key-file=3D][,addr=3Daddr]\n" " [,ipv4=3Don|off][,ipv6=3Don|off][,unix=3Don|off]\n" " [,tls-ciphers=3D]\n" - " [,tls-channel=3D[main|display|cursor|inputs|record|playback]]\= n" - " [,plaintext-channel=3D[main|display|cursor|inputs|record|playb= ack]]\n" + " [,tls-channel=3Dmain|display|cursor|inputs|record|playback]\n" + " [,plaintext-channel=3Dmain|display|cursor|inputs|record|playba= ck]\n" " [,sasl=3Don|off][,disable-ticketing=3Don|off]\n" " [,password-secret=3D]\n" - " [,image-compression=3D[auto_glz|auto_lz|quic|glz|lz|off]]\n" - " [,jpeg-wan-compression=3D[auto|never|always]]\n" - " [,zlib-glz-wan-compression=3D[auto|never|always]]\n" - " [,streaming-video=3D[off|all|filter]][,disable-copy-paste=3Don= |off]\n" - " [,disable-agent-file-xfer=3Don|off][,agent-mouse=3D[on|off]]\n" - " [,playback-compression=3D[on|off]][,seamless-migration=3D[on|o= ff]]\n" + " [,image-compression=3Dauto_glz|auto_lz|quic|glz|lz|off]\n" + " [,jpeg-wan-compression=3Dauto|never|always]\n" + " [,zlib-glz-wan-compression=3Dauto|never|always]\n" + " [,streaming-video=3Doff|all|filter][,disable-copy-paste=3Don|o= ff]\n" + " [,disable-agent-file-xfer=3Don|off][,agent-mouse=3Don|off]\n" + " [,playback-compression=3Don|off][,seamless-migration=3Don|off]= \n" " [,video-codec=3D\n" " [,max-refresh-rate=3Drate\n" - " [,gl=3D[on|off]][,rendernode=3D]\n" + " [,gl=3Don|off][,rendernode=3D]\n" " enable spice\n" " at least one of {port, tls-port} is mandatory\n", QEMU_ARCH_ALL) @@ -2380,7 +2380,7 @@ SRST ``tls-ciphers=3D`` Specify which ciphers to use. =20 - ``tls-channel=3D[main|display|cursor|inputs|record|playback]``; \ ``pl= aintext-channel=3D[main|display|cursor|inputs|record|playback]`` + ``tls-channel=3Dmain|display|cursor|inputs|record|playback``; \ ``plai= ntext-channel=3Dmain|display|cursor|inputs|record|playback`` Force specific channel to be used with or without TLS encryption. The options can be specified multiple times to configure multiple channels. The special name "default" can be @@ -2388,24 +2388,24 @@ SRST explicitly forced into one mode the spice client is allowed to pick tls/plaintext as he pleases. =20 - ``image-compression=3D[auto_glz|auto_lz|quic|glz|lz|off]`` + ``image-compression=3Dauto_glz|auto_lz|quic|glz|lz|off`` Configure image compression (lossless). Default is auto\_glz. =20 - ``jpeg-wan-compression=3D[auto|never|always]``; \ ``zlib-glz-wan-compr= ession=3D[auto|never|always]`` + ``jpeg-wan-compression=3Dauto|never|always``; \ ``zlib-glz-wan-compres= sion=3Dauto|never|always`` Configure wan image compression (lossy for slow links). Default is auto. =20 - ``streaming-video=3D[off|all|filter]`` + ``streaming-video=3Doff|all|filter`` Configure video stream detection. Default is off. =20 - ``agent-mouse=3D[on|off]`` + ``agent-mouse=3Don|off`` Enable/disable passing mouse events via vdagent. Default is on. =20 - ``playback-compression=3D[on|off]`` + ``playback-compression=3Don|off`` Enable/disable audio stream compression (using celt 0.5.1). Default is on. =20 - ``seamless-migration=3D[on|off]`` + ``seamless-migration=3Don|off`` Enable/disable spice seamless migration. Default is off. =20 ``video-codec=3D`` @@ -2419,7 +2419,7 @@ SRST Provide the maximum refresh rate (or FPS) at which the encoding requests should be sent to the Spice server. Default would be 30. =20 - ``gl=3D[on|off]`` + ``gl=3Don|off`` Enable/disable OpenGL context. Default is off. =20 ``rendernode=3D`` @@ -2649,7 +2649,7 @@ SRST bandwidth when playing videos. Disabling adaptive encodings restores the original static behavior of encodings like Tight. =20 - ``share=3D[allow-exclusive|force-shared|ignore]`` + ``share=3Dallow-exclusive|force-shared|ignore`` Set display sharing policy. 'allow-exclusive' allows clients to ask for exclusive access. As suggested by the rfb spec this is implemented by dropping other connections. Connecting multiple @@ -4823,9 +4823,9 @@ SRST ERST =20 DEF("mon", HAS_ARG, QEMU_OPTION_mon, \ - "-mon [chardev=3D]name[,mode=3Dreadline|control][,pretty[=3Don|off]]\n= ", QEMU_ARCH_ALL) + "-mon [chardev=3D]name[,mode=3Dreadline|control][,pretty=3Don|off]\n",= QEMU_ARCH_ALL) SRST -``-mon [chardev=3D]name[,mode=3Dreadline|control][,pretty[=3Don|off]]`` +``-mon [chardev=3D]name[,mode=3Dreadline|control][,pretty=3Don|off]`` Set up a monitor connected to the chardev ``name``. QEMU supports two monitors: the Human Monitor Protocol (HMP; for human interaction), and the QEMU Monitor Protocol @@ -5514,14 +5514,14 @@ ERST #endif =20 DEF("msg", HAS_ARG, QEMU_OPTION_msg, - "-msg [timestamp[=3Don|off]][,guest-name=3D[on|off]]\n" + "-msg [timestamp=3Don|off][,guest-name=3Don|off]\n" " control error message format\n" " timestamp=3Don enables timestamps (default: off)\n" " guest-name=3Don enables guest name prefix but only if= \n" " -name guest option is set (default: off= )\n", QEMU_ARCH_ALL) SRST -``-msg [timestamp[=3Don|off]][,guest-name[=3Don|off]]`` +``-msg [timestamp=3Don|off][,guest-name=3Don|off]`` Control error message format. =20 ``timestamp=3Don|off`` --=20 2.52.0