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: Wed, 01 Dec 2021 19:02:23 +0200 Message-ID: <835ys8s1gg.fsf@gnu.org> References: <831r2xt32t.fsf@gnu.org> <83ilw8sa9j.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="16666"; mail-complaints-to="usenet@ciao.gmane.io" Cc: stefan@marxist.se, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 01 18:09:30 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 1msT6o-00047h-4z for ged-emacs-devel@m.gmane-mx.org; Wed, 01 Dec 2021 18:09:30 +0100 Original-Received: from localhost ([::1]:54318 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1msT6n-0002hX-4j for ged-emacs-devel@m.gmane-mx.org; Wed, 01 Dec 2021 12:09:29 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:48446) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1msT0D-0002B5-I4 for emacs-devel@gnu.org; Wed, 01 Dec 2021 12:02:42 -0500 Original-Received: from [2001:470:142:3::e] (port=58486 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 1msT0C-0001TU-Jm; Wed, 01 Dec 2021 12:02:40 -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=8DTIxO13GSwO7gbzLtc4fkJ9tV7nA7Sn1j/X/j7mANs=; b=iD5wEZKI9jKP WFHxcs/kZn2De9kuptKgDqpC7dRCGAuPhLrFj8GzdnmQTjKkSF1TDvIVbSym2xvDuW7qiTJhkC+HG WBssK7LkSxkChr5oL5tfe4AP19+raMHzJIpyHND+DvrBqV81Go+Ms7/GII9MMOJxQEyQTXz0o31cE Im9nMA1aMIz1KyY+xCCF3c2LeYTqlm/rndRV0Ga/y/rTFGO5UOIK6jknpnHagruuMk61337k8tars nhA8idQRaEfQEPJGaF9vqSyZ2S2Sf4ulZOKKTwvi5aOpVjQBw0M8NNzkwkiI/QlnPhSvr4CqataEV +ov5rhJlUCYOvIiVZ7XCTA==; Original-Received: from [87.69.77.57] (port=4765 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 1msT0C-0000dy-Ai; Wed, 01 Dec 2021 12:02:40 -0500 In-Reply-To: (message from Stefan Monnier on Wed, 01 Dec 2021 11:51:56 -0500) 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:280648 Archived-At: > From: Stefan Monnier > Cc: stefan@marxist.se, emacs-devel@gnu.org > Date: Wed, 01 Dec 2021 11:51:56 -0500 > > Eli Zaretskii [2021-12-01 15:52:08] wrote: > >> From: Stefan Monnier > >> Cc: stefan@marxist.se, emacs-devel@gnu.org > >> Date: Wed, 01 Dec 2021 08:39:06 -0500 > >> > >> Which can degenerate to: > >> > >> * filename (func): Short description > >> > >> Explanation or rest of the description. > > > > Please don't degenerate like that. > > You want > > * filename (func): Short description > > * filename (func): description. > > instead? No, I want the standard: Summary description * file1 (func1): Description of change in func1. * file2 (func2): Description of change in func2. > What about > > * filename (func): Short description > > Explanation > > should I rewrite it to: > > * filename (func): Short description > > Explanation > > * filename (func): Short description. > > ? No. I don't understand why you insist on putting the file/function part on the first (a.k.a. "header") line. The header line is supposed to be a summary, so that the likes of git log --pretty='format:%h %cd %an %s' work as expected.