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 aIkCFs+mGWEZMQEAgWs5BA (envelope-from ) for ; Mon, 16 Aug 2021 01:44:15 +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 ALDKEc+mGWHnWAAA1q6Kng (envelope-from ) for ; Sun, 15 Aug 2021 23:44:15 +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 A7805BF42 for ; Mon, 16 Aug 2021 01:44:14 +0200 (CEST) Received: from localhost ([::1]:33164 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mFPnZ-0003um-O6 for larch@yhetil.org; Sun, 15 Aug 2021 19:44:13 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:39754) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mFPn1-0003u8-6I for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 19:43:39 -0400 Received: from mail-pj1-x102a.google.com ([2607:f8b0:4864:20::102a]:51067) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mFPmz-0008AV-J3 for emacs-orgmode@gnu.org; Sun, 15 Aug 2021 19:43:38 -0400 Received: by mail-pj1-x102a.google.com with SMTP id bo18so23867990pjb.0 for ; Sun, 15 Aug 2021 16:43:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:subject:date:in-reply-to:message-id :mime-version; bh=mQLrZgtwG+7gec/jEJrK4c46KcakilFXrUY2kpizhqs=; b=iqJB6QTvdGx59XaPpfhIJUzy0E8RQfENRKqKRTlFiEbnK/h4vIMRu/RWpPufnJAIZ/ 2ZRp9gmrifj1kIgYYkW1jmP21o1RD6HpcpGdaqeDIkUx6nr+MqP2fLSu3804u70Km25x d4QC4dbCG7NZGx4kRyLnoYxCm7o/VdPx3PMbIiH0QsHvinfxZN0jAAKGOy6aEnlD93vr o9WaQfeWmxdMGd5y6F2mUwAC2QrPqO2RjL2sLstpbLgoL4A00nDmbvBzFJ3rDlSdFs7O 4ESqNrZHm0czyli9cCY7/J3ATRemzWUBm8Eepoq8nidZfDe7gEGdRczuUbELlfbZOTUo Mlrg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:subject:date :in-reply-to:message-id:mime-version; bh=mQLrZgtwG+7gec/jEJrK4c46KcakilFXrUY2kpizhqs=; b=PTJhu4uGrG/v6MVhOXJ2wPwPhBTF+SPjd7HRjJWI9RN5qTX4zjdoi5YtKCKz7acH3s g+f75yAYAdo6+In9sVJL566AFasWzLktBU7mmCcMYcmKXx4IEVX/5hc0TdcvYeTEeKVG Niai25FMOUH/urGRHk4htn5wg4+nZNP5IOI9n4WdpyhpWPp9XR4auL/ShgDvmke9DSJL Ekc+9v46TYHIzWCuqBDYKmrygBoakO1Fmmf7/Wb8jUHCisQwcsn7FKi0wMWJvxUfA1sA plWbU8ysdkJRzd24Een+gy9q68oPH5ttJKaisMkLNIOiilYWh/D9YNKc8/sLlKXxSeZc cKrw== X-Gm-Message-State: AOAM533TJ6yeptsWjDMuSewgZibgnYVEA1BSykid2i7OtIj6I0V2fKzy uJxTKHFWLGYCAqIOTV0CaERxA5+fc4o= X-Google-Smtp-Source: ABdhPJzfwy72nP8tAvBSg1gPnECRyLZnu7iubVou4vVYdmNgrs5NfdFnue9svBi68O8xjNLx3sn9PQ== X-Received: by 2002:a17:902:eb46:b029:12d:1a3b:5721 with SMTP id i6-20020a170902eb46b029012d1a3b5721mr11021025pli.82.1629071014439; Sun, 15 Aug 2021 16:43:34 -0700 (PDT) Received: from tim-desktop (106-69-95-133.dyn.iinet.net.au. [106.69.95.133]) by smtp.gmail.com with ESMTPSA id x73sm9551333pfc.98.2021.08.15.16.43.33 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Aug 2021 16:43:34 -0700 (PDT) References: <871r786qfe.fsf@gmail.com> <87v947wr7s.fsf@gmail.com> User-agent: mu4e 1.6.3; emacs 28.0.50 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: [PATCH] Rename headline to heading Date: Mon, 16 Aug 2021 09:17:00 +1000 In-reply-to: Message-ID: <877dgmi89p.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::102a; envelope-from=theophilusx@gmail.com; helo=mail-pj1-x102a.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.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=1629071054; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=mQLrZgtwG+7gec/jEJrK4c46KcakilFXrUY2kpizhqs=; b=BwsgfiSysSgbvRJ8eSiCvRP4fIUZ1wh44BE8BcqBsDiMfbSf105b/SNDCKO5HoZdBe82kJ fnvh6ZPdgGYklWuP+DDWAUAgkBn2jvSRSMczAQY/tjWO30uq27g4+V7bk/hd4I8+JTrjuG fj3V9yfGSXOsuXY/+C1uSp+GtxbuCw8tV3uAgXlQbVdLuOH9o/xxocfxhvGsGNwZ1eEiMi sPqRbrER+x9GnUzUbVD7bI0mGQ7uznMDf9YoikRgqbuWm8izHUGa74UgI2P4BQg1bS3wsh qQELeMwgk4upztAeOMbLqLrk/vcdLfF1/jwKqjFk6QyHQRVHTwk2lRVTfQwnPw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1629071054; a=rsa-sha256; cv=none; b=R1r3yoTTh5yiXGnSd6vd4SHd/FP/1JcNfcpCmEH9rv3CVcMlG5Hp5rJAFb9zh3WJS+zqTA 2qX75t1RkXXN2uED1/NCY/R5EisadT2O+LVrqV13FICB6Yw/E9eXTm1Tq14JN4JojwNckg +jdXisYdLqxAa+mlAZFOI6/rYnNLlqoK9YBU7nei6KbP7qxwbpTrI/4+ntscEMitNRn9Ko 6bn9IPmry6ESgB5Jd8HwNl1b/eGA6CBgXqFXXB4Yx3+nMsDB3ysVPwM5AqKdmr6QNOItw7 9EovLMG/9k+4lWi6pjrY6tQ/UFS456euNvpcfWGgs18kUos78JncptI5kWqAdA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=iqJB6QTv; dmarc=pass (policy=none) header.from=gmail.com; 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: -3.11 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=iqJB6QTv; dmarc=pass (policy=none) header.from=gmail.com; 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: A7805BF42 X-Spam-Score: -3.11 X-Migadu-Scanner: scn1.migadu.com X-TUID: NzN7i4wxoBIF Jim Porter writes: > 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. > While I understand the intent here, I think it is a false sense of helpfulness. 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 would certainly agree that we should try to make the error message as informative as possible. However, that should be a general aim anyway and if the error messages are not sufficiently informative, they should be improved. Poor error messages are frequently a greater source of frustration than unexpected change. Today I have been fighting with a javascript library where the error message literally just says "Failure" - absolutely pointless error message which adds nothing. In fact, it would be better if there was no error handler and it just crashed with a stacktrace. This is a change in the transition to a new major version. I think users should be prepared for breaking changes when upgrading to a new major version. If it was a minor version change, a transition would be mandatory. . A transition period also delays the goal for this change i.e. to improve consistency in terminology and concepts.