Thread (28 messages) 28 messages, 11 authors, 2016-06-15

User manual: "You cannot check out these remote-tracking branches"

flat view

From: Jonathan Nieder <hidden>
Date: 2016-06-15 22:49:49
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

Thore Husfeldt wrote:
Also, in the user-manual.txt:
[...]
quoted
  origin/todo
------------------------------------------------

You cannot check out these remote-tracking branches, but you can
examine them on a branch of your own, just as you would a tag:
That’s just wrong, isn’t it?
That's historical baggage, I'm afraid.

Signed-off-by: Jonathan Nieder <redacted>
---
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index 77eb483..9f82fa6 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -359,13 +359,16 @@ $ git branch -r
   origin/todo
 ------------------------------------------------
 
-You cannot check out these remote-tracking branches, but you can
-examine them on a branch of your own, just as you would a tag:
+You might want to build on one of these remote-tracking branches
+on a branch of your own, just as you would a tag:
 
 ------------------------------------------------
 $ git checkout -b my-todo-copy origin/todo
 ------------------------------------------------
 
+You can also check out "origin/todo" directly to examine it or
+write a one-off patch.  See <<detached-head,detached head>>.
+
 Note that the name "origin" is just the name that git uses by default
 to refer to the repository that you cloned from.
 
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help