From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: Your commit 7409a79 Date: Mon, 08 Dec 2014 10:24:33 -0800 Organization: UCLA Computer Science Department Message-ID: <5485ECE1.8040002@cs.ucla.edu> References: <83h9x917il.fsf@gnu.org> <85k324h0hg.fsf@stephe-leake.org> <83k324yv44.fsf@gnu.org> <85tx17dqzy.fsf@stephe-leake.org> <54850587.4080006@cs.ucla.edu> <83tx16xhf6.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1418063119 12895 80.91.229.3 (8 Dec 2014 18:25:19 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Dec 2014 18:25:19 +0000 (UTC) Cc: stephen_leake@stephe-leake.org, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 08 19:25:12 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 1Xy2zf-0004vu-BL for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 19:25:11 +0100 Original-Received: from localhost ([::1]:35423 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy2ze-0006EF-T6 for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 13:25:10 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47388) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy2zM-0006E6-4d for emacs-devel@gnu.org; Mon, 08 Dec 2014 13:24:57 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xy2zG-0001Mf-7H for emacs-devel@gnu.org; Mon, 08 Dec 2014 13:24:52 -0500 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:60685) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy2z9-0001Lm-JP; Mon, 08 Dec 2014 13:24:39 -0500 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id E835AA6002B; Mon, 8 Dec 2014 10:24:38 -0800 (PST) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Original-Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Hd1LMmkLnmpk; Mon, 8 Dec 2014 10:24:34 -0800 (PST) Original-Received: from penguin.cs.ucla.edu (Penguin.CS.UCLA.EDU [131.179.64.200]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id 25195A6001F; Mon, 8 Dec 2014 10:24:34 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.3.0 In-Reply-To: <83tx16xhf6.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 131.179.128.62 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:179435 Archived-At: On 12/08/2014 07:58 AM, Eli Zaretskii wrote: >> 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. Although explanations don't always need to be in the summary, for something this small (where the entire commit message can fit into one line) it's better to do it that way. The summary in Stephen Leake's draft commit message was "http://something-or-another; no other changes to help the git rename". That is less helpful than "Rename ChangeLogs to prep for gitlog-to-changelog" (see, it fits 50 characters!).