From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Commit header lines (was: git history tracking across renames (and emacs support)) Date: Sat, 14 Jul 2018 09:58:50 +0300 Message-ID: <83pnzqb8wl.fsf@gnu.org> References: <87a7yn7tqp.fsf@lifelogs.com> <878te75xa1.fsf@lifelogs.com> <87ind6l2tt.fsf@lifelogs.com> <877etklvsa.fsf@lifelogs.com> <83y3m0pv8u.fsf@gnu.org> <86608msw0h.fsf@dod.no> <838tdiet25.fsf@gnu.org> <87y3li4vh7.fsf@telefonica.net> <87efnan46u.fsf@linux-m68k.org> <86wp12qtgo.fsf@dod.no> <83tvw6chqv.fsf@gnu.org> <86shbprix7.fsf_-_@dod.no> <838t6jgl1k.fsf@gnu.org> <601m6cc6.fsf@lifelogs.com> <83o9fefnv9.fsf@gnu.org> <83d0vtfx4f.fsf@gnu.org> <83o9fce4np.fsf@gnu.org> <8336wneemw.fsf@gnu.org> <907edf27-ed0c-5166-88ea-c3db9d9d7f74@cs.ucla.edu> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1531551451 9217 195.159.176.226 (14 Jul 2018 06:57:31 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 14 Jul 2018 06:57:31 +0000 (UTC) Cc: eggert@cs.ucla.edu, emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jul 14 08:57:27 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1feEUg-0002J3-TK for ged-emacs-devel@m.gmane.org; Sat, 14 Jul 2018 08:57:27 +0200 Original-Received: from localhost ([::1]:40358 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feEWo-00038S-2Y for ged-emacs-devel@m.gmane.org; Sat, 14 Jul 2018 02:59:38 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feEWA-00038B-MC for emacs-devel@gnu.org; Sat, 14 Jul 2018 02:59:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1feEW7-0006a7-0x for emacs-devel@gnu.org; Sat, 14 Jul 2018 02:58:58 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:39096) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feEW6-0006a0-TQ; Sat, 14 Jul 2018 02:58:54 -0400 Original-Received: from [176.228.60.248] (port=1759 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1feEVz-0005of-CC; Sat, 14 Jul 2018 02:58:47 -0400 In-reply-to: (message from Richard Stallman on Fri, 13 Jul 2018 19:11:26 -0400) 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.21 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" Xref: news.gmane.org gmane.emacs.devel:227387 Archived-At: > From: Richard Stallman > Date: Fri, 13 Jul 2018 19:11:26 -0400 > Cc: larsi@gnus.org, eliz@gnu.org, radon.neon@gmail.com, tzz@lifelogs.com, > emacs-devel@gnu.org > > > The two I found less useful were > > "Unbreak bootstrap" (a motivation for the change, but not enough > > description) and "Fix Bug#32107" (likewise). It'd be helpful for us to > > encourage people to write commit messages with summary lines that are > > suitable for later readers. > > I agree. Unfortunately, the percent of the "less useful" summary lines I see is significantly larger than 2 in 10. There are header lines that don't add any information to the log message, in many cases they are just the first entry slightly rephrased. In other cases, they say something uninformative like "Minor copyedits SOMEWHERE". And in many/most of those cases I see no better way to phrase the header line that would fit into 65 characters. (Some of those header lines are mine, btw, which means it's already the best wording I could come up with.) Again, it's a minor gripe, and a little price to pay. But let's not forget that a price it is.