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: Regarding outline headings in emacs-lisp libraries Date: Mon, 03 Aug 2020 17:24:54 +0300 Message-ID: <83a6zbbydl.fsf@gnu.org> References: <875zalolt7.fsf@bernoul.li> <87pn8fo3dg.fsf@bernoul.li> <837duiex1f.fsf@gnu.org> <87ime2t6h0.fsf@bernoul.li> <83sgd5aus1.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3961"; mail-complaints-to="usenet@ciao.gmane.io" Cc: jonas@bernoul.li, rms@gnu.org, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Aug 03 16:26:16 2020 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 1k2bPp-0000u0-M8 for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Aug 2020 16:26:13 +0200 Original-Received: from localhost ([::1]:58392 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k2bPo-0003u3-Ov for ged-emacs-devel@m.gmane-mx.org; Mon, 03 Aug 2020 10:26:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37178) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1k2bP1-0003GO-5b for emacs-devel@gnu.org; Mon, 03 Aug 2020 10:25:23 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:42297) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1k2bOz-0003ul-8l; Mon, 03 Aug 2020 10:25:21 -0400 Original-Received: from [176.228.60.248] (port=2625 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1k2bOm-0001Pw-OE; Mon, 03 Aug 2020 10:25:11 -0400 In-Reply-To: (message from Stefan Monnier on Sun, 02 Aug 2020 23:22:01 -0400) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:253411 Archived-At: > From: Stefan Monnier > Cc: Jonas Bernoulli , rms@gnu.org, emacs-devel@gnu.org > Date: Sun, 02 Aug 2020 23:22:01 -0400 > > >> Stefan seems to dislike the idea of doing away with the "Code:" name > >> more strongly than I do. > > And I still don't understand why. > > I have the strong suspicion that renaming all those `;;; Code:` in all > those files *will* lead to regressions, since that convention's been > with us for so many years and followed by such a wide percentage of all > distributed Elisp files, that I expect it's used by several scripts we > don't know about. If we don't know about such scripts, do we really need to assume they exist? And what kind of scripts did you have in mind -- scripts which do what jobs? > And of course, we won't be able to rename them all, since too many of > them aren't under our control anyway. So ";;; Core:" will be with us > for the next 10 years whether we like it or not. How about if we leave "Code:", but just as a heading with absolutely no body, i.e. if we add right after it some more appropriate heading ("Prerequisites:" or somesuch)? Would that be a good compromise? > Now, if the benefit were significant, I wouldn't mind, but AFAICT, the > benefit of renaming is very small (at least, given the alternative names > I've seen proposed so far which all seemed rather bland). It's IMO as significant when compared to the rest of Jonas's proposal.