Re: File names in ChangeLog entries

[Eli Zaretskii]

> From: Stefan Monnier <monnier@iro.umontreal.ca>
> Cc: stefan@marxist.se,  emacs-devel@gnu.org
> Date: Wed, 01 Dec 2021 11:51:56 -0500
> 
> Eli Zaretskii [2021-12-01 15:52:08] wrote:
> >> From: Stefan Monnier <monnier@iro.umontreal.ca>
> >> Cc: stefan@marxist.se,  emacs-devel@gnu.org
> >> Date: Wed, 01 Dec 2021 08:39:06 -0500
> >> 
> >> Which can degenerate to:
> >> 
> >>     * filename (func): Short description
> >> 
> >>     Explanation or rest of the description.
> >
> > Please don't degenerate like that.
> 
> You want
> 
>     * filename (func): Short description
> 
>     * filename (func): description.
> 
> instead?

No, I want the standard:

  Summary description

  * file1 (func1): Description of change in func1.

  * file2 (func2): Description of change in func2.

> What about
> 
>     * filename (func): Short description
> 
>     Explanation
> 
> should I rewrite it to:
> 
>     * filename (func): Short description
> 
>     Explanation
> 
>     * filename (func): Short description.
> 
> ?

No.  I don't understand why you insist on putting the file/function
part on the first (a.k.a. "header") line.  The header line is supposed
to be a summary, so that the likes of

  git log --pretty='format:%h %cd %an %s'

work as expected.