From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Pitre Subject: Re: Local tag killer Date: Mon, 30 Sep 2013 16:08:13 -0400 (EDT) Message-ID: References: <52327E62.2040301@alum.mit.edu> <523D3FD2.4090002@alum.mit.edu> <20130924075119.GD7257@sigill.intra.peff.net> <5246C975.1050504@alum.mit.edu> <5247ACB9.40208@alum.mit.edu> <52499797.9030100@xiplink.com> <5249CDF7.4050904@xiplink.com> Mime-Version: 1.0 Content-Type: TEXT/PLAIN; CHARSET=US-ASCII Content-Transfer-Encoding: 7BIT Cc: Michael Haggerty , Johan Herland , Jeff King , Junio C Hamano , Git mailing list , =?ISO-8859-15?Q?Carlos_Mart=EDn_Nieto?= , Michael Schubert To: Marc Branchaud X-From: git-owner@vger.kernel.org Mon Sep 30 22:08:26 2013 Return-path: Envelope-to: gcvg-git-2@plane.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VQjlZ-0000qR-VA for gcvg-git-2@plane.gmane.org; Mon, 30 Sep 2013 22:08:26 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755660Ab3I3UIW (ORCPT ); Mon, 30 Sep 2013 16:08:22 -0400 Received: from relais.videotron.ca ([24.201.245.36]:44694 "EHLO relais.videotron.ca" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755461Ab3I3UIV (ORCPT ); Mon, 30 Sep 2013 16:08:21 -0400 Received: from xanadu.home ([70.83.209.44]) by VL-VM-MR005.ip.videotron.ca (Oracle Communications Messaging Exchange Server 7u4-22.01 64bit (built Apr 21 2011)) with ESMTP id <0MTY0092YFXPK050@VL-VM-MR005.ip.videotron.ca> for git@vger.kernel.org; Mon, 30 Sep 2013 16:08:13 -0400 (EDT) In-reply-to: <5249CDF7.4050904@xiplink.com> User-Agent: Alpine 2.03 (LFD 1266 2009-07-14) Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: On Mon, 30 Sep 2013, Marc Branchaud wrote: > On 13-09-30 11:52 AM, Nicolas Pitre wrote: > > Consider that I have in my Linux kernel tree: > > > > - a remote branch corresponding to Linus' master tree > > > > - multiple remote branches corresponding to Linux stable branches > > > > - a remote for linux-next which is a repo constantly being rebased > > > > Now all those repositories share the mainline tags from Linus' repo and > > they add some more of they own which are not shared. So if they all > > have a v3.11 tag that resolve to the same SHA1, then there is > > effectively no ambiguity at all and git should not warn at all. > > Thanks, this example helps very much. > > > *However* if one of those v3.11 tags does not agree with the others > > _then_ I want to be warned about it. > > Hmmm. What behaviour would you like if you also had some non-Linux remote, > say for some driver code or something, that also had a v3.11 tag? I want git to complain and bail out, maybe suggesting that I should use "driver_something/tag/v3.11" to disambiguate the tag. > I presume > you want commands like > git checkout -b my-topic v3.11 > to do the Right Thing, but what's the right thing for you here? git itself can't know it. So the best git could do is to list conflicting tags with the shortest path that makes them unambiguous and suggest that I try again with one of them. > > So having multiple matching tags that do resolve to the same SHA1 across > > different remote repositories _is_ the norm and should work > > transparently. > > My suggestion for your example is that if some remote's tags are so > important/useful then you're better off importing them into your local tag > namespace (e.g. "git fetch Linus refs/tags/*:refs/tags/*"). By making the > remote's tags local, you're expressly telling git that they should be > considered for DWIMery, git-describe, etc. Sure, it is probably a good thing semantically to give priority to local tags when they exist. However... > I feel this approach lets us avoid having to somehow teach git which remote's > "v3.11" tags are important enough to merit an ambiguity warning and which > aren't. Plus you get what I think you want, which is the current behaviour. But I disagree here. Most people simply won't care about local tags since the remote tags are sufficient for what they need. And if they have multiple remotes in their repository then it is most likely to be different forks of the same project sharing mostly the same tags, and where those tags diverge then they're most likely to have different tag names as well. So in the large majority of the cases, this v3.11 tag will come from one or more remotes and they will refer to the same SHA1, so it ought to just work without any special fetch. Also, if I refer to v3.11.1 which is a tag that only exists in one of the remote branches and not in Linus' remote then it ought to just work as well. That is more inline with the current _usage_ behavior even if the flat namespace is otherwise a nightmare to sort out when managing remotes. Furthermore, git already has some code to detect refname ambiguities: $ git init && echo "foo" > foo.txt && git add foo.txt $ git commit -m "foo" && git tag foo && git branch foo && git log foo warning: refname 'foo' is ambiguous. So adding the extra step to lookup all possible tags and make sure they resolve to the same SHA1 should be a logical extension to what's already there. Again, in the cases where there is actually a SHA1 conflict between all possible tags that match a tag short-end then listing them and asking the user to be more explicit is the right thing to do. But that should be a very rare case in practice, and designing for making this case easy is the wrong approach. Instead, the common case of multiple remotes with duplicated tag names referring to the same thing _and/or_ multiple remotes with distinct tags names is what should be made easy to use with no extra steps. Nicolas