<div class="gmail_quote">On Fri, Jan 20, 2012 at 1:08 AM, Stephen J. Turnbull <span dir="ltr"><<a href="mailto:stephen@xemacs.org">stephen@xemacs.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div class="HOEnZb"><div class="h5">One thing I don't like about bazaar is having to read the whole list</div></div>
of "bzr help commands" (wc says 109 lines in bzr 2.4.2) to find an<br>
infrequently used command to manipulate a commonly used object.<br>
<br>
Specifically, in the tag and branch examples, I would expect that in<br>
most workflows "rmtag" and "rmbranch" are infrequently used, they are<br>
very easy to describe (would take up only one line in "bzr help tag"),<br>
trivial to understand, and would be far more discoverable in "bzr help<br>
tag" than in "bzr help what was that command again?"  Again, while<br>
people with a *nix background shouldn't have too much trouble guessing<br>
"RMtag" and "RMbranch", they may not be intuitive to Windows or even<br>
Mac users, especially non-technical types used to graphical file<br>
managers.  (True, they'll normally be using a graphical front end to<br>
bzr, too, but not always, and it's that "not always" case that I'm<br>
suggesting you consider here.)<br></blockquote><div><br></div><div>The "See Also" line in the help for the tag command should list all the related commands. And there could be "deltag" and "delbranch" aliases. Aliases shouldn't be shown in the "bzr help commands" output, so it wouldn't clutter up the list any further.</div>
<div><br></div><div>Something else to consider, although this is somewhat of a departure from the current scheme, is to have multi-word commands: "bzr tag delete", "bzr branch rename", etc. First word is a category of commands, second word is the specific command within that category. "bzr help tag" would list all the commands in the tag category. "bzr help tag delete" would show the help for that specific command. "bzr help commands" could either show just a list of the categories or it could list all the commands but grouped and indented by category.</div>
<div><br></div><div>Another variation on that would be to keep the commands as they are now, but categorize them in the help so that "bzr help tag" would list all the tag related commands and they would be grouped and indented by category in "bzr help commands".</div>
<div><br></div><div>Ciao,</div><div>Gordon</div><div><br></div></div>