[MERGE] concise help for commands by default

[Martin Pool]

2009/2/17 Ben Finney <bignose+hates-spam at benfinney.id.au>:
> Martin Pool <mbp at sourcefrog.net> writes:
>
>> How about
>>
>>   bzr help foo == bzr foo --help == long help
>
> +1 to this.
>
>>   bzr --usage foo (or bzr --short-help foo) == bzr -h foo == brief help?
>
> +1 to the long options; either of those two names is fine.
>
> You discuss '--help' in one example and '-h' in the other; so, I'm not
> sure whether you intend for that to be different in meaning. To be
> clear:
>
> -1 for 'bzr -h foo' giving different behaviour from 'bzr foo -h'.

Agreed, the behaviour of options should not vary with their position.

> -1 for '--help' giving different behaviour from'-h'.

That was what I meant; -h would no longer be an abbreviation of --help
but rather of --short-help.  Cos it's short.

-- 
Martin <http://launchpad.net/~mbp/>