]> git.ipfire.org Git - thirdparty/git.git/commit - config.c
branch: add flags and config to inherit tracking
authorJosh Steadmon <steadmon@google.com>
Tue, 21 Dec 2021 03:30:23 +0000 (19:30 -0800)
committerJunio C Hamano <gitster@pobox.com>
Tue, 21 Dec 2021 06:40:21 +0000 (22:40 -0800)
commitd3115660b4cc4b1a32e77ddfd289afde5e4b94d8
tree5baeee60cbaafcb23d7ce8ac27941affdd47fdfb
parenta3f40ec4b0dc56a54e6a6866d0a44a04d4a6edf0
branch: add flags and config to inherit tracking

It can be helpful when creating a new branch to use the existing
tracking configuration from the branch point. However, there is
currently not a method to automatically do so.

Teach git-{branch,checkout,switch} an "inherit" argument to the
"--track" option. When this is set, creating a new branch will cause the
tracking configuration to default to the configuration of the branch
point, if set.

For example, if branch "main" tracks "origin/main", and we run
`git checkout --track=inherit -b feature main`, then branch "feature"
will track "origin/main". Thus, `git status` will show us how far
ahead/behind we are from origin, and `git pull` will pull from origin.

This is particularly useful when creating branches across many
submodules, such as with `git submodule foreach ...` (or if running with
a patch such as [1], which we use at $job), as it avoids having to
manually set tracking info for each submodule.

Since we've added an argument to "--track", also add "--track=direct" as
another way to explicitly get the original "--track" behavior ("--track"
without an argument still works as well).

Finally, teach branch.autoSetupMerge a new "inherit" option. When this
is set, "--track=inherit" becomes the default behavior.

[1]: https://lore.kernel.org/git/20180927221603.148025-1-sbeller@google.com/

Signed-off-by: Josh Steadmon <steadmon@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
16 files changed:
Documentation/config/branch.txt
Documentation/git-branch.txt
Documentation/git-checkout.txt
Documentation/git-switch.txt
branch.c
branch.h
builtin/branch.c
builtin/checkout.c
config.c
parse-options-cb.c
parse-options.h
t/t2017-checkout-orphan.sh
t/t2027-checkout-track.sh
t/t2060-switch.sh
t/t3200-branch.sh
t/t7201-co.sh