mirrors/git
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Doc/checkout: checking out using @{-N} can lead to detached state

Browse Source 
@{-N} is a syntax for the N-th last "checkout" and not the N-th
last "branch". Therefore, in some cases using `git checkout @{-$N}`
DOES lead to a "detached HEAD" state. This can also be ensured by
the commit message of 75d6e552a (Documentation: @{-N} can refer to
a commit, 2014-01-19) which clearly specifies how @{-N} can be used
to refer not only to a branch but also to a commit.

Correct the misleading sentence which states that @{-N} doesn't
detach HEAD.

Signed-off-by: Kaartic Sivaraam <kaartic.sivaraam@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
Kaartic Sivaraam
2017-11-27 22:58:33 +05:30
committed by Junio C Hamano
parent 9752ad0bb7
commit 75ce149575
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
Documentation/git-checkout.txt
View File

@ -263,11 +263,11 @@ section of linkgit:git-add[1] to learn how to operate the `--patch` mode.
commit, your HEAD becomes "detached" and you are no longer on commit, your HEAD becomes "detached" and you are no longer on
any branch (see below for details). any branch (see below for details).
+ +
As a special case, the `"@{-N}"` syntax for the N-th last branch/commit You can use the `"@{-N}"` syntax to refer to the N-th last
checks out branches (instead of detaching). You may also specify branch/commit checked out using "git checkout" operation. You may
`-` which is synonymous with `"@{-1}"`. also specify `-` which is synonymous to `"@{-1}`.
+ +
As a further special case, you may use `"A...B"` as a shortcut for the As a special case, you may use `"A...B"` as a shortcut for the
merge base of `A` and `B` if there is exactly one merge base. You can merge base of `A` and `B` if there is exactly one merge base. You can
leave out at most one of `A` and `B`, in which case it defaults to `HEAD`. leave out at most one of `A` and `B`, in which case it defaults to `HEAD`.