This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC 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: Rant about ChangeLog entries and commit messages


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.


Nick


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