Call for testing of colocated branch support in bzr.dev

Lluís xscript at gmx.net
Mon Jan 23 14:23:20 UTC 2012


Gordon Tyler writes:

> 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.

Right, I also think the *nix approach should be easier to navigate and
understand with the proper "See Also" links.


> 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.

I think that would be confusing, specially if you want to avoid extra verbosity:

  bzr tag create ...
  bzr tag delete ...
  bzr tag ...!!!...

The third one might confuse the user, unless you always force the use of the
first one.

Thus, it may be worth a try to have the concept "bzr concept[-suboperation]":

  bzr tag
  bzr tag-delete

This has the benefit that you can always write the concept (tag) and then see
the available command completions to see what's related.

That's a little bit more typing than "rmtag", but more easily discoverable.


> 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".

This would come for free with the aforementioned scheme.


Lluis

-- 
 "And it's much the same thing with knowledge, for whenever you learn
 something new, the whole world becomes that much richer."
 -- The Princess of Pure Reason, as told by Norton Juster in The Phantom
 Tollbooth



More information about the bazaar mailing list