Browse Source

Document that the default of branch.autosetupmerge is true

In 34a3e69 (git-branch: default to --track) the default was changed to
true, to help new git users.  But yours truly forgot to update the
documentation.  This fixes it.

Noticed by Kalle Olavi Niemitalo.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Johannes Schindelin 17 years ago committed by Junio C Hamano
parent
commit
0ed50ceb48
  1. 2
      Documentation/config.txt
  2. 15
      Documentation/git-branch.txt
  3. 7
      Documentation/git-checkout.txt

2
Documentation/config.txt

@ -333,7 +333,7 @@ branch.autosetupmerge::
so that linkgit:git-pull[1] will appropriately merge from that so that linkgit:git-pull[1] will appropriately merge from that
remote branch. Note that even if this option is not set, remote branch. Note that even if this option is not set,
this behavior can be chosen per-branch using the `--track` this behavior can be chosen per-branch using the `--track`
and `--no-track` options. This option defaults to false. and `--no-track` options. This option defaults to true.


branch.<name>.remote:: branch.<name>.remote::
When in branch <name>, it tells `git fetch` which remote to fetch. When in branch <name>, it tells `git fetch` which remote to fetch.

15
Documentation/git-branch.txt

@ -34,11 +34,11 @@ Note that this will create the new branch, but it will not switch the
working tree to it; use "git checkout <newbranch>" to switch to the working tree to it; use "git checkout <newbranch>" to switch to the
new branch. new branch.


When a local branch is started off a remote branch, git can setup the When a local branch is started off a remote branch, git sets up the
branch so that linkgit:git-pull[1] will appropriately merge from that branch so that linkgit:git-pull[1] will appropriately merge from that
remote branch. If this behavior is desired, it is possible to make it remote branch. If this behavior is not desired, it is possible to
the default using the global `branch.autosetupmerge` configuration disable it using the global `branch.autosetupmerge` configuration
flag. Otherwise, it can be chosen per-branch using the `--track` flag. That setting can be overridden by using the `--track`
and `--no-track` options. and `--no-track` options.


With a '-m' or '-M' option, <oldbranch> will be renamed to <newbranch>. With a '-m' or '-M' option, <oldbranch> will be renamed to <newbranch>.
@ -108,10 +108,11 @@ OPTIONS
Set up configuration so that git-pull will automatically Set up configuration so that git-pull will automatically
retrieve data from the remote branch. Use this if you always retrieve data from the remote branch. Use this if you always
pull from the same remote branch into the new branch, or if you pull from the same remote branch into the new branch, or if you
don't want to use "git pull <repository> <refspec>" explicitly. Set the don't want to use "git pull <repository> <refspec>" explicitly.
branch.autosetupmerge configuration variable to true if you This behavior is the default. Set the
branch.autosetupmerge configuration variable to false if you
want git-checkout and git-branch to always behave as if want git-checkout and git-branch to always behave as if
'--track' were given. '--no-track' were given.


--no-track:: --no-track::
When a branch is created off a remote branch, When a branch is created off a remote branch,

7
Documentation/git-checkout.txt

@ -52,10 +52,11 @@ OPTIONS
set up configuration so that git-pull will automatically set up configuration so that git-pull will automatically
retrieve data from the remote branch. Use this if you always retrieve data from the remote branch. Use this if you always
pull from the same remote branch into the new branch, or if you pull from the same remote branch into the new branch, or if you
don't want to use "git pull <repository> <refspec>" explicitly. Set the don't want to use "git pull <repository> <refspec>" explicitly.
branch.autosetupmerge configuration variable to true if you This behavior is the default. Set the
branch.autosetupmerge configuration variable to false if you
want git-checkout and git-branch to always behave as if want git-checkout and git-branch to always behave as if
'--track' were given. '--no-track' were given.


--no-track:: --no-track::
When -b is given and a branch is created off a remote branch, When -b is given and a branch is created off a remote branch,

Loading…
Cancel
Save