From: Junio C Hamano <gitster@pobox.com>
Date: Sat, 21 Feb 2026 06:02:21 GMT
Subject: Re: [RFC PATCH] format-patch: better commit list for cover letter
Message-ID: <xmqqcy1ytz0y.fsf@gitster.g>
In-Reply-To: <xmqqh5ratzc6.fsf@gitster.g>

Junio C Hamano <gitster@pobox.com> writes:

>> Maybe the "--cover-letter" option can take an argument like
>> "--cover-letter=<shortlog | commitlist>". ...
>
> Just off the top of my head...
>
> Perhaps with
>
>     [format]
> 	commitListFormat ;# true
>
> we use
>
> 	[1/1] format-patch: better commit list for cover letter
>
> and with
>
>     [format]
> 	commitListFormat="%s (%an)"
>
> we use
>
> 	[1/1] format-patch: better commit list for cover letter	(Mirko Faina)
>
> instead.  IOW, the value of the configuration variable is used as
> the format argument "log --format=...", and appended to the fixed
> [n/m] that gives the numbers.
>
> Without format.commitListFormat defined, or when it is defined to
> false, we'd use the traditional "shortlog" format.
>
> Hmm?

And the corresponding command line option can look like

	--cover-letter=(shortlog | log:<log format spec>)

e.g.,

	--cover-letter=log:"%s (%an)"

to override configured value per invocation basis.