branch: deprecate --set-upstream and show help if we detect possible mistaken use
This interface is error prone, and a better one (--set-upstream-to) exists. Add a message listing the alternatives and suggest how to fix a --set-upstream invocation in case the user only gives one argument which causes a local branch with the same name as a remote-tracking one to be created. The typical case is git branch --set-upstream origin/master when the user meant git branch --set-upstream master origin/master assuming that the current branch is master. Show a message telling the user how to undo their action and get what they wanted. For the command above, the message would be The --set-upstream flag is deprecated and will be removed. Consider using --track or --set-upstream-to Branch origin/master set up to track local branch master. If you wanted to make 'master' track 'origin/master', do this: git branch -d origin/master git branch --set-upstream-to origin/master Signed-off-by: Carlos Martín Nieto <cmn@elego.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:

committed by
Junio C Hamano

parent
b84869ef14
commit
b347d06bf0
@ -405,6 +405,40 @@ test_expect_success 'test --unset-upstream on a particular branch' \
|
||||
test_must_fail git config branch.my14.remote &&
|
||||
test_must_fail git config branch.my14.merge'
|
||||
|
||||
test_expect_success '--set-upstream shows message when creating a new branch that exists as remote-tracking' \
|
||||
'git update-ref refs/remotes/origin/master HEAD &&
|
||||
git branch --set-upstream origin/master 2>actual &&
|
||||
test_when_finished git update-ref -d refs/remotes/origin/master &&
|
||||
test_when_finished git branch -d origin/master &&
|
||||
cat >expected <<EOF &&
|
||||
The --set-upstream flag is deprecated and will be removed. Consider using --track or --set-upstream-to
|
||||
|
||||
If you wanted to make '"'master'"' track '"'origin/master'"', do this:
|
||||
|
||||
git branch -d origin/master
|
||||
git branch --set-upstream-to origin/master
|
||||
EOF
|
||||
test_cmp expected actual
|
||||
'
|
||||
|
||||
test_expect_success '--set-upstream with two args only shows the deprecation message' \
|
||||
'git branch --set-upstream master my13 2>actual &&
|
||||
test_when_finished git branch --unset-upstream master &&
|
||||
cat >expected <<EOF &&
|
||||
The --set-upstream flag is deprecated and will be removed. Consider using --track or --set-upstream-to
|
||||
EOF
|
||||
test_cmp expected actual
|
||||
'
|
||||
|
||||
test_expect_success '--set-upstream with one arg only shows the deprecation message if the branch existed' \
|
||||
'git branch --set-upstream my13 2>actual &&
|
||||
test_when_finished git branch --unset-upstream my13 &&
|
||||
cat >expected <<EOF &&
|
||||
The --set-upstream flag is deprecated and will be removed. Consider using --track or --set-upstream-to
|
||||
EOF
|
||||
test_cmp expected actual
|
||||
'
|
||||
|
||||
# Keep this test last, as it changes the current branch
|
||||
cat >expect <<EOF
|
||||
$_z40 $HEAD $GIT_COMMITTER_NAME <$GIT_COMMITTER_EMAIL> 1117150200 +0000 branch: Created from master
|
||||
|
Reference in New Issue
Block a user