Re: [PATCH] git-checkout.txt: improve detached HEAD documentation

From: Junio C Hamano <gitster@pobox.com>
Date: Feb 22, 2011, 05:56 UTC
Message-ID: <7vd3mkfw8w.fsf@alter.siamese.dyndns.org>
In-Reply-To: <1298179310-46207-1-git-send-email-jaysoffian@gmail.com>

Jay Soffian <jaysoffian@gmail.com> writes:

Show 9 quoted lines

> +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), and adjust "three" accordingly.

Other than that, I think this version is a vast improvement over what we have.

Thanks.