summaryrefslogtreecommitdiffstats
path: root/Documentation/git-describe.txt
diff options
context:
space:
mode:
authorJacob Keller <jacob.keller@gmail.com>2017-01-19 00:06:07 +0100
committerJunio C Hamano <gitster@pobox.com>2017-01-24 03:33:17 +0100
commit43f8080eaff82e7aedaec5aa3abfd115cf1af695 (patch)
treeffd0fcd51706bc5299d6a34505737bece08a808d /Documentation/git-describe.txt
parentname-rev: add support to exclude refs by pattern match (diff)
downloadgit-43f8080eaff82e7aedaec5aa3abfd115cf1af695.tar.xz
git-43f8080eaff82e7aedaec5aa3abfd115cf1af695.zip
describe: teach --match to accept multiple patterns
Teach `--match` to be accepted multiple times, accumulating a list of patterns to match into a string list. Each pattern is inclusive, such that a tag need only match one of the provided patterns to be considered for matching. This extension is useful as it enables more flexibility in what tags match, and may avoid the need to run the describe command multiple times to get the same result. Add tests and update the documentation for this change. Signed-off-by: Jacob Keller <jacob.keller@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-describe.txt')
-rw-r--r--Documentation/git-describe.txt5
1 files changed, 4 insertions, 1 deletions
diff --git a/Documentation/git-describe.txt b/Documentation/git-describe.txt
index e4ac448ff5..7ad41e2f6a 100644
--- a/Documentation/git-describe.txt
+++ b/Documentation/git-describe.txt
@@ -83,7 +83,10 @@ OPTIONS
--match <pattern>::
Only consider tags matching the given `glob(7)` pattern,
excluding the "refs/tags/" prefix. This can be used to avoid
- leaking private tags from the repository.
+ leaking private tags from the repository. If given multiple times, a
+ list of patterns will be accumulated, and tags matching any of the
+ patterns will be considered. Use `--no-match` to clear and reset the
+ list of patterns.
--always::
Show uniquely abbreviated commit object as fallback.