Skip to content

Commit ef8fa51

Browse files
newrenderrickstolee
authored andcommitted
merge-strategies.txt: add coverage of the ort merge strategy
Signed-off-by: Elijah Newren <[email protected]>
1 parent 656e23c commit ef8fa51

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

Documentation/merge-strategies.txt

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,20 @@ subtree[=<path>];;
9595
is prefixed (or stripped from the beginning) to make the shape of
9696
two trees to match.
9797

98+
ort::
99+
This is meant as a drop-in replacement for the `recursive`
100+
algorithm (as reflected in its acronym -- "Ostensibly
101+
Recursive's Twin"), and will likely replace it in the future.
102+
It fixes corner cases that the `recursive` strategy handles
103+
suboptimally, and is significantly faster in large
104+
repositories -- especially when many renames are involved.
105+
+
106+
The `ort` strategy takes all the same options as `recursive`.
107+
However, it ignores three of those options: `no-renames`,
108+
`patience` and `diff-algorithm`. It always runs with rename
109+
detection (it handles it much faster than `recursive` does), and
110+
it specifically uses `diff-algorithm=histogram`.
111+
98112
resolve::
99113
This can only resolve two heads (i.e. the current branch
100114
and another branch you pulled from) using a 3-way merge

0 commit comments

Comments
 (0)