From: Jay Soffian Date: Tue, 22 Feb 2011 15:19:03 GMT Subject: Re: [PATCH] git-checkout.txt: improve detached HEAD documentation Message-ID: In-Reply-To: <7vd3mkfw8w.fsf@alter.siamese.dyndns.org> On Tue, Feb 22, 2011 at 12:56 AM, Junio C Hamano wrote: > Jay Soffian writes: > >> +It is sometimes useful to be able to checkout a commit that is not at >> +the tip of any named branch, or even to create a new commit that is not >> +referenced by a named branch. Let's look at what happens when we >> +checkout commit 'b' (here we show three ways this may be done): >> >> +------------ >> +$ git checkout v2.0  # or >> +$ git checkout b     # or >> +$ git checkout master^^ > > I'd drop the second one, as "b" is not something the end user would type > from the command line (you could say "b's commit ID" but the string 'b' is > not it, unless it is a tag or something, in which case the first one that > uses 'v2.0' already illustrates it) Ah, in my mind, b _is_ the commit-ID. In your mind, b is the commit. Fair enough, drop it. > and adjust "three" accordingly. Other than that, I think this version is > a vast improvement over what we have. Would you mind amending what you've got so I don't have to resend? Thanks, j.