Skip to content

Commit 3630654

Browse files
committed
fetch doc: remove notes on outdated "mixed layout"
In old days before Git 1.5, it was customery for "git fetch" to use the same local branch namespace to keep track of the remote-tracking branches, and it was necessary to tell users not to check them out and commit on them. Since everybody uses the separate remote layout these days, there is no need to warn against the practice to check out the right-hand side of <refspec> and build on it---the RHS is typically not even a local branch. Incidentally, this also kills one mention of "Pull:" line of $GIT_DIR/remotes/* configuration, which is a lot less familiar to new people than the more modern remote.*.fetch configuration variable. Signed-off-by: Junio C Hamano <[email protected]>
1 parent f471dbc commit 3630654

File tree

1 file changed

+0
-13
lines changed

1 file changed

+0
-13
lines changed

Documentation/pull-fetch-param.txt

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -36,19 +36,6 @@ in a repository with this behavior; the pulling user simply
3636
must know this is the expected usage pattern for a branch.
3737
+
3838
[NOTE]
39-
You never do your own development on branches that appear
40-
on the right hand side of a <refspec> colon on `Pull:` lines;
41-
they are to be updated by 'git fetch'. If you intend to do
42-
development derived from a remote branch `B`, have a `Pull:`
43-
line to track it (i.e. `Pull: B:remote-B`), and have a separate
44-
branch `my-B` to do your development on top of it. The latter
45-
is created by `git branch my-B remote-B` (or its equivalent `git
46-
checkout -b my-B remote-B`). Run `git fetch` to keep track of
47-
the progress of the remote side, and when you see something new
48-
on the remote branch, merge it into your development branch with
49-
`git pull . remote-B`, while you are on `my-B` branch.
50-
+
51-
[NOTE]
5239
There is a difference between listing multiple <refspec>
5340
directly on 'git pull' command line and having multiple
5441
`Pull:` <refspec> lines for a <repository> and running

0 commit comments

Comments
 (0)