merge-strategies.txt: update wording for the resolve strategy

It is probably helpful to cover the default merge strategy first, so
move the text for the resolve strategy to later in the document.

Further, the wording for "resolve" claimed that it was "considered
generally safe and fast", which might imply in some readers minds that
the same is not true of other strategies.  Rather than adding this text
to all the strategies, just remove it from this one.

Acked-by: Derrick Stolee <dstolee@microsoft.com>
Acked-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Signed-off-by: Elijah Newren <newren@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/merge-strategies.txt b/Documentation/merge-strategies.txt
index 5d707e952aa12ac9fe26a109b81e05d5dae4f072..f100fad1e43a6c11a2e0c3289bb2aa2f0d412e92 100644 (file)
--- a/Documentation/merge-strategies.txt
+++ b/Documentation/merge-strategies.txt
@@ -6,13 +6,6 @@ backend 'merge strategies' to be chosen with `-s` option.  Some strategies
 can also take their own options, which can be passed by giving `-X<option>`
 arguments to `git merge` and/or `git pull`.
 
-resolve::
-       This can only resolve two heads (i.e. the current branch
-       and another branch you pulled from) using a 3-way merge
-       algorithm.  It tries to carefully detect criss-cross
-       merge ambiguities and is considered generally safe and
-       fast.
-
 recursive::
        This can only resolve two heads using a 3-way merge
        algorithm.  When there is more than one common
@@ -106,6 +99,12 @@ subtree[=<path>];;
        is prefixed (or stripped from the beginning) to make the shape of
        two trees to match.
 
+resolve::
+       This can only resolve two heads (i.e. the current branch
+       and another branch you pulled from) using a 3-way merge
+       algorithm.  It tries to carefully detect criss-cross
+       merge ambiguities.  It does not handle renames.
+
 octopus::
        This resolves cases with more than two heads, but refuses to do
        a complex merge that needs manual resolution.  It is