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 20:32:21 +0200 Message-ID: <83pov3o62y.fsf@gnu.org> References: <4hd1rw1ubr.fsf@fencepost.gnu.org> <83vb50wxhv.fsf@gnu.org> <87y49vz4cg.fsf@acer.localhost.com> <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> <83r3fkpb3u.fsf@gnu.org> <83lh5rps0t.fsf@gnu.org> <56E066BD.5050403@cs.ucla.edu> <87lh5rv7kk.fsf@red-bean.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1457548382 20480 80.91.229.3 (9 Mar 2016 18:33:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 9 Mar 2016 18:33:02 +0000 (UTC) Cc: eggert@cs.ucla.edu, johnw@gnu.org, emacs-devel@gnu.org To: Karl Fogel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Mar 09 19:32:49 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 1adiuR-0003vl-56 for ged-emacs-devel@m.gmane.org; Wed, 09 Mar 2016 19:32:35 +0100 Original-Received: from localhost ([::1]:43411 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adiuQ-0004sd-Bt for ged-emacs-devel@m.gmane.org; Wed, 09 Mar 2016 13:32:34 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55759) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adiu8-0004q9-F8 for emacs-devel@gnu.org; Wed, 09 Mar 2016 13:32:22 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1adiu7-00009k-8v for emacs-devel@gnu.org; Wed, 09 Mar 2016 13:32:16 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:43772) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adiu2-00006F-NV; Wed, 09 Mar 2016 13:32:10 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:4001 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1adiu1-0004JV-RK; Wed, 09 Mar 2016 13:32:10 -0500 In-reply-to: <87lh5rv7kk.fsf@red-bean.com> (message from Karl Fogel on Wed, 09 Mar 2016 12:18:19 -0600) 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:201275 Archived-At: > From: Karl Fogel > Cc: Eli Zaretskii , John Wiegley , emacs-devel@gnu.org > Date: Wed, 09 Mar 2016 12:18:19 -0600 > > Paul Eggert writes: > >Yes, the ChangeLog format is useful. I use it myself for commits I > >make to GNU projects (as well as some non-GNU projects, e.g., > >https://github.com/eggert/tz). Perhaps the format could be improved, > >but that should be a different thread. > > > >On 03/09/2016 07:53 AM, Eli Zaretskii wrote: > >> So removing ChangeLog files will be a bad blow to our ability to > >> easily and conveniently research the past, > > > >No, this doesn't follow. If we use ChangeLog formats in commit > >messages, we can still research the past easily and conveniently. > > > >> If we drop the ChangeLog files, there's no way we can explain why we > >> ask for commit log messages in ChangeLog format, so the next logical > >> step is to drop that as well, and we will then lose valuable > >> information. > > > >It's not a logical step at all, and we already have an explanation of > >why we ask for ChangeLog format in CONTRIBUTE. Perhaps the explanation > >can be improved, but that's true no matter what approach we take > >(assuming we continue to prefer ChangeLog format). > > What Paul said. > > The conflation of "ChangeLog-style entries" with "ChangeLog files" has been a persistent anti-pattern in this discussion. It just causes confusion. It would help if we remained clear about the distinction, since the former does not imply the latter. > > This isn't merely a theoretical distinction. I've been writing all my commit messages in the style of a ChangeLog entry for as long as I can remember (not just in this project), and 'git log' shows that other developers have been doing that in this project too. Which is good, since that's exactly what the CONTRIBUTE guidelines currently recommend. Paul omitted an important part of what I said, which of course made the point I was trying to make incoherent. And you are just repeating his omission. And then you claim that others cause confusion, whereas in fact you confuse yourself (and perhaps others) by reading selectively what I and others say. How does this make any sense?