From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Karl Fogel Newsgroups: gmane.emacs.devel Subject: Re: File names in ChangeLog entries Date: Thu, 02 Dec 2021 16:11:36 -0600 Message-ID: <874k7qodwn.fsf@red-bean.com> References: <831r2xt32t.fsf@gnu.org> <83ilw8sa9j.fsf@gnu.org> <835ys8s1gg.fsf@gnu.org> <87czmgruyc.fsf@gnuvola.org> <83h7bsqfxh.fsf@gnu.org> <87wnknpkvc.fsf@red-bean.com> <86pmqfmkuy.fsf@mail.linkov.net> <83k0gnpbdm.fsf@gnu.org> Reply-To: Karl Fogel Mime-Version: 1.0 Content-Type: text/plain; format=flowed Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2553"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: emacs-devel@gnu.org, stefan@marxist.se, monnier@iro.umontreal.ca, ttn@gnuvola.org, Juri Linkov To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 02 23:12:43 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1msuJm-0000Qe-4g for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 23:12:42 +0100 Original-Received: from localhost ([::1]:55086 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1msuJk-0004h6-1w for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 17:12:40 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:34498) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msuJ6-0003zy-Us for emacs-devel@gnu.org; Thu, 02 Dec 2021 17:12:01 -0500 Original-Received: from sanpietro.red-bean.com ([45.79.25.59]:59464) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msuJ4-00088t-Kr; Thu, 02 Dec 2021 17:12:00 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=red-bean.com; s=202005newsp; h=Content-Type:MIME-Version:Message-ID: In-Reply-To:Date:Reply-To:References:Subject:Cc:To:From:Sender: Content-Transfer-Encoding:Content-ID:Content-Description; bh=71fMcLwi1bdvAVmMPNdX5f1vwlZb4mdxGvPuVQq/d24=; t=1638483113; x=1639692713; b=UPoMOjvrSx3/M01B0+AfMFbg4CWtOwaB3o3kH9luuTXrkbUL1Etp70umdxRCaHvi/4B//3u0FnG yEyBD/QWL0MmttY2Q4In0M1+1cWogjbOUJobz4mRgNaCYjEMb2STIg/hZMJJSpzRtaTiEqoBqZJZL hFHKi0uH1EhSY3HBbPQmdQb0p3p3RHULufWbIF77DUIDuVMqMWvrzMThfkmg/D/gQDEQt8jktv8Wj FMB5e/RZ5crCEy/WtfqWPk1GTCqiVip2p3V0T+xQCTnevnbtvrikWfFpTbEoR3oNUMohU4zg82u20 jQGsu9rrLor7cdzVHCNz5EN+6dciwYUR90ag==; Original-Received: from 99-112-125-163.lightspeed.cicril.sbcglobal.net ([99.112.125.163]:60344 helo=floss) by sanpietro.red-bean.com with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1msuIi-007brA-Qt; Thu, 02 Dec 2021 22:11:36 +0000 In-Reply-To: <83k0gnpbdm.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 02 Dec 2021 12:08:37 +0200") Received-SPF: pass client-ip=45.79.25.59; envelope-from=kfogel@red-bean.com; helo=sanpietro.red-bean.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:280793 Archived-At: On 02 Dec 2021, Eli Zaretskii wrote: >> From: Juri Linkov >> Cc: Stefan Kangas , Eli Zaretskii >> , >> emacs-devel@gnu.org, Stefan Monnier >> , >> Thien-Thi Nguyen >> Date: Thu, 02 Dec 2021 11:12:05 +0200 >> >> > * [master~1208] Save position in mark ring before jumping to >> > definition >> >> This is a good example of an unhelpful commit message. >> There is no way to guess it's about lisp/help-mode.el. > >You don't need to guess, you need to look at the rest of the log >message. We cannot realistically require that everything about >the >change will be clear from the summary. Mentioning file names is, >IME, >mostly a waste there, because the file name provides very little >information about the change itself, and takes quite a lot of >space, >so doesn't allow to say enough about the change. Agreed. The point of the summary line is to encapsulate some recognizable core thing about the change. When you're reading over, say, a long vertical list of such summaries, you can quickly recognize ones you already had some awareness of (and this makes branch comparison much easier). We'll never be able to fit *everything* in a summary line, and there's no need to. If one needs further information about that particular change, one can go look at the full message. Best regards, -Karl