Re: [Qemu-devel] [PATCH v5 0/2] Improve -help

[Paolo Bonzini]

On 14/09/2015 20:01, Laurent Vivier wrote:
> This series allows to only display a given list of help sections.
> 
> v5: introduce "-help[=LIST]", move help of help to the end "all" section.
>     Remove typo fix (already included).
> v4: as proposed by Eric, provide a list of sections, restore default -help
> v3: add a 2nd patch to add an help section, -help displays only this section
> v2: simplify the dance of #define/#undef, thanks to Marc-André.
> 
> Laurent Vivier (2):
>   vl: Allow to define optional parameter with -arg[=params]
>   Use help sub-sections to create sub-help options
> 
>  qemu-options.hx | 124 ++++++++++++++++++++++++++++++++++--
>  vl.c            | 191 
> +++++++++++++++++++++++++++++++++++++++++++++++++++-----
>  2 files changed, 294 insertions(+), 21 deletions(-)
> 

The idea is great, but I think standard options really applied only to
"-help" and "-version".  Almost everything else ended up under that
heading just because no one wrote a heading...

-add-fd           expert
-audio-help       can be put into display for now
-balloon          Generic object creation (not really...)
-boot             Machine creation options?
-cpu              Machine creation options?
-device           Machine creation options?
-global           expert
-k                Display options
-machine          Machine creation options?
-m[emory]         Machine creation options?
-mem-path         Machine creation options?
-mem-prealloc     Machine creation options?
-name             expert
-numa             Machine creation options?
-set              expert
-smp              Machine creation options?
-soundhw          can be put into display for now?
-uuid             expert

Paolo