summaryrefslogtreecommitdiffstats
path: root/git-checkout.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-08-02 16:01:45 -0700
committerJunio C Hamano <gitster@pobox.com>2018-08-02 16:01:45 -0700
commitf09b7cd0fc08d1df0fbd5c756672772049836b7a (patch)
treef5407aed048f255184084b9127f43dbf337eb27a /git-checkout.txt
parent1ff0338e53a8f0c62e5a9370e770e20058c5ad1e (diff)
downloadgit-htmldocs-f09b7cd0fc08d1df0fbd5c756672772049836b7a.tar.gz
Autogenerated HTML docs for v2.18.0-547-g1d893
Diffstat (limited to 'git-checkout.txt')
-rw-r--r--git-checkout.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/git-checkout.txt b/git-checkout.txt
index ca5fc9c79..9db02928c 100644
--- a/git-checkout.txt
+++ b/git-checkout.txt
@@ -38,6 +38,15 @@ equivalent to
$ git checkout -b <branch> --track <remote>/<branch>
------------
+
+If the branch exists in multiple remotes and one of them is named by
+the `checkout.defaultRemote` configuration variable, we'll use that
+one for the purposes of disambiguation, even if the `<branch>` isn't
+unique across all remotes. Set it to
+e.g. `checkout.defaultRemote=origin` to always checkout remote
+branches from there if `<branch>` is ambiguous but exists on the
+'origin' remote. See also `checkout.defaultRemote` in
+linkgit:git-config[1].
++
You could omit <branch>, in which case the command degenerates to
"check out the current branch", which is a glorified no-op with
rather expensive side-effects to show only the tracking information,