[PATCH] "bzr help commands" spacing

Matthew D. Fuller fullermd at over-yonder.net
Thu Feb 9 18:52:07 GMT 2006


The 4-character indents on "help commands" may just be the worst
possible size.

    bzr add [FILE...]
        Add specified files or directories.
    bzr annotate FILENAME
        Show the origin of each line in a file.
    bzr branch FROM_LOCATION [TO_LOCATION]
        Create a new copy of a branch.
    [...]

It makes the list very hard to scan by eye for particular commands,
since the command lines up perfectly with the description line.
Shifting to 8-characters makes it much nicer, since you can easily
parse out the commands without having to actually _read_ the lines.

    bzr add [FILE...]
            Add specified files or directories.
    bzr annotate FILENAME
            Show the origin of each line in a file.
    bzr branch FROM_LOCATION [TO_LOCATION]
            Create a new copy of a branch.
    [...]


Trivial patch attached.


-- 
Matthew Fuller     (MF4839)   |  fullermd at over-yonder.net
Systems/Network Administrator |  http://www.over-yonder.net/~fullermd/
           On the Internet, nobody can hear you scream.
-------------- next part --------------
=== modified file 'bzrlib/help.py'
--- bzrlib/help.py	
+++ bzrlib/help.py	
@@ -162,5 +162,5 @@
         cmd_help = cmd_object.help()
         if cmd_help:
             firstline = cmd_help.split('\n', 1)[0]
-            print >>outfile, '    ' + firstline
+            print >>outfile, '        ' + firstline
         



More information about the bazaar mailing list