From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cKabOWxPGGF5awAAgWs5BA (envelope-from ) for ; Sun, 15 Aug 2021 01:19:08 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id OCkANWxPGGHSewAAbx9fmQ (envelope-from ) for ; Sat, 14 Aug 2021 23:19:08 +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 00AE5188B4 for ; Sun, 15 Aug 2021 01:19:08 +0200 (CEST) Received: from localhost ([::1]:42976 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mF2vi-00027d-At for larch@yhetil.org; Sat, 14 Aug 2021 19:19:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51820) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mF2v2-00027T-RL for emacs-orgmode@gnu.org; Sat, 14 Aug 2021 19:18:24 -0400 Received: from mail-pj1-x102c.google.com ([2607:f8b0:4864:20::102c]:37521) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mF2uz-00008c-QB for emacs-orgmode@gnu.org; Sat, 14 Aug 2021 19:18:24 -0400 Received: by mail-pj1-x102c.google.com with SMTP id cp15-20020a17090afb8fb029017891959dcbso26491520pjb.2 for ; Sat, 14 Aug 2021 16:18:20 -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:content-transfer-encoding; bh=yrLfVqhl7biG3cOhFU3uQj67HSLmZy+H2Z6ovfsRRnI=; b=L2SMuKwdHhR75/xRYi5z59qQQiEEWBL04AYi2ODyjiD9vEvythWWnozGxoxmOpXXyG ynhXNpu5X5Zdr2fKnZMbB5DT4pa9uBybBnoHXPpIsmcdibusjh19pxqca5T2vTuc9awX BMXvu9Ug8cNEMkkvdnbLK7UxWMekzckS9rsTUTuqjmGLLpbc6bP82mCbr5E35RQ6F4Yu KKW3udCdcbPXBfC/sYRETNgPhHZt659arG+bGCsWtDe5knjwOa4Q2FCQuYd3npGUkQi0 BUgAVdzBlHr4fGmqAFT8p1WfVmoZ+TqgP23hZITxv12HhAhxjusi+HLkThButTtI9K3r Y7xw== 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:content-transfer-encoding; bh=yrLfVqhl7biG3cOhFU3uQj67HSLmZy+H2Z6ovfsRRnI=; b=Q+YOiUR90jUy8zl2GUTKdk2J4LUYAX8XD5fa4E64B3stqzPYB4hUVP/QBb2Y3tA5MR 8he1QJgyzCgbkWM5YQX99os0rXQ0mDEMunf0rzBh21nqvVH6TH7P9swE6FfVgkNqNINN IH4gkZuE16g6fnEz2IVRyybEGAvO8rUTEBMsasuA1pOouts4VlCZ2i+imCarJc4SttXJ u7ZpvULjGs3vp08j/+xXYwF1+i67kGUOTf5EJoOs13++iaB1yGyOZTOGzoxTz5EVmrZZ TqTVGpo5an7KYefEERAy9JNeJjy4Fvm9IPUyTgt5Yu0BJ605LsjZ4ZumQ3UL1oFzr3xq D2hw== X-Gm-Message-State: AOAM5315mTOMrtpCQumwHHoiZYMJR0Vv/ndrOpMgrKxNg66x4xFQQUjG UFuwzHcxYBWsz4T8oFhidivg7bTYUT4= X-Google-Smtp-Source: ABdhPJz4hzxbsP94+dRnS5NMw+/XCG2UOlcM83SYnWWiS8TB088mubIVQXABOYjA2st4Ggx/AXS5oA== X-Received: by 2002:a17:902:7885:b029:12c:437a:95eb with SMTP id q5-20020a1709027885b029012c437a95ebmr7307035pll.80.1628983099068; Sat, 14 Aug 2021 16:18:19 -0700 (PDT) Received: from tim-desktop (106-69-114-139.dyn.iinet.net.au. [106.69.114.139]) by smtp.gmail.com with ESMTPSA id g3sm8023817pgj.66.2021.08.14.16.18.17 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 14 Aug 2021 16:18:18 -0700 (PDT) References: <871r786qfe.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: Sun, 15 Aug 2021 08:54:40 +1000 In-reply-to: Message-ID: <87v947wr7s.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=2607:f8b0:4864:20::102c; envelope-from=theophilusx@gmail.com; helo=mail-pj1-x102c.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=1628983148; 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:dkim-signature; bh=yrLfVqhl7biG3cOhFU3uQj67HSLmZy+H2Z6ovfsRRnI=; b=sOBMlKcNqGA+89KGsgLsJz+bqVNCa3x8KRrwi8vFQ8U8rTKxSlLRJw3BE1TNTNGV7ZmeDA fEvMce8L03WQHrmPe7iZSQje4D2Kb07oEXIE/+tuLjJrDXtnhP0+tlLbDid4TepCl7T9gS oVru+P9GYi9NnisO0kpiN6lg299NQ+qeU6qoch4n0VVcPEc5PwKb/XVwL0w9OQgFwTML+4 jxvsgy3J1q2CT8qVJ8EVZo2jHrirIjx+BoCLnyJ1HFAkLHnIrzbH4D/OKNercK5YLF3SA1 MIS+0iNp4LiWv+cnLrME5Rixwc4nvlBec3++hKx/lHIeFdulrqyJs7Lt3RHccA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1628983148; a=rsa-sha256; cv=none; b=SIFLVlp8NQRaj25N1998mzLlQWSYHWNn5snVyTGAPTRasoJt8uZlzaENLQxK9SMJWMlvBg 5aztr+2ztht1mn+kkuHziOhLWsZ8mKGNIBMu6b00t3LD4pkx52fXpOa1jq0k2wVZp37fr9 53/7cAzzWyhbNREv0CvFqXVfuesbTA+9YAO402D6CLybzZGwQGkwBpPMXfIVw9tdp91QRx NWaDzBOqxf16a8v+1OmGdPhGBVAOrOyqNorEx0s6EbP36MMwaSFyRPzbqRCKwLaAoEf36k lH2ojyOfGkIPOHb++IR/lmimaAkvU6U3JE4mJHy4zWG9OjDrI+NExvhH/S2cTA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=L2SMuKwd; 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=L2SMuKwd; 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: 00AE5188B4 X-Spam-Score: -3.11 X-Migadu-Scanner: scn1.migadu.com X-TUID: 9uf/rKLhaoPA Maxim Nikulin writes: > On 05/08/2021 19:12, Andr=C3=A9 A. Gomes wrote: >> @@ -963,7 +963,7 @@ Store them in the capture property list." >> (org-capture-put-target-region-and-position) >> (goto-char position)) >> (_ (error "Cannot find target ID \"%s\"" id)))) >> - (`(file+headline ,path ,headline) >> + (`(file+heading ,path ,heading) > > I am sorry if is a false alarm. Does it mean that all users having > "file+headline" in their init.el files will have to immediately update > configuration? Shouldn't both variants be supported during transitional p= eriod? > > P.S. https://orgmode.org/worg/dev/org-syntax.html consistently uses "head= line". 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. In this case, a transition period would add complexity to the code that would have to remain in place until the next major release and at that release, anyone who has not updated their templates will have the same breakage anyway. I feel there is a difference between changes in configuration and changes in code. Updating capture templates is trivial. Updating code is often more complex, which is why we have the obsolete mechanism for functions and variables.=20 If we were making this change in a maintenance release, that would be a completely different story and a transition period would definitely be necessary. Users should expect some breakage in configuration when upgrading to a new major version.=20