From 2d16d4aec41af66e92bdc070828b8708ffb87ba7 Mon Sep 17 00:00:00 2001 From: Wilfred Hughes Date: Thu, 30 Dec 2021 09:39:00 -0800 Subject: [PATCH] Clarify comment prefix/suffix matching --- manual/src/tricky_cases.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/manual/src/tricky_cases.md b/manual/src/tricky_cases.md index de5fe606b..c08026292 100644 --- a/manual/src/tricky_cases.md +++ b/manual/src/tricky_cases.md @@ -159,7 +159,7 @@ line-based diffs. Line-diffs struggle if there are a small number of common lines. The more precise, granular behaviour of tree diffs makes this problem much more common though. -## Similar Comments +## Matching Substrings In Comments ``` // Before @@ -171,9 +171,9 @@ foobar(); foobaz(); ``` -`foobar` and `foobaz` are completely different, and should never be -matched up. For comments, we'd rather match up comments that are -textually similar. +`foobar` and `foobaz` are completely different, and their common +prefix `fooba` should not be matched up. However, matching common +prefixes or suffixes for comments is desirable. ## Multiline Comments