3 test_description='checkout into detached HEAD state'
7 test_must_fail git symbolic-ref -q HEAD >/dev/null
10 check_not_detached () {
11 git symbolic-ref -q HEAD >/dev/null
14 PREV_HEAD_DESC='Previous HEAD position was'
15 check_orphan_warning() {
16 test_i18ngrep "you are leaving $2 behind" "$1" &&
17 test_i18ngrep ! "$PREV_HEAD_DESC" "$1"
19 check_no_orphan_warning() {
20 test_i18ngrep ! "you are leaving .* commit.*behind" "$1" &&
21 test_i18ngrep "$PREV_HEAD_DESC" "$1"
25 git checkout master &&
29 test_expect_success 'setup' '
32 test_commit three && git tag -d three &&
33 test_commit four && git tag -d four &&
38 test_expect_success 'checkout branch does not detach' '
40 git checkout branch &&
44 test_expect_success 'checkout tag detaches' '
50 test_expect_success 'checkout branch by full name detaches' '
52 git checkout refs/heads/branch &&
56 test_expect_success 'checkout non-ref detaches' '
58 git checkout branch^ &&
62 test_expect_success 'checkout ref^0 detaches' '
64 git checkout branch^0 &&
68 test_expect_success 'checkout --detach detaches' '
70 git checkout --detach branch &&
74 test_expect_success 'checkout --detach without branch name' '
76 git checkout --detach &&
80 test_expect_success 'checkout --detach errors out for non-commit' '
82 test_must_fail git checkout --detach one^{tree} &&
86 test_expect_success 'checkout --detach errors out for extra argument' '
88 git checkout master &&
89 test_must_fail git checkout --detach tag one.t &&
93 test_expect_success 'checkout --detached and -b are incompatible' '
95 test_must_fail git checkout --detach -b newbranch tag &&
99 test_expect_success 'checkout --detach moves HEAD' '
102 git checkout --detach two &&
103 git diff --exit-code HEAD &&
104 git diff --exit-code two
107 test_expect_success 'checkout warns on orphan commits' '
109 git checkout --detach two &&
110 echo content >orphan &&
112 git commit -a -m orphan1 &&
113 echo new content >orphan &&
114 git commit -a -m orphan2 &&
115 orphan2=$(git rev-parse HEAD) &&
116 git checkout master 2>stderr
119 test_expect_success 'checkout warns on orphan commits: output' '
120 check_orphan_warning stderr "2 commits"
123 test_expect_success 'checkout warns orphaning 1 of 2 commits' '
124 git checkout "$orphan2" &&
125 git checkout HEAD^ 2>stderr
128 test_expect_success 'checkout warns orphaning 1 of 2 commits: output' '
129 check_orphan_warning stderr "1 commit"
132 test_expect_success 'checkout does not warn leaving ref tip' '
134 git checkout --detach two &&
135 git checkout master 2>stderr
138 test_expect_success 'checkout does not warn leaving ref tip' '
139 check_no_orphan_warning stderr
142 test_expect_success 'checkout does not warn leaving reachable commit' '
144 git checkout --detach HEAD^ &&
145 git checkout master 2>stderr
148 test_expect_success 'checkout does not warn leaving reachable commit' '
149 check_no_orphan_warning stderr
153 Your branch is behind 'master' by 1 commit, and can be fast-forwarded.
154 (use "git pull" to update your local branch)
156 test_expect_success 'tracking count is accurate after orphan check' '
158 git branch child master^ &&
159 git config branch.child.remote . &&
160 git config branch.child.merge refs/heads/master &&
161 git checkout child^ &&
162 git checkout child >stdout &&
163 test_i18ncmp expect stdout
166 test_expect_success 'no advice given for explicit detached head state' '
168 test_config advice.detachedHead true &&
169 git checkout child && git checkout HEAD^0 >expect.advice 2>&1 &&
170 test_config advice.detachedHead false &&
171 git checkout child && git checkout HEAD^0 >expect.no-advice 2>&1 &&
172 test_unconfig advice.detachedHead &&
173 # without configuration, the advice.* variables default to true
174 git checkout child && git checkout HEAD^0 >actual 2>&1 &&
175 test_cmp expect.advice actual &&
177 # with explicit --detach
179 test_unconfig advice.detachedHead &&
180 git checkout child && git checkout --detach HEAD^0 >actual 2>&1 &&
181 test_cmp expect.no-advice actual &&
183 # explicitly decline advice
184 test_config advice.detachedHead false &&
185 git checkout child && git checkout --detach HEAD^0 >actual 2>&1 &&
186 test_cmp expect.no-advice actual
189 # Detached HEAD tests for GIT_PRINT_SHA1_ELLIPSIS (new format)
190 test_expect_success 'describe_detached_head prints no SHA-1 ellipsis when not asked to' "
192 commit=$(git rev-parse --short=12 master^) &&
193 commit2=$(git rev-parse --short=12 master~2) &&
194 commit3=$(git rev-parse --short=12 master~3) &&
196 # The first detach operation is more chatty than the following ones.
197 cat >1st_detach <<-EOF &&
198 Note: switching to 'HEAD^'.
200 You are in 'detached HEAD' state. You can look around, make experimental
201 changes and commit them, and you can discard any commits you make in this
202 state without impacting any branches by switching back to a branch.
204 If you want to create a new branch to retain commits you create, you may
205 do so (now or later) by using -c with the switch command. Example:
207 git switch -c <new-branch-name>
209 Or undo this operation with:
213 Turn off this advice by setting config variable advice.detachedHead to false
215 HEAD is now at \$commit three
218 # The remaining ones just show info about previous and current HEADs.
219 cat >2nd_detach <<-EOF &&
220 Previous HEAD position was \$commit three
221 HEAD is now at \$commit2 two
224 cat >3rd_detach <<-EOF &&
225 Previous HEAD position was \$commit2 two
226 HEAD is now at \$commit3 one
230 check_not_detached &&
232 # Various ways of *not* asking for ellipses
234 sane_unset GIT_PRINT_SHA1_ELLIPSIS &&
235 git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
237 test_i18ncmp 1st_detach actual &&
239 GIT_PRINT_SHA1_ELLIPSIS="no" git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
241 test_i18ncmp 2nd_detach actual &&
243 GIT_PRINT_SHA1_ELLIPSIS= git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
245 test_i18ncmp 3rd_detach actual &&
247 sane_unset GIT_PRINT_SHA1_ELLIPSIS &&
249 # We only have four commits, but we can re-use them
251 check_not_detached &&
253 # Make no mention of the env var at all
254 git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
256 test_i18ncmp 1st_detach actual &&
258 GIT_PRINT_SHA1_ELLIPSIS='nope' &&
259 git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
261 test_i18ncmp 2nd_detach actual &&
263 GIT_PRINT_SHA1_ELLIPSIS=nein &&
264 git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
266 test_i18ncmp 3rd_detach actual &&
271 # Detached HEAD tests for GIT_PRINT_SHA1_ELLIPSIS (old format)
272 test_expect_success 'describe_detached_head does print SHA-1 ellipsis when asked to' "
274 commit=$(git rev-parse --short=12 master^) &&
275 commit2=$(git rev-parse --short=12 master~2) &&
276 commit3=$(git rev-parse --short=12 master~3) &&
278 # The first detach operation is more chatty than the following ones.
279 cat >1st_detach <<-EOF &&
280 Note: switching to 'HEAD^'.
282 You are in 'detached HEAD' state. You can look around, make experimental
283 changes and commit them, and you can discard any commits you make in this
284 state without impacting any branches by switching back to a branch.
286 If you want to create a new branch to retain commits you create, you may
287 do so (now or later) by using -c with the switch command. Example:
289 git switch -c <new-branch-name>
291 Or undo this operation with:
295 Turn off this advice by setting config variable advice.detachedHead to false
297 HEAD is now at \$commit... three
300 # The remaining ones just show info about previous and current HEADs.
301 cat >2nd_detach <<-EOF &&
302 Previous HEAD position was \$commit... three
303 HEAD is now at \$commit2... two
306 cat >3rd_detach <<-EOF &&
307 Previous HEAD position was \$commit2... two
308 HEAD is now at \$commit3... one
312 check_not_detached &&
314 # Various ways of asking for ellipses...
315 # The user can just use any kind of quoting (including none).
317 GIT_PRINT_SHA1_ELLIPSIS=yes git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
319 test_i18ncmp 1st_detach actual &&
321 GIT_PRINT_SHA1_ELLIPSIS=Yes git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
323 test_i18ncmp 2nd_detach actual &&
325 GIT_PRINT_SHA1_ELLIPSIS=YES git -c 'core.abbrev=12' checkout HEAD^ >actual 2>&1 &&
327 test_i18ncmp 3rd_detach actual &&