path: root/Documentation/fetch-options.txt
diff options
authorJunio C Hamano <>2014-05-29 22:21:31 (GMT)
committerJunio C Hamano <>2014-06-05 22:13:12 (GMT)
commitc5558f80c3a34f411022f1bc67f8364556ca3922 (patch)
tree0e5d9c3c48e7bdddd7d53e4dd7670cae5b757e66 /Documentation/fetch-options.txt
parentfcb14b0c8d7a732b1d26b5fda18f730851a76eed (diff)
fetch: allow explicit --refmap to override configuration
Since the introduction of opportunisitic updates of remote-tracking branches, started at around f2690487 (fetch: opportunistically update tracking refs, 2013-05-11) with a few updates in v1.8.4 era, the remote.*.fetch configuration always kicks in even when a refspec to specify what to fetch is given on the command line, and there is no way to disable or override it per-invocation. Teach the command to pay attention to the --refmap=<lhs>:<rhs> command-line options that can be used to override the use of configured remote.*.fetch as the refmap. Signed-off-by: Junio C Hamano <> ---
Diffstat (limited to 'Documentation/fetch-options.txt')
1 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/fetch-options.txt b/Documentation/fetch-options.txt
index 92c68c3..b09a783 100644
--- a/Documentation/fetch-options.txt
+++ b/Documentation/fetch-options.txt
@@ -72,6 +72,14 @@ endif::git-pull[]
setting. See linkgit:git-config[1].
+ When fetching refs listed on the command line, use the
+ specified refspec (can be given more than once) to map the
+ refs to remote-tracking branches, instead of the values of
+ `remote.*.fetch` configuration variables for the remote
+ repository. See section on "Configured Remote-tracking
+ Branches" for details.
Fetch all tags from the remote (i.e., fetch remote tags