Re: [PATCH 3/3] format-patch: learn --[no-]range-diff-notes

From: Junio C Hamano <gitster@pobox.com>
Date: Aug 24, 2026, 22:31 UTC
Message-ID: <xmqqjypfp2vl.fsf@gitster.g>
In-Reply-To: <format-patch_learn_--range-diff-notes.c5a@msgid.xyz>

kristofferhaugsbakk@fastmail.com writes:

Show 25 quoted lines

> diff --git a/Documentation/git-format-patch.adoc b/Documentation/git-format-patch.adoc
> index 191f64b77d1..e0ba435dfcf 100644
> --- a/Documentation/git-format-patch.adoc
> +++ b/Documentation/git-format-patch.adoc
> @@ -378,6 +378,23 @@ case is to show comparison with an older iteration of the same
>  topic and the tool should find more correspondence between the two
>  sets of patches.
>  
> +`--range-diff-notes[=<ref>]`::
> +`--no-range-diff-notes`::
> +	Used with `--range-diff`, tweak what notes to display in the
> +	range diff. For example, you can use `--no-range-diff-notes` to
> +	turn off all notes in the range diff. The default behavior is
> +	to display the same notes in the range diff as on the patches
> +	(see `--notes`).
> ++
> +You may want to turn off this notes override after it has been
> +activated. Use this sequence to do that:
> ++
> +----
> +--no-range-diff-notes --range-diff-notes
> +----
> ++
> +Now the range diff is back to displaying the same notes as the patches.
> +

Hmph, this is a bit too complex for me.  When I say

    $ git format-patch --no-notes --range-diff-notes ...

I would expect that individual patches would not get notes, but the range-diff will include them in the comparison. But if --range-diff-notes just falls back to default (i.e., inherit what patches use), would I see the notes used in the range-diff?