This is the mail archive of the
mailing list for the glibc project.
Re: [RFC] ChangeLog generation script
- From: "H.J. Lu" <hjl dot tools at gmail dot com>
- To: Zack Weinberg <zackw at panix dot com>
- Cc: Paul Eggert <eggert at cs dot ucla dot edu>, Florian Weimer <fweimer at redhat dot com>, Andreas Schwab <schwab at suse dot de>, "szabolcs.nagy" <Szabolcs dot Nagy at arm dot com>, nd <nd at arm dot com>, "Joseph S. Myers" <joseph at codesourcery dot com>, Siddhesh Poyarekar <siddhesh at gotplt dot org>, GNU C Library <libc-alpha at sourceware dot org>, "Carlos O'Donell" <carlos at redhat dot com>, Adhemerval Zanella <adhemerval dot zanella at linaro dot org>
- Date: Sat, 24 Nov 2018 08:09:22 -0800
- Subject: Re: [RFC] ChangeLog generation script
- References: <email@example.com> <alpine.DEB.firstname.lastname@example.org> <email@example.com> <alpine.DEB.firstname.lastname@example.org> <email@example.com> <alpine.DEB.firstname.lastname@example.org> <email@example.com> <firstname.lastname@example.org> <email@example.com> <firstname.lastname@example.org> <email@example.com> <firstname.lastname@example.org> <CAKCAbMiRyHJxC_anrPvaUkTJVLda_BquduBxr9uJnKB=QzG+Qg@mail.gmail.com> <email@example.com> <CAKCAbMjTwxwMvLYYCDH4ta4sFNsGsYb=2X0qgy0Jafsnd2Tf6g@mail.gmail.com>
On Sat, Nov 24, 2018 at 7:44 AM Zack Weinberg <firstname.lastname@example.org> wrote:
> On Sat, Nov 24, 2018 at 3:10 AM Paul Eggert <email@example.com> 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).
Same here. Writing ChangeLog helps me better understand my changes.
I always include my ChangeLog in my commit messages, for glibc, GCC
and binutils. It will be nice to have a script to generate a ChangeLog template
so that I can fill in the gaps.