From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id a2MpFDE9UGEsfwEAgWs5BA (envelope-from ) for ; Sun, 26 Sep 2021 11:28:17 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id gLNODzE9UGGrdAAA1q6Kng (envelope-from ) for ; Sun, 26 Sep 2021 09:28:17 +0000 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 B34522A157 for ; Sun, 26 Sep 2021 11:28:16 +0200 (CEST) Received: from localhost ([::1]:59430 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mUQSF-0003Og-TU for larch@yhetil.org; Sun, 26 Sep 2021 05:28:15 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54464) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mUQRp-0003OX-Bg for emacs-orgmode@gnu.org; Sun, 26 Sep 2021 05:27:49 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:40326) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mUQRo-0003MT-UU; Sun, 26 Sep 2021 05:27:48 -0400 Received: from [2a01:e34:ec2b:7150:9b07:b8c3:15f:4214] (port=59442 helo=hal) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mUQRn-0004iQ-Nk; Sun, 26 Sep 2021 05:27:48 -0400 Received: by hal (Postfix, from userid 1000) id 931381E041B; Sun, 26 Sep 2021 11:27:45 +0200 (CEST) From: Bastien To: =?utf-8?Q?Andr=C3=A9?= A. Gomes Subject: Re: [PATCH] Rename headline to heading In-Reply-To: <871r786qfe.fsf@gmail.com> (=?utf-8?Q?=22Andr=C3=A9?= A. Gomes"'s message of "Thu, 05 Aug 2021 15:12:37 +0300") Organization: GNU References: <871r786qfe.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Date: Sun, 26 Sep 2021 11:27:45 +0200 Message-ID: <87pmsv4rfy.fsf@bzg.fr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: emacs-orgmode@gnu.org Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632648496; 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; bh=XHdyscckCrmi/bUZexBAFA5xdhYypMzCnv8m60nC950=; b=Cy8ADi3KpZ/fbtBToLavhGuxjfcm4tcd9l9cMmIA8ZCdJtwRn5YnC2tN0cqSn6S/DJvTxG rvTxKA7l3v0LRjt92OSb0XtjGlumQTnwmGGEa42cJcz94RE8etstbldFyPV4e63WsVmV+t 9blYYg0Mphhe82mOFnG7X+SnNAQ8wMXVRrsGwWjEtmxsAMZnVBf+RjyWYwFLz2Zc0mryZk lPLpBlMkfGAqpJ/4yjQO1+N5ScML771fP9/qdHZ9Q8FTXr8Lk0TnfvplfwwZwpXUyhP7FQ LmKxK8JkK+1XBXlSamORT2WMHwHMaJ/f8vy6ACzY6r63W4iFTtAFVIyGobIxnA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632648496; a=rsa-sha256; cv=none; b=DQQyOEkc5Tu3d3lJvJGJQkP1cPH9WYXMBe8E9OECF8YwaKUnZP8foGzisljcXPFInabG0c ++/FcArT4pHLpq6YHUcnJLMrLpe/voF4RPYXNXUwi2QLXgRL0OE/nvQmYzfGc74hqgUVly o1j1B8L6rzIGmV9yStYxA+Iz4ZAKp7HiE7D6B0XitzMisRkD7TtS1WoxCJ9jG1woFexPHr HyiGmukLat5bPmHcNzwGm8bC8X7JKDbvMGplpzbIv+RpMTGIrqbz2JIqVhBXd1ywm1O7RL pcpKEqkXhDueWYv7ufXYGAOpcfrqYFelCD1IKQ2a+yoF/ep8nwZLUfWaiDSSUA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -1.39 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: B34522A157 X-Spam-Score: -1.39 X-Migadu-Scanner: scn0.migadu.com X-TUID: LoQ99mqHP+lf Hi Andr=C3=A9, Andr=C3=A9 A. Gomes writes: > As previously discussed, please find the patch below. I agree this change is a welcome improvement: thanks a lot for working on this patch. I would like to suggest a step by step approach: 1. Updating occurrences in the documentation: manual, guide, docstrings, worg occurences, etc. 2. Updating Org internals without impacting users' configuration (i.e. update the functions and variables name, but don't update the "file+headline" config string.) 3. If the "file+headline" config string is the only part of a config that can be impacted by this change, support both the new and old strings for backward compatibility. We don't need a transition period for the first two changes, and we don't need one either for the third one if we implement the backward compatible solution. We need a transition period if we remove it, but I'm not convinced removing it is really needed now. What do you think? --=20 Bastien