2005-11-06 17:26:07 +01:00
|
|
|
MERGE STRATEGIES
|
|
|
|
----------------
|
|
|
|
|
|
|
|
resolve::
|
|
|
|
This can only resolve two heads (i.e. the current branch
|
2009-03-25 19:23:42 +01:00
|
|
|
and another branch you pulled from) using a 3-way merge
|
2005-11-06 17:26:07 +01:00
|
|
|
algorithm. It tries to carefully detect criss-cross
|
|
|
|
merge ambiguities and is considered generally safe and
|
2005-12-08 23:04:33 +01:00
|
|
|
fast.
|
2005-11-06 17:26:07 +01:00
|
|
|
|
|
|
|
recursive::
|
2009-03-25 19:23:42 +01:00
|
|
|
This can only resolve two heads using a 3-way merge
|
|
|
|
algorithm. When there is more than one common
|
|
|
|
ancestor that can be used for 3-way merge, it creates a
|
2005-12-08 23:04:33 +01:00
|
|
|
merged tree of the common ancestors and uses that as
|
2005-11-06 17:26:07 +01:00
|
|
|
the reference tree for the 3-way merge. This has been
|
|
|
|
reported to result in fewer merge conflicts without
|
|
|
|
causing mis-merges by tests done on actual merge commits
|
|
|
|
taken from Linux 2.6 kernel development history.
|
|
|
|
Additionally this can detect and handle merges involving
|
2005-12-08 23:04:33 +01:00
|
|
|
renames. This is the default merge strategy when
|
|
|
|
pulling or merging one branch.
|
2005-11-06 17:26:07 +01:00
|
|
|
|
|
|
|
octopus::
|
2009-03-25 19:23:42 +01:00
|
|
|
This resolves cases with more than two heads, but refuses to do
|
|
|
|
a complex merge that needs manual resolution. It is
|
2005-11-06 17:26:07 +01:00
|
|
|
primarily meant to be used for bundling topic branch
|
|
|
|
heads together. This is the default merge strategy when
|
2009-03-25 19:23:42 +01:00
|
|
|
pulling or merging more than one branch.
|
2005-11-06 17:26:07 +01:00
|
|
|
|
|
|
|
ours::
|
2009-11-15 19:25:30 +01:00
|
|
|
This resolves any number of heads, but the resulting tree of the
|
|
|
|
merge is always that of the current branch head, effectively
|
|
|
|
ignoring all changes from all other branches. It is meant to
|
2005-11-06 17:26:07 +01:00
|
|
|
be used to supersede old development history of side
|
|
|
|
branches.
|
2008-03-18 13:26:43 +01:00
|
|
|
|
|
|
|
subtree::
|
|
|
|
This is a modified recursive strategy. When merging trees A and
|
|
|
|
B, if B corresponds to a subtree of A, B is first adjusted to
|
|
|
|
match the tree structure of A, instead of reading the trees at
|
|
|
|
the same level. This adjustment is also done to the common
|
|
|
|
ancestor tree.
|