Fourth batch
[git/raj.git] / Documentation / config / checkout.txt
blob6b646813abadc95a969d5c20f6c4350a284bf129
1 checkout.defaultRemote::
2         When you run 'git checkout <something>'
3         or 'git switch <something>' and only have one
4         remote, it may implicitly fall back on checking out and
5         tracking e.g. 'origin/<something>'. This stops working as soon
6         as you have more than one remote with a '<something>'
7         reference. This setting allows for setting the name of a
8         preferred remote that should always win when it comes to
9         disambiguation. The typical use-case is to set this to
10         `origin`.
12 Currently this is used by linkgit:git-switch[1] and
13 linkgit:git-checkout[1] when 'git checkout <something>'
14 or 'git switch <something>'
15 will checkout the '<something>' branch on another remote,
16 and by linkgit:git-worktree[1] when 'git worktree add' refers to a
17 remote branch. This setting might be used for other checkout-like
18 commands or functionality in the future.