From: Markus Armbruster Date: Mon, 15 Jun 2015 12:35:58 +0000 (+0200) Subject: qemu-options: Improve -global documentation X-Git-Url: http://git.maquefel.me/?a=commitdiff_plain;h=ae08fd5a365e650d70acfe1d9027501707041b52;p=qemu.git qemu-options: Improve -global documentation 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 Reviewed-by: Eric Blake Signed-off-by: Michael Tokarev --- diff --git a/qemu-options.hx b/qemu-options.hx index d1712f58af..328fbb4218 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,