]> git.ipfire.org Git - thirdparty/git.git/commitdiff
doc: git-pull: delete the example
authorJulia Evans <julia@jvns.ca>
Wed, 15 Oct 2025 13:13:30 +0000 (13:13 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 15 Oct 2025 20:17:52 +0000 (13:17 -0700)
From user feedback: this example is confusing because it implies that
`git pull` will run `git merge` by default, but the default is
`--ff-only`.

We could instead show an example of a fast-forward merge, but that may
not add a lot since fast-forward merges are relatively simple. This lets
us keep the description short.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-pull.adoc

index 0686a9d6661c97d02ece2ae40889e418207b5eb2..273172aa8036b5d6f41b30e28ca2230a51196356 100644 (file)
@@ -36,32 +36,6 @@ There are 4 main options for integrating the remote branch:
 You can also set the configuration options `pull.rebase`, `pull.squash`,
 or `pull.ff` with your preferred behaviour.
 
-Assume the following history exists and the current branch is
-"`master`":
-
-------------
-         A---B---C master on origin
-        /
-    D---E---F---G master
-       ^
-       origin/master in your repository
-------------
-
-Then "`git pull`" will fetch and replay the changes from the remote
-`master` branch since it diverged from the local `master` (i.e., `E`)
-until its current commit (`C`) on top of `master` and record the
-result in a new commit along with the names of the two parent commits
-and a log message from the user describing the changes.
-
-------------
-         A---B---C origin/master
-        /         \
-    D---E---F---G---H master
-------------
-
-See linkgit:git-merge[1] for details, including how conflicts
-are presented and handled.
-
 In Git 1.7.0 or later, to cancel a conflicting merge, use
 `git reset --merge`.  *Warning*: In older versions of Git, running 'git pull'
 with uncommitted changes is discouraged: while possible, it leaves you