From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Is it time to drop ChangeLogs? Date: Wed, 09 Mar 2016 22:06:50 +0200 Message-ID: <83a8m7o1ph.fsf@gnu.org> References: <64a52598-ad53-498c-993c-67d7827dbdfc@default> <838u1uuuau.fsf@gnu.org> <878u1um2xl.fsf@thinkpad.rath.org> <87fuw090k7.fsf@wanadoo.es> <83y49spuxt.fsf@gnu.org> <87pov4achc.fsf@acer.localhost.com> <20160308213635.GE6269@acm.fritz.box> <87pov3cur7.fsf@acer.localhost.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1457554027 16448 80.91.229.3 (9 Mar 2016 20:07:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 9 Mar 2016 20:07:07 +0000 (UTC) Cc: emacs-devel@gnu.org To: Ingo Lohmar Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Mar 09 21:07:00 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1adkNl-00021I-Un for ged-emacs-devel@m.gmane.org; Wed, 09 Mar 2016 21:06:58 +0100 Original-Received: from localhost ([::1]:43942 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adkNl-0003j1-9t for ged-emacs-devel@m.gmane.org; Wed, 09 Mar 2016 15:06:57 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35769) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adkNV-0003ii-RS for emacs-devel@gnu.org; Wed, 09 Mar 2016 15:06:42 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1adkNS-0004xO-Lc for emacs-devel@gnu.org; Wed, 09 Mar 2016 15:06:41 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:45896) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adkNS-0004xD-Hs; Wed, 09 Mar 2016 15:06:38 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4244 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1adkNR-0001ss-Rc; Wed, 09 Mar 2016 15:06:38 -0500 In-reply-to: <87pov3cur7.fsf@acer.localhost.com> (message from Ingo Lohmar on Wed, 09 Mar 2016 20:32:28 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:201312 Archived-At: > From: Ingo Lohmar > Date: Wed, 09 Mar 2016 20:32:28 +0100 > > > If a git log message starts off life unreliable (i.e. there are mistakes > > in it) it can never be corrected. It stays unreliable for the lifetime > > of the repository. > > That's pretty much what I meant. It may not contain the information you > (and I) would like to see in it, but it is highly reliable in that it is > the message that was used to describe the commit. Yeah, it's a reliable lie. How helpful is that? > > I am an experienced Emacs contributor, and I have, even recently, made > > mistakes in my commit messages. I resent the fact that it is so > > difficult to correct them, even before pushing to savannah. I don't > > think I need any teaching on the importance of good commit messages. > > I make a lot of mistakes in commit messages, and I do not agree that it > is difficult to fix them before pushing. Indeed, it isn't difficult. But since mistakes do get pushed, I guess people are not careful enough to review their commits before pushing, or else we wouldn't be having this conversation, and there would be no need for the procedures to correct pushed commits with mistaken log messages. > You surely don't need any teaching about commit messages, but Eli > has repeatedly referred to those who do, and I try to counter the > argument that Changelog fixing teaches them a *good* lesson. Telling the wrongdoer to clean up their mess surely does teach them a lesson. It could well be the lesson we both agree is the best one: review your commits before pushing. I hope you agree that NOT fixing the mistakes teaches them an entirely different lesson, the one we think is undesirable: that mistakes don't matter, and eventually that the log messages don't matter, as long as they say _something_. > > Not everybody has access to the git repository, and not everybody who > > has is capable of using it effectively. ChangeLogs remain a useful, > > easy to use summary of Emacs's progress. > > I cannot speak for anybody but myself. When I am a user of Emacs, > trying to get an idea of what has changed on the level of detail that > the Changelog provides, I would rather go to the authoritative source, > if online (without any repository) at > http://git.savannah.gnu.org/cgit/emacs.git. I guess you never had to work in segregated networks, where access to the outside world is not available.