Documentation/git-merge.txt: Partial rewrite of How Merge Works
commitc0be8aa06b85f3f18fd4c49dfbda14c2943ccda7
authorPetr Baudis <pasky@suse.cz>
Sat, 19 Jul 2008 18:17:22 +0000 (19 20:17 +0200)
committerJunio C Hamano <gitster@pobox.com>
Sat, 19 Jul 2008 18:25:27 +0000 (19 11:25 -0700)
treee9917ee47cc05797a1599ecda7888d35c53ef06e
parent8575ea559ec4f0ea8b292bca7b262f221c5aa122
Documentation/git-merge.txt: Partial rewrite of How Merge Works

The git-merge documentation's "HOW MERGE WORKS" section is confusingly
composed and actually omits the most interesting part, the merging of
the arguments into HEAD itself, surprisingly not actually mentioning
the fast-forward merge anywhere.

This patch replaces the "[NOTE]" screenful of highly technical details
by a single sentence summing up the interesting information, and instead
explains how are the arguments compared with HEAD and the three possible
inclusion states that are named "Already up-to-date", "Fast-forward"
and "True merge". It also makes it clear that the rest of the section
talks only about the true merge situation, and slightly expands the
talk on solving conflicts.

Junio initiated the removal of the Note screenful altogether and
offered many stylistical fixes.

Signed-off-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-merge.txt