From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NXiZt-0002LO-28 for qemu-devel@nongnu.org; Wed, 20 Jan 2010 16:59:05 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NXiZo-0002FT-01 for qemu-devel@nongnu.org; Wed, 20 Jan 2010 16:59:04 -0500 Received: from [199.232.76.173] (port=40517 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NXiZn-0002F6-Ns for qemu-devel@nongnu.org; Wed, 20 Jan 2010 16:58:59 -0500 Received: from moutng.kundenserver.de ([212.227.17.10]:55703) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NXiZn-00030b-0w for qemu-devel@nongnu.org; Wed, 20 Jan 2010 16:58:59 -0500 From: Stefan Weil Date: Wed, 20 Jan 2010 22:58:35 +0100 Message-Id: <1264024715-23417-3-git-send-email-weil@mail.berlios.de> In-Reply-To: <1264024715-23417-2-git-send-email-weil@mail.berlios.de> References: <4B54B749.5080304@mail.berlios.de> <1264024715-23417-1-git-send-email-weil@mail.berlios.de> <1264024715-23417-2-git-send-email-weil@mail.berlios.de> Subject: [Qemu-devel] [PATCH 3/3] Documentation: Improve command line help for -device option List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: QEMU Developers * Fix column for help text. * Give some more help, especially for the new '?' parameters. Signed-off-by: Stefan Weil --- qemu-options.hx | 15 ++++++++++++--- 1 files changed, 12 insertions(+), 3 deletions(-) diff --git a/qemu-options.hx b/qemu-options.hx index ee60d8a..ef82cac 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -403,11 +403,20 @@ Network adapter that supports CDC ethernet and RNDIS protocols. ETEXI DEF("device", HAS_ARG, QEMU_OPTION_device, - "-device driver[,options] add device\n") -STEXI -@item -device @var{driver}[,@var{option}[,...]] + "-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}[=@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, -- 1.6.5