From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id MLI6BhyWcGPMbwAAbAwnHQ (envelope-from ) for ; Sun, 13 Nov 2022 08:00:44 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id uN8MBhyWcGPXSgAAauVa8A (envelope-from ) for ; Sun, 13 Nov 2022 08:00:44 +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 9D20CEAB8 for ; Sun, 13 Nov 2022 08:00:43 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ou6xg-0002e2-5a; Sun, 13 Nov 2022 01:59:24 -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 1ou6xd-0002dm-QA for emacs-orgmode@gnu.org; Sun, 13 Nov 2022 01:59:21 -0500 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ou6xb-0006uj-M1 for emacs-orgmode@gnu.org; Sun, 13 Nov 2022 01:59:21 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 989CE240027 for ; Sun, 13 Nov 2022 07:59:17 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1668322757; bh=JrE/S513wScfQrsqsfhN7+4nyh/IbV+5TxmwFVxTZSo=; h=From:To:Cc:Subject:Date:From; b=rufFtQ/aQ0VZJlhpiGrbbfQd1qDlN11Kunrd3e7EGJJWev4Z6uyq4NBlofkrMQ7Aa ckc5T2AAhQByqF6sy8703ScPzPPjCeo0VGxMbdMnCwZPmLcoyHwX4ct2BVRAq8Xgmj qqCo1RIQ/7Re0VXn0Po46v0tEgvfaknsVeveNarB9cDM/K9euOZJPvVosbuqDITknr HxXinOG38OkCTjo1YsY4PYh+1R0gVpBezH8pnQqmVZizWhwwjHu7kV2luwwVPzKFiF PC341XrC3rTdnE03HYGF/Ns5s9s5/dZBVgcfEq19dtvX0cX03eHeKZj9QA8OSALeV7 4JzdnQPn+KJBw== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4N93Fv0V2Qz9rxG; Sun, 13 Nov 2022 07:59:14 +0100 (CET) From: Ihor Radchenko To: =?utf-8?Q?Andr=C3=A9_A=2E_Gomes?= , Bastien , Timothy Cc: emacs-orgmode@gnu.org Subject: [RFC] Re: Headings and Headlines In-Reply-To: <878s1xupey.fsf@gmail.com> References: <878s1xupey.fsf@gmail.com> Date: Sun, 13 Nov 2022 06:59:56 +0000 Message-ID: <87wn7z730z.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de 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, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=unavailable 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=1668322843; 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=3kFKRVtKEAEvTKOzGlFDLfMndc8yydTTzCpBtm7jmCo=; b=EbSf+HjycCE11lZDByRjsiULe/Hwo3Zo92qcmBut0j4uxqU5B+Qicx9t1Jl1lLJ/ISPiJc M00UpsSFYIHGX8vJNWYxhgcvfSEXtJFpOCKeKLsfmrIoZ+iyRN1BhH7P5yw7HhIMDw2nT7 trqNP/7EDe4diBg5AlkQ5rZF28guVVBn6aWrE5N4tJE92tkepZdorjuE/EnbVzfh2sSDQf RSiJz6JtQClQKTIbl61Yd7t6gpQo01IGtGRKZz79CLgpZ5XpbZZ19tBf2NX452HR2ED0o0 V3m6eeXV5wi9qG20ctHOdTs6N5URkGrk0PH+lSou120U/F7vVrM+dPApjxmBgQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1668322843; a=rsa-sha256; cv=none; b=k1N1ZcknRlHRGUdqBbgJnB2Fzw6nD4/zErPf2VMhcNUGxDFXX7ovsjTbYSlr+VVZHooWez ttHQph/sH4Ey/t52olASMzK1Whh4wN4bIHcQbP1Gba5YThhGbvUxOpp/bVNjTQTwl2K3Ex G41WFLYIhNUtNMw13bi7MaecXM6BTLiex8usoukzLKSzAEgAN5NiFuK+go78kRSkr+mCHD n0gt5TuBNDz8u/uAuhi9rNcSA/GJ1R0sRN3H09IhaPPgPO4ATmqnR8Wgc92/0ZgNP3Wo9l 8bDM4NPWb0IPAmzslbJdssuQ1euT3judtSoj0yjoW+58bj0aWRhCyvtPwOJWeg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b="rufFtQ/a"; dmarc=pass (policy=none) header.from=posteo.net; 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: -2.04 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b="rufFtQ/a"; dmarc=pass (policy=none) header.from=posteo.net; 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: 9D20CEAB8 X-Spam-Score: -2.04 X-Migadu-Scanner: scn1.migadu.com X-TUID: crI3WGcbLtOz 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? --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at