[RFC] Concise vs comprehensive help - do we need both?

[Alexander Belchenko]

Tro пишет:
> 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: ...
>>  Options:
>>    ...
>>
>>  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.

Windows has "more" pager and smart programs, per example python interpreter itself,
know how to use this to show the help. I think it's possible to use the same approach
for bzr.