From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id +IESBVRidWOmTgAAbAwnHQ (envelope-from ) for ; Wed, 16 Nov 2022 23:21:08 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id SPcfBVRidWMktwAAauVa8A (envelope-from ) for ; Wed, 16 Nov 2022 23:21:08 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id E0ED812217 for ; Wed, 16 Nov 2022 23:21:07 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ovQm5-0007rG-5M; Wed, 16 Nov 2022 17:20:53 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovQm3-0007qY-0a for emacs-orgmode@gnu.org; Wed, 16 Nov 2022 17:20:51 -0500 Received: from mail-pf1-x430.google.com ([2607:f8b0:4864:20::430]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ovQm1-0002lw-8p; Wed, 16 Nov 2022 17:20:50 -0500 Received: by mail-pf1-x430.google.com with SMTP id y203so18818313pfb.4; Wed, 16 Nov 2022 14:20:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:in-reply-to:date :subject:cc:to:from:user-agent:references:from:to:cc:subject:date :message-id:reply-to; bh=Xn6yn+fNwc4J07Prd7LnHURN1bb8OCAL491CXFxsPPI=; b=EZ8MO8+VkzhP2pc6eaoESNPSrsPHrUwAHIrSKGAUprh7dDOJMdB3XlZzdoK3EUBjCx cI5rtoIHchffuEZXzOwqxyu/eB6F0NrhCSfihnIDuQ0aUPGM+ti9bha4FGgEu7NqDsIl aQSbAnlToYw2BLtz9lsWP0yM7SXxfA2GxrmSkz+XKYO4MIXjxivjBPpSWtq0YvmRL6TY jT5ED6WCeJ8zleB1wzQtzUZ3aCYu94MuHoW0uwfqG57ROBa5AMsmEpkRYqvaFxeEcMIX 4bMKswIkfW8rK+orF9lGmgf3LHk63llmKgkdabx1h5ZaRmZ7YmbAM8Vv5blEYpeLZ2KP UAAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:in-reply-to:date :subject:cc:to:from:user-agent:references:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=Xn6yn+fNwc4J07Prd7LnHURN1bb8OCAL491CXFxsPPI=; b=EjeUa9GHsxojv2UtQGlkugB/ETdzMsNro7SOqTYTNKQE8BWqzEveTBHg8YowukBao4 iPfE9odJKGj6h/LgoP4/bSIiZxTnflcKQADFwdIMdgBbx71QK5immLS8EArwKx877mcX aSC9ANO80N21qWLO+PsVmZTEcc39SfwdceEyHHoGU7+wpWa9QRgxaP50JPGaPneGwI8t UxDezb6GJvaHETehwKCRj2RLe03fnPC+zJAR3uMG+uj+0clG2fnNnD4mqhwA3P3mDBvv 11v+gEj+fnT2Kk3nmdvtTMpOCHhLRARfZxZw1YQ8Y7XGPmK0Jq1xN2NKBdnWiCcJX4cS MkAQ== X-Gm-Message-State: ANoB5pkuNKBe/rCgv+axUGiHvlBrU11cjE4JQH2FH0pWpAp29R7HQlD1 phbFX0euiZBqa6c9cdne93AR7/3natsf1w== X-Google-Smtp-Source: AA0mqf6CPWQsQgRBdWeuIIGd6cacftWuepzRfw4iFvMkSXa00kcDykCplr0JlhhxXd5ST4rl+SAF1A== X-Received: by 2002:aa7:87cd:0:b0:572:c28a:64cd with SMTP id i13-20020aa787cd000000b00572c28a64cdmr30828pfo.68.1668637243082; Wed, 16 Nov 2022 14:20:43 -0800 (PST) Received: from dingbat (220-235-181-183.dyn.iinet.net.au. [220.235.181.183]) by smtp.gmail.com with ESMTPSA id 34-20020a630d62000000b0046feca0883fsm10077959pgn.64.2022.11.16.14.20.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Nov 2022 14:20:42 -0800 (PST) References: <878s1xupey.fsf@gmail.com> <87wn7z730z.fsf@localhost> User-agent: mu4e 1.9.2; emacs 29.0.50 From: Tim Cross To: Ihor Radchenko Cc: =?utf-8?Q?Andr=C3=A9_A=2E_Gomes?= , Bastien , Timothy , emacs-orgmode@gnu.org Subject: Re: [RFC] Re: Headings and Headlines Date: Thu, 17 Nov 2022 09:16:51 +1100 In-reply-to: <87wn7z730z.fsf@localhost> Message-ID: <861qq2czih.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::430; envelope-from=theophilusx@gmail.com; helo=mail-pf1-x430.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1668637267; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=Xn6yn+fNwc4J07Prd7LnHURN1bb8OCAL491CXFxsPPI=; b=tU2ddlT3OtbxKyxSK9MmFJaKFhObw3X00CXdOYuyz7ib2goMEO0bovZPfGfu8nvQuWIt/R 2TNXW7WTbva7o0S7AcbQ6qUBYDAAw6TkCIoQWY0upwFMagcipYZA1rLyYY+dbzJyKvY6th eNYjCS1IAMQTetv9us1NAdpxR15jX7ZIlCEUEVirhx4VY2hZ4f94cL74E3sqx4j9JgMJ6v 5v7++acAM/CGwPjDW8nlcQWfj96q2h+E2aleXnB243vpoUWifwF2RvWGOJwEN6F0hNMpZS Fx7eQLwJU27Bw+Lw3eFlyjIXMlWJJ9H8y8ubg3tFzBgijPZcTSxE/Pl3La7I/w== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1668637267; a=rsa-sha256; cv=none; b=dGdhbt1jwkao/H+nyrTzaoEg0io9s1iJY7TErbD4Lr9tINHw1ar114oB2xGl5LYyNyk3gt bgJzhdXJVxuwZtE8kSQgqq1cTe8oIdcdYJsbVhXoPaHtokR9ilZ8KjiV1sw6iH/VVPcG7S bhmbexPck30UHsYw8DoruwTiDIVOSTnK1LBgjluxstOheTQboCImXJxYiAERPPGctNLtqy LP9ypfq9URNTg3I55Ut8XMOAbcZcfirBYQ2qMxCJDM2tMl6irqK0qco2DjLgnMoYg9wLvs jRku6ILrzRSLllOWeFGMJVegz5euSVJXYVnZc8GkwPnNb+ppi6bopXTieuDslw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=EZ8MO8+V; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.83 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=EZ8MO8+V; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: E0ED812217 X-Spam-Score: -3.83 X-Migadu-Scanner: scn0.migadu.com X-TUID: RBjZVqWrpH+2 Ihor Radchenko writes: > Andr=C3=A9 A. Gomes writes: > >> The project's documentation refers to headings and headlines as >> synonyms. Relying on a single definition would be beneficial. If I had >> to choose between the two, I'd go with heading. > > I've been looking into changing all the instances of "headline" to > "heading" and I ran into a serious issue: We use `headline' _symbol_ in > multiple places in the code. > > Most importantly, org-element.el uses element type `headline' to parse > headings. We cannot easily change this symbol for backwards > compatibility reasons. > > I'm afraid that a complete switch to use "heading" everywhere consistently > is not possible without backwards-incompatible change. I know for sure > that changing `headline' element to `heading' element type will break > important packages like org-roam. And there is no good way to work > around this. We cannot make symbol aliases in Elisp in scenarios like > (memq (org-element-type ...) '(headline inlinetask)). > > I came to the conclusion that it will, in fact, be easier to change all > things to use "headline" -- all the instances of "heading" in Org code > are in function names, variable names, and docstrings. All can be > changed using obsolete aliases. > > On the other hand, overwhelming feedback in this thread is the > opposite -- change "headline" to "heading". > > Maybe others have better ideas how to deal with `headline' symbol issue? I think consistency is the highest priority. Most people preferred heading, but that was based on the assumption adopting one or the other was of roughly equal complexity. Given we cannot change headline to heading without introducing backwards and external compatibility issues, I would favour just changing to headline and documenting what deadline defines/means.