diff options
authorMarkus Armbruster <armbru@redhat.com>2015-06-15 14:35:58 +0200
committerMichael Tokarev <mjt@tls.msk.ru>2015-06-23 20:23:39 +0300
commitae08fd5a365e650d70acfe1d9027501707041b52 (patch)
parent6b932c0a5f951f1cfd3c459d8946074b9df8b829 (diff)
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 <armbru@redhat.com> Reviewed-by: Eric Blake <eblake@redhat.com> Signed-off-by: Michael Tokarev <mjt@tls.msk.ru>
1 files changed, 3 insertions, 2 deletions
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.
DEF("boot", HAS_ARG, QEMU_OPTION_boot,