From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:52378) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z4TcV-00037I-M7 for qemu-devel@nongnu.org; Mon, 15 Jun 2015 08:36:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z4TcR-0002TE-Ki for qemu-devel@nongnu.org; Mon, 15 Jun 2015 08:36:07 -0400 From: Markus Armbruster Date: Mon, 15 Jun 2015 14:35:58 +0200 Message-Id: <1434371759-29592-2-git-send-email-armbru@redhat.com> In-Reply-To: <1434371759-29592-1-git-send-email-armbru@redhat.com> References: <1434371759-29592-1-git-send-email-armbru@redhat.com> Subject: [Qemu-devel] [PATCH 1/2] qemu-options: Improve -global documentation List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: qemu-trivial@nongnu.org, pbonzini@redhat.com Recent commit 3751d7c "vl: allow full-blown QemuOpts syntax for -global" overloaded its existing argument syntax DRIVER.PROP=VALUE with QemuOpts syntax. Unambigious as long as no DRIVER contains '='. Its documentation claims that "the two syntaxes are equivalent." Improve it to spell out how exactly the old syntax gets desugared into the new one. Signed-off-by: Markus Armbruster --- qemu-options.hx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index 1d281f6..b7afec5 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -189,8 +189,9 @@ In particular, you can use this to set driver properties for devices which are created automatically by the machine model. To create a device which is not created automatically and set properties on it, use -@option{device}. -The two syntaxes are equivalent. The longer one works for drivers whose name -contains a dot. +-global @var{driver}.@var{prop}=@var{value} is shorthand for -global +driver=@var{driver},property=@var{prop},value=@var{value}. The +longhand syntax works even when @var{driver} contains a dot. ETEXI DEF("boot", HAS_ARG, QEMU_OPTION_boot, -- 1.9.3