Autogenerated HTML docs for v1.8.2.1-478-g1468a

1 files changed, 16 insertions, 4 deletions

diff --git a/gitglossary.html b/gitglossary.html
index 0126b311e..96d086f33 100644
--- a/gitglossary.html
+++ b/gitglossary.html
@@ -932,10 +932,22 @@ to point at the new commit.</p></div>
 <dd>

 <p>

         Normally the <a href="#def_HEAD">HEAD</a> stores the name of a

-        <a href="#def_branch">branch</a>.  However, Git also allows you to <a href="#def_checkout">check out</a>

-        an arbitrary <a href="#def_commit">commit</a> that isn&#8217;t necessarily the tip of any

-        particular branch.  In this case HEAD is said to be "detached".

-</p>

+        <a href="#def_branch">branch</a>, and commands that operate on the

+        history HEAD represents operate on the history leading to the

+        tip of the branch the HEAD points at.  However, Git also

+        allows you to <a href="#def_checkout">check out</a> an arbitrary

+        <a href="#def_commit">commit</a> that isn&#8217;t necessarily the tip of any

+        particular branch.  The HEAD in such a state is called

+        "detached".

+</p>

+<div class="paragraph"><p>Note that commands that operate on the history of the current branch

+(e.g. <code>git commit</code> 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 <em>about</em> the current branch (e.g. <code>git

+branch --set-upstream-to</code> 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.</p></div>

 </dd>

 <dt class="hdlist1">

 <a id="def_dircache"></a>dircache