This is the mail archive of the mailing list for the glibc project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [RFC] ChangeLog generation script

On 11/24/2018 07:43 AM, Zack Weinberg wrote:
> On Sat, Nov 24, 2018 at 3:10 AM Paul Eggert <> wrote:
>> Zack Weinberg wrote:
>>> I find *writing*
>>> changelog entries by hand to be a valuable discipline.  It forces me
>>> to read every line of the patch I'm about to submit, and I've caught
>>> mistakes dozens of times because of it.
>> That's fine, and you can continue doing that even after we have a script. Other
>> "stop and think twice" techniques work better for me, in the sense that they
>> find mistakes more efficiently than ChangeLog-writing does. (Reading the diff is
>> one of these techniques.) The goal is developing and maintaining the best
>> software we can with the limited resources we have.
> To be clear, I wasn't saying that everyone should do it my way; I was
> only presenting an example of why someone who finds very little use
> for the historical information in the ChangeLog files might still not
> mind writing entries by hand (and therefore wants to concentrate on
> other ways in which ChangeLog maintenance is a pain).

I second the sentiment that writing entity-level ChangeLog entries is
nice due to the forced review it imposes, but there are types of changes
where it can be tedious and not particularly useful.  If it could be
automated, I think the overall situation might be better for everybody.
Making the script available to run before committing, for review, would
be nice, and probably help flesh out issues with the script.

Also, for the record, I've only ever found ChangeLogs useful when
delving through pre-git history, trying to find when a given entity was
first introduced, for example, and even then the results can be hit or miss.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]