From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: File names in ChangeLog entries Date: Thu, 02 Dec 2021 12:08:37 +0200 Message-ID: <83k0gnpbdm.fsf@gnu.org> 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> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33664"; mail-complaints-to="usenet@ciao.gmane.io" Cc: kfogel@red-bean.com, stefan@marxist.se, monnier@iro.umontreal.ca, ttn@gnuvola.org, emacs-devel@gnu.org To: Juri Linkov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Dec 02 11:12:38 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 1msj4v-0008bb-NQ for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 11:12:37 +0100 Original-Received: from localhost ([::1]:45838 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1msj4u-0000Lz-KI for ged-emacs-devel@m.gmane-mx.org; Thu, 02 Dec 2021 05:12:36 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:57992) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msj1J-0004Mf-I7 for emacs-devel@gnu.org; Thu, 02 Dec 2021 05:08:54 -0500 Original-Received: from [2001:470:142:3::e] (port=37398 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msj1I-0002bj-6W; Thu, 02 Dec 2021 05:08:52 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=eEbCvHYMD9MbBCW/Shus1dVd3WGqElTcMj227M8DlfQ=; b=k9jwwfz5O8Ft dgsC+pbASTeLuiwPjf5E1eT6CVHvW2fAFFKHeok/hg6xvqd89CeYNxvB3LU4zVW6M/el6db/q7YHh ZDb3UgRgkMqC7MmUuaitnlM+mzOgtjoi5FnX6b2CUkm8OjxpaEa8HsnBkta0rYd5L4g8bEPnoTbWe 1ChPu62uczjW4Sdjl0Z9d4zQgRzYtCY34ocePcOjVwBAQXkNs7p9dOgMpmXkrW/ZptgkZO5a7Fm8b iTlTYfpk7YFoGSH3H6pyvn/MdcAsn0iLieMam3oyS9T4AFufhE8TzCH4WnjPUZq49r/VfOGqh7cPK VMl8GE/w02WaaumzALkZCg==; Original-Received: from [87.69.77.57] (port=4542 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msj1H-00024i-Ui; Thu, 02 Dec 2021 05:08:52 -0500 In-Reply-To: <86pmqfmkuy.fsf@mail.linkov.net> (message from Juri Linkov on Thu, 02 Dec 2021 11:12:05 +0200) 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:280741 Archived-At: > 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.