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

From: Robert Dewar <dewar at adacore dot com>
To: Eric Botcazou <ebotcazou at libertysurf dot fr>
Cc: Bernd Schmidt <bernds_cb1 at t-online dot de>, gcc at gcc dot gnu dot org, Richard Kenner <kenner at vlsi1 dot ultra dot nyu dot edu>, schwab at suse dot de, sam at rfc1149 dot net
Date: Sun, 02 Dec 2007 18:29:17 -0500
Subject: Re: Rant about ChangeLog entries and commit messages
References: <2007-12-02-11-05-39+trackit+sam@rfc1149.net> <10712021228.AA23790@vlsi1.ultra.nyu.edu> <4752A817.7000206@t-online.de> <200712021405.16103.ebotcazou@libertysurf.fr>

Eric Botcazou wrote:

FWIW, I agree completely - I've never found ChangeLogs useful, I hate writing them, and I think the linux-kernel guys these days generally have much better checkin messages than we do.
I guess nobody really loves writing ChangeLog entries, but in my opinion there are quite effective "executive summaries" for the patches and helpful to the reader/reviewer. Please let's not throw the baby with the bath's water.


Right, but to me an important part of the "executive summary" is why you
did it. You don't go to the boss and say "I fired Joe", you go and say
"I fired Joe, because ..."

References:
- Rant about ChangeLog entries and commit messages
  - From: Samuel Tardieu
- Re: Rant about ChangeLog entries and commit messages
  - From: Richard Kenner
- Re: Rant about ChangeLog entries and commit messages
  - From: Bernd Schmidt
- Re: Rant about ChangeLog entries and commit messages
  - From: Eric Botcazou

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