From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: master bef1be8: Fixes for "Maintainer:" and related lines Date: Mon, 20 May 2019 08:39:34 -0700 Organization: UCLA Computer Science Department Message-ID: <22fdcee1-39b7-fea0-b68c-73de4167a5c5@cs.ucla.edu> References: <20190520043434.1198.8439@vcs0.savannah.gnu.org> <20190520043437.4F9A82068F@vcs0.savannah.gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------82BFBF0A239AF7526F6733DA" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="238336"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.6.1 Cc: emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon May 20 17:40:28 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hSkOo-000ztM-2P for ged-emacs-devel@m.gmane.org; Mon, 20 May 2019 17:40:26 +0200 Original-Received: from localhost ([127.0.0.1]:37346 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hSkOn-0004EO-40 for ged-emacs-devel@m.gmane.org; Mon, 20 May 2019 11:40:25 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:56172) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hSkO5-0004E3-BZ for emacs-devel@gnu.org; Mon, 20 May 2019 11:39:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hSkO4-00033h-45 for emacs-devel@gnu.org; Mon, 20 May 2019 11:39:41 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:54722) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hSkO3-00033Q-QF; Mon, 20 May 2019 11:39:40 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 8C574161BD0; Mon, 20 May 2019 08:39:38 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id 6DkzGRtWYYF8; Mon, 20 May 2019 08:39:37 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 7B378161BD4; Mon, 20 May 2019 08:39:37 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 8eG0s0UXNRlo; Mon, 20 May 2019 08:39:37 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 603F4160F18; Mon, 20 May 2019 08:39:37 -0700 (PDT) Openpgp: preference=signencrypt Autocrypt: addr=eggert@cs.ucla.edu; prefer-encrypt=mutual; keydata= xsFNBEyAcmQBEADAAyH2xoTu7ppG5D3a8FMZEon74dCvc4+q1XA2J2tBy2pwaTqfhpxxdGA9 Jj50UJ3PD4bSUEgN8tLZ0san47l5XTAFLi2456ciSl5m8sKaHlGdt9XmAAtmXqeZVIYX/UFS 96fDzf4xhEmm/y7LbYEPQdUdxu47xA5KhTYp5bltF3WYDz1Ygd7gx07Auwp7iw7eNvnoDTAl KAl8KYDZzbDNCQGEbpY3efZIvPdeI+FWQN4W+kghy+P6au6PrIIhYraeua7XDdb2LS1en3Ss mE3QjqfRqI/A2ue8JMwsvXe/WK38Ezs6x74iTaqI3AFH6ilAhDqpMnd/msSESNFt76DiO1ZK QMr9amVPknjfPmJISqdhgB1DlEdw34sROf6V8mZw0xfqT6PKE46LcFefzs0kbg4GORf8vjG2 Sf1tk5eU8MBiyN/bZ03bKNjNYMpODDQQwuP84kYLkX2wBxxMAhBxwbDVZudzxDZJ1C2VXujC OJVxq2kljBM9ETYuUGqd75AW2LXrLw6+MuIsHFAYAgRr7+KcwDgBAfwhPBYX34nSSiHlmLC+ KaHLeCLF5ZI2vKm3HEeCTtlOg7xZEONgwzL+fdKo+D6SoC8RRxJKs8a3sVfI4t6CnrQzvJbB n6gxdgCu5i29J1QCYrCYvql2UyFPAK+do99/1jOXT4m2836j1wARAQABzSBQYXVsIEVnZ2Vy dCA8ZWdnZXJ0QGNzLnVjbGEuZWR1PsLBfgQTAQIAKAUCTIByZAIbAwUJEswDAAYLCQgHAwIG FQgCCQoLBBYCAwECH In-Reply-To: Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:236804 Archived-At: This is a multi-part message in MIME format. --------------82BFBF0A239AF7526F6733DA Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable On 5/20/19 7:40 AM, Glenn Morris wrote: > It is long-standing Emacs convention that if there is > no Maintainer header, the Author is the maintainer. See elisp node > "Conventional Headers for Emacs Libraries". I didn't know that. However, that node doesn't match existing practice=20 as it goes on to say, "Some files in Emacs use =E2=80=98FSF=E2=80=99 for = the=20 maintainer.=C2=A0 This means that the original author is no longer=20 responsible for the file, and that it is maintained as part of Emacs"=20 despite the fact that no files in the Emacs source code use "FSF" for=20 the maintainer (either before or after my recent patch). Also, it appears that many (most?) people didn't know about and didn't=20 follow the convention. Not only did the convention not come up in=20 discussion until now, it's quite common to see comment pairs like the=20 following, which are the first five remaining instances of "Maintainer:"=20 lines in Emacs's .el files (sorted by file name): ;; Author: Markus Rost ;; Maintainer: Markus Rost ;; Author: David Ponce ;; Maintainer: David Ponce ;; Author: David Ponce ;; Maintainer: David Ponce ;; Author: Richard Kim ;; Maintainer: Richard Kim ;; Author: Kevin Gallagher ;; Maintainer: Kevin Gallagher and this indicates the authors were following the opposite convention=20 that a file without a listed maintainer is being maintained collectively. All in all I think it'd lessen confusion and simplify maintenance if we=20 used "Maintainer:" for contacting current maintainers who aren't authors=20 and don't normally read bug reports. Something like the attached=20 proposed patch, say? --------------82BFBF0A239AF7526F6733DA Content-Type: text/x-patch; name="0001-Adjust-Maintainer-doc.patch" Content-Disposition: attachment; filename="0001-Adjust-Maintainer-doc.patch" Content-Transfer-Encoding: quoted-printable >From c18d6f7f7c18f5d2ef3a221242146ea2c7acbb5f Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Mon, 20 May 2019 08:35:53 -0700 Subject: [PROPOSED] Adjust Maintainer: doc MIME-Version: 1.0 Content-Type: text/plain; charset=3DUTF-8 Content-Transfer-Encoding: 8bit * doc/lispref/tips.texi (Library Headers): Don=E2=80=99t say that a missing Maintainer: header means the authors are maintainers. --- doc/lispref/tips.texi | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi index d41fe82572..c46e3a0f6c 100644 --- a/doc/lispref/tips.texi +++ b/doc/lispref/tips.texi @@ -1011,11 +1011,9 @@ Library Headers person(s) who currently maintain(s) the file (respond to bug reports, etc.). =20 -If there is no maintainer line, the person(s) in the Author field -is/are presumed to be the maintainers. Some files in Emacs use -@samp{FSF} for the maintainer. This means that the original author is -no longer responsible for the file, and that it is maintained as part -of Emacs. +If there is no maintainer line, nobody in particular (other than +perhaps the authors) has volunteered to maintain the file, or an +ordinary Emacs bug report is a good way to contact the maintainers. =20 @item Created This optional line gives the original creation date of the file, and --=20 2.21.0 --------------82BFBF0A239AF7526F6733DA--