This is the mail archive of the
mailing list for the GCC project.
Re: Rant about ChangeLog entries and commit messages
- From: Nicholas Nethercote <njn at csse dot unimelb dot edu dot au>
- To: Andi Kleen <andi at firstfloor dot org>
- Cc: gcc at gcc dot gnu dot org
- Date: Tue, 4 Dec 2007 15:01:56 +1100 (EST)
- Subject: Re: Rant about ChangeLog entries and commit messages
- References: <firstname.lastname@example.org> <email@example.com> <Pine.GSO.firstname.lastname@example.org> <email@example.com>
On Mon, 3 Dec 2007, Andi Kleen wrote:
Commit logs are basically invisible;
That's just a (fixable) problem in your coding setup. In other
projects it is very common to use tools like cvs annotate / cvsps /
git blame / git log / etc. to find the reasons for why code is the way
it is. In fact in several editors these can be functions on hot
keys. Programming is hard enough as is without ignoring such valuable
information sources. Don't do it.
I didn't say you cannot or should not use these tools. But a good comment
on a piece of code sure beats a good commit message, which must be looked at
separately, and can be fragmented over multiple commits, etc.