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: Your commit 7409a79 Date: Mon, 08 Dec 2014 17:58:05 +0200 Message-ID: <83tx16xhf6.fsf@gnu.org> References: <83h9x917il.fsf@gnu.org> <85k324h0hg.fsf@stephe-leake.org> <83k324yv44.fsf@gnu.org> <85tx17dqzy.fsf@stephe-leake.org> <54850587.4080006@cs.ucla.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1418054328 15327 80.91.229.3 (8 Dec 2014 15:58:48 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Dec 2014 15:58:48 +0000 (UTC) Cc: stephen_leake@stephe-leake.org, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 08 16:58:35 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 1Xy0hi-0004E8-PI for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 16:58:30 +0100 Original-Received: from localhost ([::1]:34677 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy0hi-0006Ge-Ev for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 10:58:30 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38029) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy0hZ-0006FN-Uk for emacs-devel@gnu.org; Mon, 08 Dec 2014 10:58:27 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xy0hU-0006rC-36 for emacs-devel@gnu.org; Mon, 08 Dec 2014 10:58:21 -0500 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:46288) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy0hT-0006r4-Rn for emacs-devel@gnu.org; Mon, 08 Dec 2014 10:58:16 -0500 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NG900N00T9WN300@mtaout25.012.net.il> for emacs-devel@gnu.org; Mon, 08 Dec 2014 17:53:58 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG900IWHTHYK250@mtaout25.012.net.il>; Mon, 08 Dec 2014 17:53:58 +0200 (IST) In-reply-to: <54850587.4080006@cs.ucla.edu> 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.181 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:179402 Archived-At: > Date: Sun, 07 Dec 2014 17:57:27 -0800 > From: Paul Eggert > > Stephen Leake wrote: > > Now I realize the commit message should have been: > > http:/; no other changes to help the git rename > heuristic > > When a commit merely renames files, wouldn't it be better for the subject line to explain the underlying reason for the change? Something like this, perhaps: "Rename old ChangeLog files to prepare for gitlog-to-changelog." That would be easier to follow than some URL. Any URL could be placed in later lines in the commit message. I see no reason for the explanation to be in the summary. If you look at the existing summary lines, you will see that they always say what was done, but not why. At least one reason for that is that including the explanation will most likely violate the "one line of less than 80 characters" rule.