Documentation: Improve command line help for -device option
* Fix column for help text.
* Give some more help, especially for the new '?' parameters.
Signed-off-by: Stefan Weil <weil@mail.berlios.de>
Signed-off-by: Anthony Liguori <aliguori@us.ibm.com>
diff --git a/qemu-options.hx b/qemu-options.hx
index 9294e07..5aa98c1 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -403,11 +403,20 @@
ETEXI
DEF("device", HAS_ARG, QEMU_OPTION_device,
- "-device driver[,options] add device\n")
+ "-device driver[,option[=value][,...]]\n"
+ " add device (based on driver) with default or\n"
+ " user defined options\n"
+ " use -device ? to print all possible drivers\n"
+ " use -device driver,? to print all possible options\n"
+ " use -device driver,option=? to print a help for value\n")
STEXI
-@item -device @var{driver}[,@var{option}[,...]]
+@item -device @var{driver}[,@var{option}[=@var{value}][,...]]
Add device @var{driver}. Depending on the device type,
-@var{option} (typically @var{key}=@var{value}) may be useful.
+@var{option} (with default or given @var{value}) may be useful.
+To get a help on possible @var{driver}s, @var{option}s or @var{value}s, use
+@code{-device ?},
+@code{-device @var{driver},?} or
+@code{-device @var{driver},@var{option}=?}.
ETEXI
DEF("name", HAS_ARG, QEMU_OPTION_name,
