This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Rant about ChangeLog entries and commit messages
- From: kenner at vlsi1 dot ultra dot nyu dot edu (Richard Kenner)
- To: dnovillo at google dot com
- Cc: dannyb at google dot com, gcc at gcc dot gnu dot org, sam at rfc1149 dot net
- Date: Mon, 03 Dec 2007 12:36:50 EST
- Subject: Re: Rant about ChangeLog entries and commit messages
- References: <2007-12-02-11-05-39+trackit+sam@rfc1149.net> <47543DE8.3010003@google.com>
> I'm not sure people will want to drop ChangeLogs anytime soon. I don't
> find them all that useful, but I *have* used them extensively when doing
> archeology. It gives you the initial thread to pull when finding out
> about changes.
>
> What I *do* miss a lot is a an easier way to link from the ChangeLog
> entry into the email message explaining the whys and hows of a change.
> In this respect, the comment in the code is not enough. The comment
> explains what the code does today, it does not (and should not) explain
> the history of that piece of code. Otherwise, comments would soon grow
> to useless proportions.
I agree completely with all of that.