git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2] git-checkout.txt: clarify that <branch> applies when no path is given.

From
Matthieu Moy <matthieu.moy@imag.fr>
Date
Apr 7, 2009, 12:43 UTC
Message-ID
<1239108233-20924-1-git-send-email-Matthieu.Moy@imag.fr>
In-Reply-To
<1239099643-11959-1-git-send-email-Matthieu.Moy@imag.fr>

Otherwise, the sentence "Defaults to HEAD." can be mis-read to mean that "git checkout -- hello.c" checks-out from HEAD.

Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
---
Sorry, patch v1 was introducing a spurious newline, which broke
asciidoc syntax. This fixes it, but Junio, if you already applied v1,
just remove the empty line after <branch>:: and before +.
 Documentation/git-checkout.txt |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)
diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt
index 0b5485b..223ea9c 100644
--- a/Documentation/git-checkout.txt
+++ b/Documentation/git-checkout.txt
@@ -126,9 +126,13 @@ the conflicted merge in the specified paths.
 <new_branch>::
 	Name for the new branch.
 
+<tree-ish>::
+	Tree to checkout from (when paths are given). If not specified,
+	the index will be used.
+
 <branch>::
-	Branch to checkout; may be any object ID that resolves to a
-	commit.  Defaults to HEAD.
+	Branch to checkout (when no paths are given); may be any object
+	ID that resolves to a commit.  Defaults to HEAD.
 +
 When this parameter names a non-branch (but still a valid commit object),
 your HEAD becomes 'detached'.
-- 
1.6.2.2.449.g92961.dirty
Previous: Matthieu MoyNext: Junio C Hamano
Message 5 of 6 in “git-checkout.txt: fix incorrect statement about HEAD and index”
  1. 1/2 git-checkout.txt: fix incorrect statement about HEAD and indexMatthieu Moy, Apr 6, 2009
  2. 2/2 git-checkout.txt: clarify that <branch> applies when no path is given.Matthieu Moy, Apr 6, 2009
  3. Mike RalphsonApr 7, 2009
  4. 1/2 git-checkout.txt: clarify that <branch> applies when no path is given.Matthieu Moy, Apr 7, 2009
  5. git-checkout.txt: clarify that <branch> applies when no path is given.Matthieu Moy, Apr 7, 2009
  6. Junio C HamanoApr 7, 2009

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.