qemu-devel.nongnu.org archive mirror
 help / color / mirror / Atom feed
From: Eric Blake <eblake@redhat.com>
To: Laurent Vivier <lvivier@redhat.com>,
	Paolo Bonzini <pbonzini@redhat.com>,
	qemu-devel@nongnu.org, marcandre.lureau@gmail.com
Cc: armbru@redhat.com
Subject: Re: [Qemu-devel] [PATCH v3 2/2] -help lists only -help-* commands
Date: Wed, 2 Sep 2015 11:06:36 -0600	[thread overview]
Message-ID: <55E72C9C.1080208@redhat.com> (raw)
In-Reply-To: <1440714174-13261-2-git-send-email-lvivier@redhat.com>

[-- Attachment #1: Type: text/plain, Size: 1202 bytes --]

On 08/27/2015 04:22 PM, Laurent Vivier wrote:
> A slight change of behavior:
> 
>     -help-all displays all helps (like -help/-h before)
>     -help/-h lists only the available help commands

I like the change. However, I think that it is missing the overall
summary; bare help should still include the lead-in lines that mention
usage; I'm less concerned if the version line is present (we have
--version for that), but it may be easier to include it too.  That is,
this part from pre-patch should probably still show:

$ ./x86_64-softmmu/qemu-system-x86_64 --help
QEMU emulator version 2.4.50, Copyright (c) 2003-2008 Fabrice Bellard
usage: qemu-system-x86_64 [options] [disk_image]

'disk_image' is a raw hard disk image for IDE hard disk 0

Help/version options:
...


> 
> Signed-off-by: Laurent Vivier <lvivier@redhat.com>
> ---
> v3: add this patch to add an help section, -help displays only this section
>  qemu-options.hx | 29 +++++++++++++++++++++++++----
>  vl.c            | 12 +++++++++++-
>  2 files changed, 36 insertions(+), 5 deletions(-)
> 

-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 604 bytes --]

  reply	other threads:[~2015-09-02 17:06 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-08-27 15:20 [Qemu-devel] [PATCH, RFC] Use help sub-sections to create sub-help options Laurent Vivier
2015-08-27 15:44 ` Marc-André Lureau
2015-08-27 15:50   ` Laurent Vivier
2015-08-27 17:07   ` [Qemu-devel] [PATCH, RFC v2] " Laurent Vivier
2015-08-27 21:37     ` Marc-André Lureau
2015-08-27 22:22       ` [Qemu-devel] [PATCH v3 1/2] " Laurent Vivier
2015-08-27 22:22         ` [Qemu-devel] [PATCH v3 2/2] -help lists only -help-* commands Laurent Vivier
2015-09-02 17:06           ` Eric Blake [this message]
2015-08-27 22:43         ` [Qemu-devel] [PATCH v3 1/2] Use help sub-sections to create sub-help options Eric Blake
2015-09-02 16:45         ` Laurent Vivier
2015-09-02 17:02         ` Eric Blake

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=55E72C9C.1080208@redhat.com \
    --to=eblake@redhat.com \
    --cc=armbru@redhat.com \
    --cc=lvivier@redhat.com \
    --cc=marcandre.lureau@gmail.com \
    --cc=pbonzini@redhat.com \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).