[RFC] Condense help listings

Aaron Bentley aaron.bentley at utoronto.ca
Sat Sep 23 20:23:12 BST 2006


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi all,

I've attached a bundle that condenses the listing produced by 'bzr help
commands'.

The new format looks like this:
add               Add specified files or directories.
annotate          Show the origin of each line in a file.
baz-import        Import an Arch or Baz archive into a bzr repository.
                  <bzrtools>
baz-import-branch Import an Arch or Baz branch into a bzr branch. <bzrtools>

(Strikingly like Mercurial)

Changes
1. the listing doesn't include usage info, just the command
2. the command isn't prefixed, e.g. 'bzr add'
3. to keep the listing short, plugins are shown with '<plugin>', not
'(from plugin "plugin")'

The width of the command column is set to the width of the longest
command name displayed.

What do people think?

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFFYmf0F+nu1YWqI0RAlf3AJ48D1p6GnwK6cz4hwdn0L0eIbcMnwCfUO19
c0Hoe6TVB8K6xqFO4N1nw1M=
=d0FP
-----END PGP SIGNATURE-----
-------------- next part --------------
A non-text attachment was scrubbed...
Name: condensed-help.patch
Type: text/x-patch
Size: 5540 bytes
Desc: not available
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060923/4fbf5260/attachment.bin 


More information about the bazaar mailing list