summaryrefslogtreecommitdiffstats
path: root/pull-fetch-param.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-10-05 15:21:55 -0700
committerJunio C Hamano <gitster@pobox.com>2020-10-05 15:21:55 -0700
commitd12815176f71c07e3844623f2c9c1ffc75a44574 (patch)
tree412c3124c3211cddd1af508e09b250dfe5755e77 /pull-fetch-param.txt
parent36ebb0e3ab4a7aa8b34196786a989cf6a523c648 (diff)
downloadgit-htmldocs-d12815176f71c07e3844623f2c9c1ffc75a44574.tar.gz
Autogenerated HTML docs for v2.29.0-rc0
Diffstat (limited to 'pull-fetch-param.txt')
-rw-r--r--pull-fetch-param.txt16
1 files changed, 16 insertions, 0 deletions
diff --git a/pull-fetch-param.txt b/pull-fetch-param.txt
index 95ea84990..95a7390b2 100644
--- a/pull-fetch-param.txt
+++ b/pull-fetch-param.txt
@@ -30,6 +30,22 @@ The colon can be omitted when <dst> is empty. <src> is
typically a ref, but it can also be a fully spelled hex object
name.
+
+A <refspec> may contain a `*` in its <src> to indicate a simple pattern
+match. Such a refspec functions like a glob that matches any ref with the
+same prefix. A pattern <refspec> must have a `*` in both the <src> and
+<dst>. It will map refs to the destination by replacing the `*` with the
+contents matched from the source.
++
+If a refspec is prefixed by `^`, it will be interpreted as a negative
+refspec. Rather than specifying which refs to fetch or which local refs to
+update, such a refspec will instead specify refs to exclude. A ref will be
+considered to match if it matches at least one positive refspec, and does
+not match any negative refspec. Negative refspecs can be useful to restrict
+the scope of a pattern refspec so that it will not include specific refs.
+Negative refspecs can themselves be pattern refspecs. However, they may only
+contain a <src> and do not specify a <dst>. Fully spelled out hex object
+names are also not supported.
++
`tag <tag>` means the same as `refs/tags/<tag>:refs/tags/<tag>`;
it requests fetching everything up to the given tag.
+