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