summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2016-02-05 22:54:15 (GMT)
committerJunio C Hamano <gitster@pobox.com>2016-02-05 22:54:15 (GMT)
commit88ec75dba425be4a18309f28a8c5ae01044fd29a (patch)
tree13ac7740a00e92c196a81c709b70eba4976d5a71 /Documentation
parent913c2c7c7be358144260bc81112e548d3276d694 (diff)
parent0571979bd60837d3c0802ecc1a47c48b4a6114d0 (diff)
downloadgit-88ec75dba425be4a18309f28a8c5ae01044fd29a.zip
git-88ec75dba425be4a18309f28a8c5ae01044fd29a.tar.gz
git-88ec75dba425be4a18309f28a8c5ae01044fd29a.tar.bz2
Merge branch 'jk/list-tag-2.7-regression' into maint
"git tag" started listing a tag "foo" as "tags/foo" when a branch named "foo" exists in the same repository; remove this unnecessary disambiguation, which is a regression introduced in v2.7.0. * jk/list-tag-2.7-regression: tag: do not show ambiguous tag names as "tags/foo" t6300: use test_atom for some un-modern tests
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-for-each-ref.txt6
-rw-r--r--Documentation/git-tag.txt2
2 files changed, 6 insertions, 2 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt
index c6f073c..d5e1781 100644
--- a/Documentation/git-for-each-ref.txt
+++ b/Documentation/git-for-each-ref.txt
@@ -92,7 +92,11 @@ 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. If `strip=<N>` is appended, strips `<N>`
+ slash-separated path components from the front of the refname
+ (e.g., `%(refname:strip=2)` turns `refs/tags/foo` into `foo`.
+ `<N>` must be a positive integer. If a displayed ref has fewer
+ components than `<N>`, the command aborts with an error.
objecttype::
The type of the object (`blob`, `tree`, `commit`, `tag`).
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index 7220e5e..abab481 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:strip=2)`.
--[no-]merged [<commit>]::
Only list tags whose tips are reachable, or not reachable