Re: [libvirt] [v2] virsh: Categorize commands into groups for virsh help output
于 2010年11月29日 21:38, Justin Clift 写道:
On 22/11/2010, at 8:38 PM, Osier Yang wrote:
> Change the virsh help out. The new output of "virsh help" and
> "virsh --help" will be like:
>
> Secret (help keyword 'secret'):
> secret-define define or modify a secret from an XML file
> secret-dumpxml secret attributes in XML
> secret-set-value set a secret value
> secret-get-value Output a secret value
> secret-undefine undefine a secret
> secret-list list secrets
This is really good, and works nicely on Fedora 13 at least. :)
Two things to mention:
1) The text "Virsh Itself" in the output. The "itself" should
have
a lower case "i". It just looks weird otherwise, even in context
with the other commands. ;)
ah, right, will change.
Virsh Itself (help keyword 'virsh'):
cd change the current directory
echo echo arguments
exit quit this interactive terminal
help print help
pwd print the current directory
quit quit this interactive terminal
2) The sections themselves need to be ordered logically. The
easy thought is "alphabetically", as everyone is familiar with
that order sequence. Suitable for new users. If there's a better
ordering though, we could use that. The ordering in this v1 of
the patch at the moment doesn't look logically ordered?
Domain Management (help keyword 'domain'):
Domain Monitoring (help keyword 'monitor'):
Storage Pool (help keyword 'pool'):
Storage Volume (help keyword 'volume'):
Networking (help keyword 'network'):
Node Device (help keyword 'nodedev'):
Interface (help keyword 'interface'):
Network Filter (help keyword 'filter'):
Secret (help keyword 'secret'):
Snapshot (help keyword 'snapshot'):
Host and Hypervisor (help keyword 'host'):
Virsh Itself (help keyword 'virsh'):
I ordered them by importance, (high to low), e.g. "Virsh itself"
is at the bottom, does it make sense? :-)
- Osier
Regards and best wishes,
Justin Clift