From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: File names in ChangeLog entries Date: Thu, 02 Dec 2021 16:09:20 -0500 Message-ID: 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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="669"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: Juri Linkov , kfogel@red-bean.com, stefan@marxist.se, emacs-devel@gnu.org, ttn@gnuvola.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 02 22:10:35 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 1mstLe-000AUt-Le for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 22:10:34 +0100 Original-Received: from localhost ([::1]:46136 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mstLc-0002L0-MF for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 16:10:32 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49064) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mstKb-0001Zm-Es for emacs-devel@gnu.org; Thu, 02 Dec 2021 16:09:29 -0500 Original-Received: from mailscanner.iro.umontreal.ca ([132.204.25.50]:17822) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mstKY-0000MV-39; Thu, 02 Dec 2021 16:09:28 -0500 Original-Received: from pmg2.iro.umontreal.ca (localhost.localdomain [127.0.0.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 239348067C; Thu, 2 Dec 2021 16:09:23 -0500 (EST) Original-Received: from mail01.iro.umontreal.ca (unknown [172.31.2.1]) by pmg2.iro.umontreal.ca (Proxmox) with ESMTP id 14D12804EC; Thu, 2 Dec 2021 16:09:21 -0500 (EST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=iro.umontreal.ca; s=mail; t=1638479361; bh=oiMWp6Ry6rq34toJUWKga3+VfFk45zkaDs3yi/FQTQk=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=gJAAHacRG7s7406mdWhWBncianELJqcCGUEj1TsF1GGdbejKwwrDCMWW8fD7H8afH 7kQmWz2LL/uc0QdC7+h+WxDAru3Il1ij15u3ORyR/O2OVqTB5c9LEQt6j1jz9ZIB5E L/4hDZLa3qfeeuUzMrUwt6p9hHB94UvTTCJfKJ0Lvqg6wYoOlFaZpEpkWtLc1seiFK jiZoYXrjkfBUZ0RQN7y2jqykmlYZSDEw9E63iIZxZZ2kLji+/MGWmpIGieIxjIUwEz VQwtJG1LFV4JRvsP+X3bywrgmkNK7/W6HanfdEipEIk0e7RSVjAlD1ZZdGqO+Ko4fl b1OGmFU21LOrg== Original-Received: from alfajor (lechon.iro.umontreal.ca [132.204.27.242]) by mail01.iro.umontreal.ca (Postfix) with ESMTPSA id 02F1F1204BA; Thu, 2 Dec 2021 16:09:21 -0500 (EST) 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=132.204.25.50; envelope-from=monnier@iro.umontreal.ca; helo=mailscanner.iro.umontreal.ca X-Spam_score_int: -42 X-Spam_score: -4.3 X-Spam_bar: ---- X-Spam_report: (-4.3 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=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:280786 Archived-At: >> > * [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. I guess that begs the question: what do you think is the role of the Summary, IOW how is it intended/expected to be used? In my own experience, there are two main cases where I've made use of them: - When listing a chain of commits for a particular change. Usually the "particular change" already makes it clear which parts of the code will likely be affected, so having subsystem information there is not super important, admittedly. Instead, I read the summaries as a kind of "roadmap" for how the change is decomposed into a number of steps. Since we're usually talking about a handful of commits, the specific shape and content of those summaries doesn't matter very much (they just need to include enough info that I know which commit is which). - When listing a number of commits that were applied to a branch like `master` or `emacs-28`, typically for code review, but other times to look for changes relevant to some problem I'm experiencing or some specific code I'm playing with. In that case, having subsystem information in the summary makes a world of difference in that I can much more easily skip changes which are "obviously" irrelevant. I wonder how you use them. Stefan