[MERGE] concise help for commands by default

[Ian Clatworthy]

Martin Pool wrote:
> 2009/2/13 Ian Clatworthy <ian.clatworthy at internode.on.net>:
>> Martin Pool wrote:
>>> Martin Pool has voted abstain.
>>> I do think 'bzr help foo' should display all the help on foo, not just
>>> the summary.  I'd rather instead see some or all of these:
>> I'm fine with 'bzr help foo' showing the full text and 'bzr foo -h' showing
>> the usage. That implies that help and -h aren't identical but I can't
>> see why they have to be. If someone went to the trouble of typing
>> 'bzr help foo' (vs 'bzr foo -h'), then the full help ought to be no
>> surprise IMHO.
> 
> How about
> 
>   bzr help foo == bzr foo --help == long help
>   bzr --usage foo (or bzr --short-help foo) == bzr -h foo == brief help?

Sounds good. I'll resubmit along those lines.

Ian C.