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

From: Eric Sunshine <sunshine@sunshineco.com>
Date: Jul 11, 2021, 04:54 UTC
Message-ID: <CAPig+cTFoLaUd8+VRsaJuP24C7fnbTTFx0i7PizyasES7K2jdg@mail.gmail.com>
In-Reply-To: <ee0969429cba837ba6d79712706c899d5b231798.1625964399.git.gitgitgadget@gmail.com>

On Sat, Jul 10, 2021 at 8:46 PM Elijah Newren via GitGitGadget <gitgitgadget@gmail.com> wrote:

Show 15 quoted lines

> 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 <newren@gmail.com>
> ---
> 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 (`+`).