Merge branch 'js/p4-default-branch'
[git] / Documentation / config / checkout.txt
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`.
11 +
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.
19
20 checkout.guess::
21         Provides the default value for the `--guess` or `--no-guess`
22         option in `git checkout` and `git switch`. See
23         linkgit:git-switch[1] and linkgit:git-checkout[1].