commands: hg clone update priority

Matt Mackall mpm at selenic.com
Sun Mar 7 10:06:23 CST 2010


On Sun, 2010-03-07 at 10:39 -0500, Greg Ward wrote:
> IOW: branches don't have tips, they have heads.  There is only one tip.

A branch tip is analogous to a repository tip: the highest-numbered
revision in the branch. In the named-branch sphere, it's a concept
that's used enough to have its own jargon, I think, and I at least have
been using it for quite a while. And it's also a good summary of what
revision a branch name refers to in a revision context.

Meanwhile, the global tip concept has become almost meaningless. With
named branches, it's pretty much irrelevant, and without them, tip ==
default. As tip can only confuse people trying to use named branches, we
should probably start phasing it out of our vocabulary.

> I'm also neutral on "-r" vs "-r/--rev".  I've left out the long form
> in my recommended edits just to see how it looks.  Please adjust as
> you see fit.

In newspaper style, the long form of name is given on the first mention,
and a short form in all subsequent mentions. We should do something
similar. In particular, we should probably do -r/--rev first, and then
-r everywhere after.

-- 
http://selenic.com : development and support for Mercurial and Linux




More information about the Mercurial-devel mailing list