[MERGE] concise help for commands by default

Martin Pool mbp at canonical.com
Fri Feb 13 03:04:03 GMT 2009


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

--
Martin

For details, see: 
http://bundlebuggy.aaronbentley.com/project/bzr/request/%3C498BF29F.4020409%40internode.on.net%3E
Project: Bazaar



More information about the bazaar mailing list