[PATCH v4 01/19] doc: pull: explain what is a fast-forward

From: Felipe Contreras <felipe.contreras@gmail.com>
Date: Dec 8, 2020, 00:26 UTC
Message-ID: <20201208002648.1370414-2-felipe.contreras@gmail.com>
In-Reply-To: <20201208002648.1370414-1-felipe.contreras@gmail.com>

We want users to know what is a fast-forward in order to understand the default warning.

Signed-off-by: Felipe Contreras <felipe.contreras@gmail.com>
---
 Documentation/git-pull.txt | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Documentation/git-pull.txt b/Documentation/git-pull.txt
index 5c3fb67c01..e1605a81b3 100644
--- a/Documentation/git-pull.txt
+++ b/Documentation/git-pull.txt
@@ -38,6 +38,20 @@ as set by linkgit:git-branch[1] `--track`.
 Assume the following history exists and the current branch is
 "`master`":
 
+------------
+	  A---B---C master on origin
+	 /
+    D---E master
+------------
+
+Then `git pull` will merge in a fast-forward way up to the new master.
+
+------------
+    D---E---A---B---C master, origin/master
+------------
+
+However, a non-fast-forward case looks very different.
+
 ------------
 	  A---B---C master on origin
 	 /

-- 
2.29.2