[RFC] Concise vs comprehensive help - do we need both?
troworld at gmail.com
Wed Feb 11 15:07:39 GMT 2009
2009/1/31 Marius Gedminas <marius at pov.lt>:
> On Sat, Jan 31, 2009 at 07:04:51PM +1100, Ben Finney wrote:
>> Ian Clatworthy <ian.clatworthy at internode.on.net> writes:
>> > I'd be just as happy not adding -? and making -h be concise help
>> > while "bzr help xxx" gave the full story. Would that be better?
>> I would expect '-h' and '--help' to be synonymous, and to default to
>> concise help.
>> Multi-page verbosity should not be something associated with a
>> commonly-used option like '--help', but rather something that
>> indicates it's verbose, such as '--help --verbose' or '--help --long'.
> This makes most sense to me, especially if the short help page mentions
> the existence of the long one.
> $ bzr help merge
> Purpose: ...
> Usage: ...
> See bzr help -v merge for more details and examples.
I would prefer this too. If Windows had a pager like "less" built into
cmd.exe I wouldn't mind having "bzr help merge" display the full help.
More information about the bazaar