From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Engster Newsgroups: gmane.emacs.devel Subject: Re: Generating the ChangeLog files from the commit messages Date: Fri, 21 Nov 2014 18:21:06 +0100 Message-ID: <87ppcgsc59.fsf@engster.org> References: <21606.10799.112099.788101@a1i15.kph.uni-mainz.de> <1753218.Ot8JCqssfN@descartes> <546AABCF.8030705@cs.ucla.edu> <9xioico2nm.fsf@fencepost.gnu.org> <87zjbntvfz.fsf@bzg.ath.cx> <87k32rta32.fsf@engster.org> <87a93mu7mo.fsf@engster.org> <83egsw50rr.fsf@gnu.org> <87tx1ssezx.fsf@engster.org> <83h9xstrqx.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1416590515 28387 80.91.229.3 (21 Nov 2014 17:21:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 21 Nov 2014 17:21:55 +0000 (UTC) Cc: bzg@gnu.org, monnier@IRO.UMontreal.CA, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 21 18:21:49 2014 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 1Xrrtz-00080z-AG for ged-emacs-devel@m.gmane.org; Fri, 21 Nov 2014 18:21:47 +0100 Original-Received: from localhost ([::1]:41783 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xrrty-0002QH-M3 for ged-emacs-devel@m.gmane.org; Fri, 21 Nov 2014 12:21:46 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58866) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xrrtp-0002Pn-Rs for emacs-devel@gnu.org; Fri, 21 Nov 2014 12:21:44 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XrrtP-0001Zi-LA for emacs-devel@gnu.org; Fri, 21 Nov 2014 12:21:37 -0500 Original-Received: from randomsample.de ([5.45.97.173]:49739) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrrtP-0001ZP-Az; Fri, 21 Nov 2014 12:21:11 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=randomsample.de; s=a; h=Content-Type:MIME-Version:Message-ID:Date:References:In-Reply-To:Subject:Cc:To:From; bh=eKAmpLyj+SM2lPoWVxIcYctfpxeICYcEmURa4ff1MEs=; b=T1Pz0528zvNPJ4XsmamkF8symQqmQL78aPYroXCLwHV+tpvH+/pmn8Hr/55RvdrZ8rrYiCuKMFRf3L3sczIckq4vpcZoQs4cdxmjp43LI593ZQZ45U4Lu7iWedsYLTl+; Original-Received: from ip4d154d80.dynamic.kabel-deutschland.de ([77.21.77.128] helo=spaten) by randomsample.de with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from ) id 1XrrtN-0001X1-7f; Fri, 21 Nov 2014 18:21:09 +0100 In-Reply-To: <83h9xstrqx.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 21 Nov 2014 18:58:46 +0200") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.91 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 5.45.97.173 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:177957 Archived-At: Eli Zaretskii writes: >> From: David Engster >> Cc: monnier@IRO.UMontreal.CA, bzg@gnu.org, emacs-devel@gnu.org >> Date: Fri, 21 Nov 2014 17:19:30 +0100 >> >> Just go through the log and in your mind strip all the generated >> stuff (like filenames and affected symbols), and see what >> information provided by the *author* actually remains - it's usually >> very little, and often stating the obvious, instead of saying *why* >> something was done. > > That's not what ChangeLog is supposed to tell. We're in violent agreement here. >> This makes our commit logs mostly useless for actually understanding how >> code evolved. > > It's not intended for that. The 'annotate' commands are for that. Yes. As I've written: we should improve the output of 'l' in an annotated file from the Emacs repo: commit logs should tell why something was done. Anyway, I'm repeating myself, let's just disagree and drop this. It's not like this is gonna change anytime soon. -David