Browse Source

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>
maint
Elijah Newren 4 years ago committed by Junio C Hamano
parent
commit
510415ecc9
  1. 13
      Documentation/merge-strategies.txt

13
Documentation/merge-strategies.txt

@ -6,13 +6,6 @@ backend 'merge strategies' to be chosen with `-s` option. Some strategies @@ -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>];; @@ -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

Loading…
Cancel
Save