aboutsummaryrefslogtreecommitdiff
path: root/Documentation/diff-config.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2016-12-23 12:32:22 -0800
committerJunio C Hamano <gitster@pobox.com>2016-12-23 12:32:22 -0800
commit3cde4e02ee891bff53bac7f6a7d977f50418a4b5 (patch)
treebe578af45d9afe9d9987e40ab6659fde29f9dcec /Documentation/diff-config.txt
parentbe5a750939c212bc0781ffa04fabcfd2b2bd744e (diff)
downloadgit-3cde4e02ee891bff53bac7f6a7d977f50418a4b5.tar.gz
git-3cde4e02ee891bff53bac7f6a7d977f50418a4b5.tar.xz
diff: retire "compaction" heuristics
When a patch inserts a block of lines, whose last lines are the same as the existing lines that appear before the inserted block, "git diff" can choose any place between these existing lines as the boundary between the pre-context and the added lines (adjusting the end of the inserted block as appropriate) to come up with variants of the same patch, and some variants are easier to read than others. We have been trying to improve the choice of this boundary, and Git 2.11 shipped with an experimental "compaction-heuristic". Since then another attempt to improve the logic further resulted in a new "indent-heuristic" logic. It is agreed that the latter gives better result overall, and the former outlived its usefulness. Retire "compaction", and keep "indent" as an experimental feature. The latter hopefully will be turned on by default in a future release, but that should be done as a separate step. Suggested-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/diff-config.txt')
-rw-r--r--Documentation/diff-config.txt6
1 files changed, 2 insertions, 4 deletions
diff --git a/Documentation/diff-config.txt b/Documentation/diff-config.txt
index 58f4bd6af..d8570f2a7 100644
--- a/Documentation/diff-config.txt
+++ b/Documentation/diff-config.txt
@@ -172,10 +172,8 @@ diff.tool::
include::mergetools-diff.txt[]
diff.indentHeuristic::
-diff.compactionHeuristic::
- Set one of these options to `true` to enable one of two
- experimental heuristics that shift diff hunk boundaries to
- make patches easier to read.
+ Set this option to `true` to enable experimental heuristics
+ that shift diff hunk boundaries to make patches easier to read.
diff.algorithm::
Choose a diff algorithm. The variants are as follows: