From: Chris Rorvick <chris@rorvick.com>
Date: Mon, 17 Dec 2012 06:45:02 +0000 (-0600)
Subject: Documentation/git-checkout.txt: document 70c9ac2 behavior
X-Git-Tag: v1.8.1-rc3~3^2
X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/00bb4378c788a6bd6e4fdbca1f9f70ec8c2fe30c?hp=--cc

Documentation/git-checkout.txt: document 70c9ac2 behavior

Document the behavior implemented in 70c9ac2 (DWIM "git checkout
frotz" to "git checkout -b frotz origin/frotz").

Signed-off-by: Chris Rorvick <chris@rorvick.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
---

00bb4378c788a6bd6e4fdbca1f9f70ec8c2fe30c
diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt
index ad33eb49ae..6f04d22f5e 100644
--- a/Documentation/git-checkout.txt
+++ b/Documentation/git-checkout.txt
@@ -28,6 +28,14 @@ branch.
 	working tree are kept, so that they can be committed to the
 	<branch>.
 +
+If <branch> is not found but there does exist a tracking branch in
+exactly one remote (call it <remote>) with a matching name, treat as
+equivalent to
++
+------------
+$ git checkout -b <branch> --track <remote>/<branch>
+------------
++
 You could omit <branch>, in which case the command degenerates to
 "check out the current branch", which is a glorified no-op with a
 rather expensive side-effects to show only the tracking information,