From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: git history tracking across renames (and emacs support) Date: Fri, 13 Jul 2018 09:15:55 -0500 Message-ID: <907edf27-ed0c-5166-88ea-c3db9d9d7f74@cs.ucla.edu> 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> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1531491255 1103 195.159.176.226 (13 Jul 2018 14:14:15 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 13 Jul 2018 14:14:15 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 Cc: tzz@lifelogs.com, larsi@gnus.org, emacs-devel@gnu.org To: Eli Zaretskii , Radon Rosborough Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jul 13 16:14:10 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 1fdypm-0000AJ-9N for ged-emacs-devel@m.gmane.org; Fri, 13 Jul 2018 16:14:10 +0200 Original-Received: from localhost ([::1]:37596 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdyrt-0006cn-Ar for ged-emacs-devel@m.gmane.org; Fri, 13 Jul 2018 10:16:21 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58175) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdyrm-0006ak-F8 for emacs-devel@gnu.org; Fri, 13 Jul 2018 10:16:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fdyrl-0002xv-8a for emacs-devel@gnu.org; Fri, 13 Jul 2018 10:16:14 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:40214) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fdyre-0002ri-8J; Fri, 13 Jul 2018 10:16:06 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 53DF41605B0; Fri, 13 Jul 2018 07:16:04 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id WfoQna6jyYiK; Fri, 13 Jul 2018 07:16:03 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 33FED1605B1; Fri, 13 Jul 2018 07:16:03 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id tQ0B2NY5pQUc; Fri, 13 Jul 2018 07:16:03 -0700 (PDT) Original-Received: from [192.168.0.8] (ip72-206-6-38.fv.ks.cox.net [72.206.6.38]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id AB4481605B0; Fri, 13 Jul 2018 07:16:02 -0700 (PDT) In-Reply-To: <8336wneemw.fsf@gnu.org> Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 131.179.128.68 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:227338 Archived-At: On 07/13/2018 03:14 AM, Eli Zaretskii wrote: > I find the summary line to be a nuisance in too many cases. Although the summary line is sometimes a nuisance to write, when done well it is so useful that it's clearly a net win over our old way of doing things. Many Git user interfaces list only the summary lines, and for good reason: they let you quickly scan a list of commits looking for what happened in those commits. Writing a useful summary line is thus a real service to later developers, and is far more helpful than the file, function and variable names that the GNU coding standards currently require in ChangeLogs. The primary UI that we promote on the web lists just summary lines. I just now looked at the most recent ten summary lines in Emacs master, and eight of them seemed useful. 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.