Johannes Schindelin <johannes.schindelin@xxxxxx> writes: > diff --git a/Documentation/git-rebase.txt b/Documentation/git-rebase.txt > index 8a861c1e0d6..1d061373288 100644 > --- a/Documentation/git-rebase.txt > +++ b/Documentation/git-rebase.txt > @@ -368,6 +368,11 @@ The commit list format can be changed by setting the configuration option > rebase.instructionFormat. A customized instruction format will automatically > have the long commit hash prepended to the format. > > +--recreate-merges:: > + Recreate merge commits instead of flattening the history by replaying > + merges. Merge conflict resolutions or manual amendments to merge > + commits are not preserved. > + It is sensible to postpone tackling "evil merges" in this initial iteration of the series, and "manual amendments ... not preserved" is a reasonable thing to document. But do we want to say a bit more about conflicting merges? "conflict resolutions ... not preserved" sounds as if it does not stop and instead record the result with conflict markers without even letting rerere to kick in, which certainly is not the impression you wanted to give to the readers. I am imagining that it will stop and give control back to the end user just like a conflicted "pick" would, and allow "rebase --continue" to record resolution from the working tree, and just like conflicted "pick", it would allow rerere() to help end users recall previous resolution.
