From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jonas Bernoulli Newsgroups: gmane.emacs.devel Subject: Re: Regarding outline headings in emacs-lisp libraries Date: Sun, 26 Jul 2020 20:25:37 +0200 Message-ID: <87a6zmkuam.fsf@bernoul.li> References: <875zalolt7.fsf@bernoul.li> <87v9ikmmly.fsf@bernoul.li> <87imeal72x.fsf@bernoul.li> <83k0yqbc2a.fsf@gnu.org> <87d04il1ta.fsf@bernoul.li> <83ft9eb5yw.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="11666"; mail-complaints-to="usenet@ciao.gmane.io" Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jul 26 20:28:45 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 1jzlO9-0002wp-Bk for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Jul 2020 20:28:45 +0200 Original-Received: from localhost ([::1]:54146 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jzlO8-0004UZ-5b for ged-emacs-devel@m.gmane-mx.org; Sun, 26 Jul 2020 14:28:44 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46416) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jzlLD-0003s0-TP for emacs-devel@gnu.org; Sun, 26 Jul 2020 14:25:43 -0400 Original-Received: from mail.hostpark.net ([212.243.197.30]:33276) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jzlLB-0006Yv-Oq; Sun, 26 Jul 2020 14:25:43 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by mail.hostpark.net (Postfix) with ESMTP id 24DBB165E2; Sun, 26 Jul 2020 20:25:38 +0200 (CEST) X-Virus-Scanned: by Hostpark/NetZone Mailprotection at hostpark.net Original-Received: from mail.hostpark.net ([127.0.0.1]) by localhost (mail0.hostpark.net [127.0.0.1]) (amavisd-new, port 10124) with ESMTP id Gy725qCF3820; Sun, 26 Jul 2020 20:25:38 +0200 (CEST) Original-Received: from customer (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mail.hostpark.net (Postfix) with ESMTPSA id E980F165C5; Sun, 26 Jul 2020 20:25:37 +0200 (CEST) In-Reply-To: <83ft9eb5yw.fsf@gnu.org> Received-SPF: none client-ip=212.243.197.30; envelope-from=jonas@bernoul.li; helo=mail.hostpark.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/07/26 14:25:38 X-ACL-Warn: Detected OS = ??? X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:253267 Archived-At: Eli Zaretskii writes: >> From: Jonas Bernoulli >> Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org >> Date: Sun, 26 Jul 2020 17:43:13 +0200 >>=20 >> Eli Zaretskii writes: >>=20 >> > I think I asked a question about the proposed use of the "Code" >> > heading under your proposal, and I'd still like to discuss that issue, >> > because it sounds like that heading will no longer have any role. >>=20 >> Yes you did but I though that this part of what you are replying to >> addressed that: >>=20 >> > The =E2=80=98;;; Code:=E2=80=99 section itself should >> > be used for the =E2=80=98require=E2=80=99 forms and for other such "fr= ont >> > matter". > > That's okay, but we will have to rename it to something else, then. > >> I am also listing a few more things explicitly in my response to Stefan, >> i.e.: >>=20 >> > This section may also contain other >> > things that "have to happen early on" and/or "don't fit anywhere >> > else". For example the definition of `PACKAGE-version' or internal >> > variables and macros that are used early on. >>=20 >> We all have seen plenty of libraries and know the messy bits that tend >> to accumulate at the beginning of their code portion. That's the stuff >> that I would leave inside the "Code:" section. The bits that come >> before the first `defgroup' (if any). > > "Preliminaries"? Sounds like an interesting option, but lets discuss in the sibling thread where the names of both sections are being discussed.