glossary: extend "detached HEAD" description
commit1d77d249f9b0605ed21ca751c5dfb8550efcdfa3
authorJunio C Hamano <gitster@pobox.com>
Fri, 5 Apr 2013 15:19:41 +0000 (5 08:19 -0700)
committerJunio C Hamano <gitster@pobox.com>
Fri, 5 Apr 2013 17:42:58 +0000 (5 10:42 -0700)
tree35aa5ba5c5e22985a00f7d1f77d12170bcc5a51d
parentaa7b8c657e407a10cbee728264ec48be16ea4e3d
glossary: extend "detached HEAD" description

When we introduced the concept of "detached HEAD", we made sure that
commands that operate on the history of the current branch "just
work" in that state.  They update the HEAD to point at the new
history without affecting any branch when the HEAD is detached, just
like they update the tip of the "current branch" to point at the new
history when HEAD points at a specific branch.

As this is done as the natural extension for these commands, we did
not, we still do not, and we do not want to repeat "A detached HEAD
is updated without affecting any branch" when describing what each
and every one of these commands that operates "on the current branch"
does.

Add a blanket description to the glossary to cover them instead.
The general principle is that operations to update the branch work
on and affect the HEAD, while operations to update the information
about a branch do not.

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