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

Merge branch 'jc/detached-head-doc'

Browse Source 
* jc/detached-head-doc:
  glossary: extend "detached HEAD" description
This commit is contained in:
Junio C Hamano
2013-04-18 11:46:29 -07:00
parent 193e28f050 1d77d249f9
commit cd797c7e6b
1 changed files with 16 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
Documentation/glossary-content.txt
View File

@ -100,9 +100,22 @@ to point at the new commit.
[[def_detached_HEAD]]detached HEAD:: [[def_detached_HEAD]]detached HEAD::
Normally the <<def_HEAD,HEAD>> stores the name of a Normally the <<def_HEAD,HEAD>> stores the name of a
<<def_branch,branch>>. However, Git also allows you to <<def_checkout,check out>> <<def_branch,branch>>, and commands that operate on the
an arbitrary <<def_commit,commit>> that isn't necessarily the tip of any history HEAD represents operate on the history leading to the
particular branch. In this case HEAD is said to be "detached". tip of the branch the HEAD points at. However, Git also
allows you to <<def_checkout,check out>> an arbitrary
<<def_commit,commit>> that isn't necessarily the tip of any
particular branch. The HEAD in such a state is called
"detached".
+
Note that commands that operate on the history of the current branch
(e.g. `git commit` to build a new history on top of it) still work
while the HEAD is detached. They update the HEAD to point at the tip
of the updated history without affecting any branch. Commands that
update or inquire information _about_ the current branch (e.g. `git
branch --set-upstream-to` that sets what remote tracking branch the
current branch integrates with) obviously do not work, as there is no
(real) current branch to ask about in this state.
[[def_dircache]]dircache:: [[def_dircache]]dircache::
You are *waaaaay* behind. See <<def_index,index>>. You are *waaaaay* behind. See <<def_index,index>>.