git.txt: de-emphasize the implementation detail of a ref
authorJunio C Hamano <gitster@pobox.com>
Thu, 23 Jun 2011 16:35:10 +0000 (09:35 -0700)
committerJunio C Hamano <gitster@pobox.com>
Thu, 23 Jun 2011 22:38:18 +0000 (15:38 -0700)
It is an unimportant implementation detail that branches and tags are
stored somewhere under $GIT_DIR/refs directory, or the name of the commit
that will become the parent of the next commit is stored in $GIT_DIR/HEAD.

What is more important is that branches live in refs/heads and tags live
in refs/tags hierarchy in the ref namespace, and HEAD means the tip of the
current branch.

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git.txt

index 8c0bfdf5a08cf80419f35994d66b03a189d7ea2a..7fc6b88b96715bf65597b457163254788580a227 100644 (file)
@@ -510,16 +510,15 @@ Any git command accepting any <object> can also use the following
 symbolic notation:
 
 HEAD::
-       indicates the head of the current branch (i.e. the
-       contents of `$GIT_DIR/HEAD`).
+       indicates the head of the current branch.
 
 <tag>::
        a valid tag 'name'
-       (i.e. the contents of `$GIT_DIR/refs/tags/<tag>`).
+       (i.e. a `refs/tags/<tag>` reference).
 
 <head>::
        a valid head 'name'
-       (i.e. the contents of `$GIT_DIR/refs/heads/<head>`).
+       (i.e. a `refs/heads/<head>` reference).
 
 For a more complete list of ways to spell object names, see
 "SPECIFYING REVISIONS" section in linkgit:gitrevisions[7].