[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