From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cJohJJmzGWFiQwEAgWs5BA (envelope-from ) for ; Mon, 16 Aug 2021 02:38:49 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id iHbrH5mzGWF9fQAA1q6Kng (envelope-from ) for ; Mon, 16 Aug 2021 00:38:49 +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 DFFF5C032 for ; Mon, 16 Aug 2021 02:38:48 +0200 (CEST) Received: from localhost ([::1]:44834 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mFQeN-0006ZC-Rz for larch@yhetil.org; Sun, 15 Aug 2021 20:38:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:45466) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFQdo-0006XB-5B for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 20:38:12 -0400 Received: from ciao.gmane.io ([116.202.254.214]:60110) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFQdm-0002Lu-P3 for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 20:38:11 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1mFQdk-0004MI-PG for emacs-orgmode@gnu.org; Mon, 16 Aug 2021 02:38:08 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: emacs-orgmode@gnu.org From: Jim Porter Subject: Re: [PATCH] Rename headline to heading Date: Sun, 15 Aug 2021 17:38:04 -0700 Message-ID: References: <871r786qfe.fsf@gmail.com> <87v947wr7s.fsf@gmail.com> <877dgmi89p.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit In-Reply-To: <877dgmi89p.fsf@gmail.com> Content-Language: en-US Received-SPF: pass client-ip=116.202.254.214; envelope-from=geo-emacs-orgmode@m.gmane-mx.org; helo=ciao.gmane.io X-Spam_score_int: 5 X-Spam_score: 0.5 X-Spam_bar: / X-Spam_report: (0.5 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, FORGED_GMAIL_RCVD=1, FREEMAIL_FORGED_FROMDOMAIN=0.248, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, NML_ADSP_CUSTOM_MED=0.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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: , 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=1629074329; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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=jArng0PiRiOpFvf2VoYJZ1ZXVpgBrPyNt1WPcBJ7gdg=; b=kXMBKRgPeg6CLt9q8yvgrC6NXw9aM4Lhu5vDKWUGqZNE+3g7Q9YWFvfAzQ5YTEw/a+Jngj zbSSETLuVkh+Xi64OjPCZLjwas+5Df9y0N6YbyzcUlfKAo1rBHsO/CE0LbV5mzGuFZRODy cKW57xkCHUt/mEdLBZWJ96f02KP6WafBbQAJQx7T8i15OuElbz3eM17xAPNGhCC7XySVQ9 Y66l9RaRMUKzXZMJAzh4oqA7jJPwL9XM7XjVAbWbki5n+faBgRt7m3Gk2tuQRJK4cunLD2 6zSNM8i6+B2vFKddn8mbjPIk+JXO0vx0AbG6j/A+b7I7vcoKAoAuOmO7kUCzMw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1629074329; a=rsa-sha256; cv=none; b=kBPonVbEa7nmo2RC2kFCnXYixcaCMsisUWlcuUhOrJQ1SeQlcQQ4dFUNL2jOm52+ZBGKMe J6nruO5KEnb+H72nUn9Xaqb0oxv1PztPm0bTK3KS9heoTI65SRo0lq1PNqnEfu9XlS4dZz rB0bHhhz0/pT9e1x1SEiraU0mvX5QeBT+tyxU/qI3a4a6p/kP/wfEPGcq3vVw9FxMsddNP 7usO65oNrfhMWS/1ZM+DXxki8AgEWGePP87n1j8cnsRKh7cHO5KFGFG+3gJTQHC4nHiQAp Mudi6ftF/L8hF7yQmjO1c0jeVcwdr7XiWLh5gw/xmlwaihqaQLf46bq3+1whAw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=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.81 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=fail reason="SPF not aligned (relaxed), No valid DKIM" header.from=gmail.com (policy=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-Queue-Id: DFFF5C032 X-Spam-Score: -1.81 X-Migadu-Scanner: scn1.migadu.com X-TUID: 9haTxbm/BDC6 On 8/15/2021 4:17 PM, Tim Cross wrote: > At some point, your transition period will end. If it isn't with the > transition to v9.5, it will be the transition to 9.6. At this point, all > of the issues you point out will still exist. There will still be people > who are running multiple versions, there will still be people who failed > to read or comprehend the impact of the change. All that the transition > does is delay the pain point while adding additional complexity to the > code base. Admittedly, in this case, the additional complexity is very > small. I think it does more than *just* delaying the pain. It's true that the transition period will end, and any users who haven't updated their configs by then will have a broken config. However, some percentage of users will upgrade Org, see the warning, fix their configs (perhaps not immediately, but in the next few weeks), and continue on with minimal pain. Of course, I'm sure most users would make the necessary change even without a transition period, but the transition period gives users a bit more flexibility in determining when to update their configs. In any case, if Org were to add an informative message about this change, `org-capture-upgrade-templates' seems to me a reasonable place to do it since it's already doing this for other obsolete types. In fact, looking at the commit history, that function was added in Feb 2017 (in commit 0f1b5ec496), so perhaps it's been long enough that the old datetree migration could be removed entirely and be replaced with this new headline -> heading migration. That would have the net effect of *reducing* the total amount of compatibility code. That said, this isn't a critical issue for me either way. I keep Emacs and Org pretty up to date so I shouldn't have a problem when the time comes to make this change in my config. - Jim