Re: [PATCH 2/3] doc: document the special handling of -l0

On Sat, Jul 10, 2021 at 9:54 PM Eric Sunshine [off-list ref] wrote:

On Sat, Jul 10, 2021 at 8:46 PM Elijah Newren via GitGitGadget
[off-list ref] wrote:

quoted

As noted in commit 89973554b52c (diffcore-rename: make diff-tree -l0
mean -l<large>, 2017-11-29), -l0 has had a magical special "large"
historical value associated with it.  Document this value, particularly
since it is not large enough for some uses -- see commit 9f7e4bfa3b6d
(diff: remove silent clamp of renameLimit, 2017-11-13).

Signed-off-by: Elijah Newren <redacted>
---

diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt

@@ -595,6 +595,9 @@ of a delete/create pair.
        specified number.  Defaults to diff.renameLimit, or if that is
        also unspecified, to 400.

+       Note that for backward compatibility reasons, a value of 0 is treated
+       the same as if 32767 was passed.

To get this to format properly, you'll need to drop the indentation
from the new paragraph and replace the blank line preceding it with a
line containing just a plus (`+`).

Ok, will do.  Thanks.