[PATCH] tag: do not show ambiguous tag names as "tags/foo"
- From
Jeff King <peff@peff.net>
- Date
- Jan 24, 2016, 07:12 UTC
- Message-ID
- <20160124071234.GA24084@sigill.intra.peff.net>
- In-Reply-To
- <CAAB=nN=RSQuDPdg6Y2heeBXpQVdWSwFAcDDTfxE=XRSOu5gGEg@mail.gmail.com>
On Sat, Jan 23, 2016 at 03:56:12PM -0800, Pete Harlan wrote:
Show 17 quoted lines
> There was a behavior change in "git tag" in b7cc53e9 (tag.c: use > 'ref-filter' APIs, 2015-07-11, v2.5.0-276-gb7cc53e), such that "git > tag" now writes "foo" as "tags/foo" if there is also a branch named > "foo": > > % git tag > tags/branchortag > tagonly > > Previous behavior: > > % git tag > branchortag > tagonly > > I prefer the previous behavior. Perhaps the change was intentional, > but I didn't see it documented.
I don't think it was intentional, and I think the new output is actively wrong. My reasoning (and a fix) are below.
-- >8 -- Subject: tag: do not show ambiguous tag names as "tags/foo"
Since b7cc53e9 (tag.c: use 'ref-filter' APIs, 2015-07-11), git-tag has started showing tags with ambiguous names (i.e., when both "heads/foo" and "tags/foo" exists) as "tags/foo" instead of just "foo". This is both:
- pointless; the output of "git tag" includes only
refs/tags, so we know that "foo" means the one in
"refs/tags".and
- ambiguous; in the original output, we know that the line
"foo" means that "refs/tags/foo" exists. In the new
output, it is unclear whether we mean "refs/tags/foo" or
"refs/tags/tags/foo".The reason this happens is that commit b7cc53e9 switched git-tag to use ref-filter's "%(refname:short)" output formatting, which was adapted from for-each-ref. This more general code does not know that we care only about tags, and uses shorten_unambiguous_ref to get the short-name. We need to tell it that we care only about "refs/tags/", and it should shorten with respect to that value.
In theory, the ref-filter code could figure this out by us passing FILTER_REFS_TAGS. But there are two complications there:
1. The handling of refname:short is deep in formatting
code that does not even have our ref_filter struct, let
alone the arguments to the filter_ref struct. 2. In git v2.7.0, we expose the formatting language to the
user. If we follow this path, it will mean that
"%(refname:short)" behaves differently for "tag" versus
"for-each-ref" (including "for-each-ref refs/tags/"),
which can lead to confusion.Instead, let's extend the "short" modifier in the formatting language to handle a specific prefix. This fixes "git tag", and lets users invoke the same behavior from their own custom formats (for "tag" or "for-each-ref") while leaving ":short" with its same consistent meaning in all places.
We introduce a test in t7004 for "git tag", which fails without this patch. We also add a similar test in t3203 for "git branch", which does not actually fail. But since it is likely that "branch" will eventually use the same formatting code, the test helps defend against future regressions.
Signed-off-by: Jeff King <peff@peff.net> --- Documentation/git-for-each-ref.txt | 4 +++- Documentation/git-tag.txt | 2 +- builtin/tag.c | 4 ++-- ref-filter.c | 3 +++ t/t3203-branch-output.sh | 8 ++++++++ t/t7004-tag.sh | 8 ++++++++ 6 files changed, 25 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt index 06208c4..faf10c5 100644 --- a/Documentation/git-for-each-ref.txt +++ b/Documentation/git-for-each-ref.txt @@ -92,7 +92,9 @@ refname:: The name of the ref (the part after $GIT_DIR/). For a non-ambiguous short name of the ref append `:short`. The option core.warnAmbiguousRefs is used to select the strict - abbreviation mode. + abbreviation mode. For shortening in a specific hierarchy, use + `:short=<prefix>`, which will remove `<prefix>` (if present) + from the front of the ref. E.g., `%(refname:short=refs/tags/)`. objecttype:: The type of the object (`blob`, `tree`, `commit`, `tag`). diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 7220e5e..62ff509 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -163,7 +163,7 @@ This option is only applicable when listing tags without annotation lines. A string that interpolates `%(fieldname)` from the object pointed at by a ref being shown. The format is the same as that of linkgit:git-for-each-ref[1]. When unspecified, - defaults to `%(refname:short)`. + defaults to `%(refname:short=refs/tags/)`. --[no-]merged [<commit>]:: Only list tags whose tips are reachable, or not reachable diff --git a/builtin/tag.c b/builtin/tag.c index 8db8c87..f60feb1 100644 --- a/builtin/tag.c +++ b/builtin/tag.c @@ -44,11 +44,11 @@ static int list_tags(struct ref_filter *filter, struct ref_sorting *sorting, con if (!format) { if (filter->lines) { to_free = xstrfmt("%s %%(contents:lines=%d)", - "%(align:15)%(refname:short)%(end)", + "%(align:15)%(refname:short=refs/tags/)%(end)", filter->lines); format = to_free; } else - format = "%(refname:short)"; + format = "%(refname:short=refs/tags/)"; } verify_ref_format(format); diff --git a/ref-filter.c b/ref-filter.c index 7bef7f8..b878b77 100644 --- a/ref-filter.c +++ b/ref-filter.c @@ -909,11 +909,14 @@ static void populate_value(struct ref_array_item *ref) formatp = strchr(name, ':'); if (formatp) { int num_ours, num_theirs; + const char *prefix; formatp++; if (!strcmp(formatp, "short")) refname = shorten_unambiguous_ref(refname, warn_ambiguous_refs); + else if (skip_prefix(formatp, "short=", &prefix)) + skip_prefix(refname, prefix, &refname); else if (!strcmp(formatp, "track") && (starts_with(name, "upstream") || starts_with(name, "push"))) { diff --git a/t/t3203-branch-output.sh b/t/t3203-branch-output.sh index d3913f9..4261403 100755 --- a/t/t3203-branch-output.sh +++ b/t/t3203-branch-output.sh @@ -176,4 +176,12 @@ test_expect_success 'git branch --points-at option' ' test_cmp expect actual ' +test_expect_success 'ambiguous branch/tag not marked' ' + git tag ambiguous && + git branch ambiguous && + echo " ambiguous" >expect && + git branch --list ambiguous >actual && + test_cmp expect actual +' + test_done diff --git a/t/t7004-tag.sh b/t/t7004-tag.sh index 2797f22..cf3469b 100755 --- a/t/t7004-tag.sh +++ b/t/t7004-tag.sh @@ -1558,4 +1558,12 @@ test_expect_success '--no-merged show unmerged tags' ' test_cmp expect actual ' +test_expect_success 'ambiguous branch/tags not marked' ' + git tag ambiguous && + git branch ambiguous && + echo ambiguous >expect && + git tag -l ambiguous >actual && + test_cmp expect actual +' + test_done
-- 2.7.0.425.g047222e