[MERGE] concise help for commands by default

[Marius Kruger]

2009/2/13 Martin Pool <mbp at canonical.com>

> Martin Pool has voted abstain.
> Status is now: Semi-approved
> Comment:
> 2009/2/6 Ian Clatworthy <ian.clatworthy at internode.on.net>:
>
>> As discussed on the mailing list recently, the help for
>> commands should be concise by default with "bzr help -v xxx"
>> being used to see the detailed information.
>>
>> The attached patch implements that. It also makes sure that
>> multiple descriptive sections are kept in the order given,
>> rather than being alphabetically sorted.
>>
>
> 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:
>
>  * merge or reimplement bzr-pager so that help is shown in a pager instead
>
>  * add a short form that gives you just the brief summary, like bzr foo
> --usage
>
>  * split topics into smaller components, as you did with log-formats, and
> we could add log-examples
>

+1 on the above ideas

my 2c
marius
-------------- next part --------------
An HTML attachment was scrubbed...
URL: https://lists.ubuntu.com/archives/bazaar/attachments/20090213/af0c53dd/attachment.htm