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: Generating the ChangeLog files from the commit messages Date: Fri, 21 Nov 2014 18:58:46 +0200 Message-ID: <83h9xstrqx.fsf@gnu.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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1416589167 7541 80.91.229.3 (21 Nov 2014 16:59:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 21 Nov 2014 16:59:27 +0000 (UTC) Cc: bzg@gnu.org, monnier@IRO.UMontreal.CA, emacs-devel@gnu.org To: David Engster Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 21 17:59:20 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 1XrrYE-0007qx-AU for ged-emacs-devel@m.gmane.org; Fri, 21 Nov 2014 17:59:18 +0100 Original-Received: from localhost ([::1]:41517 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrrYD-0002Jn-NY for ged-emacs-devel@m.gmane.org; Fri, 21 Nov 2014 11:59:17 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:52802) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrrXs-0002JP-Rl for emacs-devel@gnu.org; Fri, 21 Nov 2014 11:59:02 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XrrXo-0001hX-2f for emacs-devel@gnu.org; Fri, 21 Nov 2014 11:58:56 -0500 Original-Received: from mtaout28.012.net.il ([80.179.55.184]:60877) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XrrXh-0001fI-OB; Fri, 21 Nov 2014 11:58:45 -0500 Original-Received: from conversion-daemon.mtaout28.012.net.il by mtaout28.012.net.il (HyperSendmail v2007.08) id <0NFE00A00EYE0200@mtaout28.012.net.il>; Fri, 21 Nov 2014 18:56:11 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout28.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NFE00615F1M5T40@mtaout28.012.net.il>; Fri, 21 Nov 2014 18:56:11 +0200 (IST) In-reply-to: <87tx1ssezx.fsf@engster.org> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.184 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:177955 Archived-At: > 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. > 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.