[MERGE] concise help for commands by default

[Ben Finney]

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’.
−1 for ‘--help’ giving different behaviour from‘-h’.

In other words: ‘-h’ means the same thing as ‘--help’, and that
shouldn't change. They have the same meaning either before or after
the command on which one is requesting help, and that shouldn't
change.

-- 
 \     “Are you pondering what I'm pondering?” “I think so, Brain, but |
  `\   pants with horizontal stripes make me look chubby.” —_Pinky and |
_o__)                                                       The Brain_ |
Ben Finney