From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: "Alfred M. Szmidt" <ams@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: File names in ChangeLog entries
Date: Wed, 01 Dec 2021 01:11:28 -0500
Message-ID: <E1msIq0-0007S1-HO@fencepost.gnu.org>
References: <CADwFkmnccrJrt_bgMrm6+tEr+xU7_Mg8xR_xopLijeTMPx8f+w@mail.gmail.com>
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="35635"; mail-complaints-to="usenet@ciao.gmane.io"
Cc: emacs-devel@gnu.org
To: Stefan Kangas <stefan@marxist.se>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 01 07:12:54 2021
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
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 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1msIrN-00098p-Nv
	for ged-emacs-devel@m.gmane-mx.org; Wed, 01 Dec 2021 07:12:53 +0100
Original-Received: from localhost ([::1]:55288 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1msIrL-0001DC-1F
	for ged-emacs-devel@m.gmane-mx.org; Wed, 01 Dec 2021 01:12:52 -0500
Original-Received: from eggs.gnu.org ([209.51.188.92]:52264)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <ams@gnu.org>) id 1msIq0-0000ID-Sn
 for emacs-devel@gnu.org; Wed, 01 Dec 2021 01:11:28 -0500
Original-Received: from [2001:470:142:3::e] (port=37222 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 <ams@gnu.org>)
 id 1msIq0-00014o-FO; Wed, 01 Dec 2021 01:11:28 -0500
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From:
 mime-version; bh=wcOsDFRQwmZ1EpdQNpsOE2G9ehfr+0k6C4nsIXuNfIg=; b=Q1LD8Ec3tgph
 xU3ejvvIzBN9CbJYQnZPZ7U5V15XQwpUkiLt83gLhqVtJ7vVqbt1rJrnSW0WRNiexIRZhJxI7yxZY
 ggnse7PqtcGURUWIQtdX8e9fu2XXziXQQhxlaY0XhDbDdMwwJyF3LEeFVDBFG8Ge+kC+Xnp2pVGeO
 R6oXDasiupQ/cyDU1Tsu1nuSbVese383cAYMFwmENcp49qx+O+C0iVylk5JOYGpExXKmujeeH9ekZ
 7xSNtnp2l0Yt+wgp5niGHVAfkauPN26SUihFntcVFd9iBhmd98eVqDIqT+aMmwHwq99cCu40yHx57
 LR23dwuUyITVWMpix3Dfeg==;
Original-Received: from ams by fencepost.gnu.org with local (Exim 4.90_1)
 (envelope-from <ams@gnu.org>)
 id 1msIq0-0007S1-HO; Wed, 01 Dec 2021 01:11:28 -0500
In-Reply-To: <CADwFkmnccrJrt_bgMrm6+tEr+xU7_Mg8xR_xopLijeTMPx8f+w@mail.gmail.com>
 (message from Stefan Kangas on Tue, 30 Nov 2021 11:19:55 -0800)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=subscribe>
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org
Original-Sender: "Emacs-devel"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:280583
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/280583>

   Do not use any of these formats:

       [not the full file name:]

	   * tetris.el: Foo.

This one is correct _if_ there would have been a ChangeLog file in
lisp/play.  If changing the heuristics of how things are figured out
this needs to be considered so that doesn't break.

       [not supported by our tools - patches welcome:]

	   * lisp/play/{tetris,morse}.el: Foo.

This is not a format that is encouraged by the GNU coding standards.
The reason is that it makes it impossible to search the file for
filenames.