From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id kGUhOTqWGWENFgEAgWs5BA (envelope-from ) for ; Mon, 16 Aug 2021 00:33:30 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id UMjQNDqWGWGQCAAAB5/wlQ (envelope-from ) for ; Sun, 15 Aug 2021 22:33:30 +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 46588AC46 for ; Mon, 16 Aug 2021 00:33:30 +0200 (CEST) Received: from localhost ([::1]:40994 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mFOh7-0002qy-69 for larch@yhetil.org; Sun, 15 Aug 2021 18:33:29 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:60686) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFOgF-0002oH-Gb for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 18:32:35 -0400 Received: from ciao.gmane.io ([116.202.254.214]:59732) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFOgE-0002du-3H for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 18:32:35 -0400 Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1mFOgB-0004ap-JU for emacs-orgmode@gnu.org; Mon, 16 Aug 2021 00:32:31 +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 15:32:22 -0700 Message-ID: References: <871r786qfe.fsf@gmail.com> <87v947wr7s.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit In-Reply-To: <87v947wr7s.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=1629066810; 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=vLK0b2fazaqnTkSXkbIPtEaf9pJnHmUcwX+80RhNpAQ=; b=V/pn6TEfDb9Z4FS5SuH3gr5ERcobG2bsDmVpwRfyxAjhVjG6y/fwQz3yz3zyXLc8gm+OUS dqosgYngPi0gvgRmdIg6eLCgkzEBK2O5BlsfLofWMnAEFRneDDN8Yt7pwpIAO7KgDVZgLS +bKqrZuZ/ZKxnj0esXYGT5g/YejrtM8QZIxktwASHCPVKJMA63fIO/k0kLttlrgH9QSfIq 0BRvo+VmFPFwQrgzKp1AZwJs4qyi2gi7SNCN1vto2rr0XjlcmbETnHw+3Oi1YYcphMK1If OuSwduex8PaaoW/2JPkBI8hh/Z3A4xHvntsoHdK34YvhYzrYp8kRRG1zh41Jvg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1629066810; a=rsa-sha256; cv=none; b=ZjbqfS/i2LevPiLKgllSAGZqGuqXclkjH68yMNviCK0ZMg3cSvl45ZaWYGGgMyFILrNW26 9C7zfwaNW1u6704xfqkENCuv3YL2GT+q6xiJVuC6dKhMIPxqvdYe1LUxZEvZK4OPFH6xrP O2I/kH2cAobcBAOztFO7e8Ldkajg0vdoEvaviqVG0A2zQfM3LYk08OIdfs6hYWLVsW59Qm uAZL14cQTLvfwFAzIqV9JHI1dsPvpMnUDMmpLWsf3UhaSJH8BqEHAuO2l16HBI0/CmpfYs rZMJc0GU2kAqPhX+CuW9EyMB2S9wS7DXY0q2JS9DHe/lELNNJuj4pnJy4CaUdA== 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: 46588AC46 X-Spam-Score: -1.81 X-Migadu-Scanner: scn1.migadu.com X-TUID: M7Ez17qPNrc/ On 8/14/2021 3:54 PM, Tim Cross wrote: > I'm not convinced a transition period will help in this case. At some > point, users will need to update their capture templates regardless. > Provided this impact is clearly outlined in the NEWS.org file (I think > there should be a specific reference to capture templates added in the > patch to NEWS.org) and provided this change is applied to the next > release only, no transition period is necessary. I think having a transition period would be helpful here. First, this helps to account for users who may run multiple versions of Emacs with the same config. This could happen for a few reasons, such as running on different revisions of a GNU/Linux distribution, or even just because the user is testing out the latest/next version of Emacs. In addition, a transition period makes it easy to inform users about what they need to do to upgrade. Without any compatibility code, the error message (likely) won't be very helpful, whereas even some minimal compatibility code could tell the user what edits to make to their config. While everyone *should* read the manual/NEWS, it's easy to miss things sometimes, and errors like this can be non-obvious, especially if the compatibility issue isn't directly in the user's config, but in some other third-party package. As such, I think it would be nice to have a transition period of at least one Emacs version. Beyond that, I don't see any problems with excising old compatibility code. As you say, users will have to upgrade at *some* point. - Jim