docs: clarify what git-rebase's "-p" / "--preserve-merges" does
commitd50d31e8808261eccfa6bde826e5e63368e29573
authorSebastian Schuberth <sschuberth@gmail.com>
Mon, 30 Mar 2015 09:29:46 +0000 (30 11:29 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 30 Mar 2015 20:44:29 +0000 (30 13:44 -0700)
treee4c8d61c5e333a8bbb010313688aaa239c46d3c8
parent129260cbd42f2a9fb40055ac6ed32c7b75a5ec05
docs: clarify what git-rebase's "-p" / "--preserve-merges" does

Ignoring a merge can be read as ignoring the changes a merge commit
introduces altogether, as if the entire side branch the merge commit
merged was removed from the history.  But that is not what happens
if "-p" is not specified.  What happens is that the individual
commits a merge commit introduces are replayed in order, and only
any possible merge conflict resolutions or manual amendments to the
merge commit are ignored.

Get this straight in the docs.

Also, do not say that merge commits are *tried* to be recreated. As that is
true almost everywhere it is better left unsaid.

Signed-off-by: Sebastian Schuberth <sschuberth@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-rebase.txt