From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id MCaYFpkRq2HvKwEAgWs5BA (envelope-from ) for ; Sat, 04 Dec 2021 07:58:33 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id SJ8zEpkRq2G2SQAAbx9fmQ (envelope-from ) for ; Sat, 04 Dec 2021 06:58:33 +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 0494C2E33E for ; Sat, 4 Dec 2021 07:58:33 +0100 (CET) Received: from localhost ([::1]:60262 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtP0C-0007yc-1q for larch@yhetil.org; Sat, 04 Dec 2021 01:58:32 -0500 Received: from eggs.gnu.org ([209.51.188.92]:44572) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtOxp-0007xF-2x for emacs-orgmode@gnu.org; Sat, 04 Dec 2021 01:56:05 -0500 Received: from [2607:f8b0:4864:20::1029] (port=35741 helo=mail-pj1-x1029.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtOxm-0002pB-6f for emacs-orgmode@gnu.org; Sat, 04 Dec 2021 01:56:04 -0500 Received: by mail-pj1-x1029.google.com with SMTP id j6-20020a17090a588600b001a78a5ce46aso6920928pji.0 for ; Fri, 03 Dec 2021 22:56:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:references:user-agent:in-reply-to :message-id:mime-version; bh=zv/yZln5AST6julkZeK5fIfp4dwW90MLqSXEB54KCTQ=; b=eILbmDNygjSroAHijQZGTsHUKWXJLGvYQu8QAXZ79ZL7olPV1ldTQOLChArkyxp9F+ HheXIcELqOLOTaD9cm0EBJn0NL29cTT/iCbAZDG71tDZrLAonyzr2PNzbO9JAvw+l8Hj 959ETzwnMaVSg7UFl43tUolK41k31oYzsImNvpvT06Xbn+QRpcLst6T2u6J8PGqcbPi0 65BjF21XbPvV9u40iUc2cwrtxeARgwNu0oQqEwTl+2m+PvTosX6JeH6F7Ws8gxhSSVg2 9GL4rE8yai+1op4nd1v0U6FIH/go+DwH0ESZ2ciajhE/7yR/lOydIYIvQ9sIG9r1n+4P W8Hw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:references:user-agent :in-reply-to:message-id:mime-version; bh=zv/yZln5AST6julkZeK5fIfp4dwW90MLqSXEB54KCTQ=; b=tBtJ8hM4i6easHwePlBSuOz1jBkNlaFgmN1H7VaaY9ikDsrZ32mIYQ13Au7izDgVPW 2eC+Qm9nTwGvovXTwbM5wUesmPrWFw7sQgl4Z1geN6390VhTvyN/iytO3jlswM+QOzKi 6Wj7vyPEwm2N6bFjitXOEthdmgT36AryT5a/97UpuDF5dSRTncjGxs+qsU1TFxC9GX0n iDlHw5E7JI3alImhyok/XMt+seNgR2LfgqbVgyEh38cXFzl3/eHlHCBHwtK/sv04ybPg oDV2xxq9mL+tytDJGL4OMDs6hrRtov5ngk3d5/ss6xsZCbaO8mcO2KSy0GgWw1L1pnx/ hKqw== X-Gm-Message-State: AOAM532niJAqJIQLl4xqDHZ7UBXmON7BoRGLMFh30pW7F0FtBbSlHus6 rRbbwU3ixroC4qI1WWeXH5g= X-Google-Smtp-Source: ABdhPJxPxE6SWv9hgXt3NhxR0Wzv0nvDhwhYEI+QWtTfB+c5HoI/8eJr+niqnFmg+K7MaxR+npmplA== X-Received: by 2002:a17:90b:1b4a:: with SMTP id nv10mr20189513pjb.87.1638600959179; Fri, 03 Dec 2021 22:55:59 -0800 (PST) Received: from localhost (61-245-128-160.3df580.per.nbn.aussiebb.net. [61.245.128.160]) by smtp.gmail.com with ESMTPSA id c81sm5066537pfb.166.2021.12.03.22.55.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Dec 2021 22:55:58 -0800 (PST) From: Timothy To: Ihor Radchenko Subject: Re: Some commentary on the Org Syntax document Date: Sat, 04 Dec 2021 14:48:37 +0800 References: <87mtljpd1w.fsf@gmail.com> <871r2upy8s.fsf@gmail.com> <87a6hggagz.fsf@localhost> User-agent: mu4e 1.6.9; emacs 28.0.50 In-reply-to: <87a6hggagz.fsf@localhost> Message-ID: <87y250oo3o.fsf@gmail.com> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::1029 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::1029; envelope-from=tecosaur@gmail.com; helo=mail-pj1-x1029.google.com X-Spam_score_int: -12 X-Spam_score: -1.3 X-Spam_bar: - X-Spam_report: (-1.3 / 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, PDS_HP_HELO_NORDNS=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, 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.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Tom Gillespie , emacs-orgmode Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1638601113; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=zv/yZln5AST6julkZeK5fIfp4dwW90MLqSXEB54KCTQ=; b=sssakCQifhoBzyPwvmEMHQ0X2+sCWcMNLZHWrfMD+VekK1cO186FpoMN1USZSc5CNl3XcH fMJf4hEpdOa2z0ByhFA0fwpDZCcqExv8iyz7DZnRlVmxp8J7e6nFG4b9jwe/rFJGOSBnRF 391RKQjdlJHM/zWcQZV2ijF1sJdjFhZG1dm3dzVR2NPhByRgH76scrUhfmcp/SRGWYez3a 8X0JZe6iSq5RHQALDA9qxr5uXslAGJaTNywWGblnPu7ywXKMney3SBoM4zjISwMGUx8Zxy n7as50Ubm1Gzlj10iJ4yK5jKu8N7Kiarpp8T6TR57/YPftpZE4ObMbvaukht3Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638601113; a=rsa-sha256; cv=none; b=RSiSbCaf/Xg08AMxndHvWsnUKPyUA26QwAz/OIBahIs2dzFeG8IqRC+AUyAEI/Hpru2zbh SHYXakAvmKu5c+6KvflwezkKfWs6v1Aq0+Bmh1JwFe8Ik0wdOULRhbT7iVIKtJ546b2D1F XXnXDQpejrs169v6UNZwz/4lhaJNjogMOEX74aPLEKv6RVOU8szFXeM7lBX9CtaDMKkjhJ QYBxqtMyahsDtNgifM0fY88+lc5KTnLLcHNDtegHrEVe7uwMsFt0tQon8qkjf3W9OHEG9+ nkcNjK2Z3H+Dz2a9tk8AClYnpW3kg/BV9GFbQMKoE58s0brvWKgA8pzn9QXwVQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=eILbmDNy; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.13 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=eILbmDNy; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 0494C2E33E X-Spam-Score: -3.13 X-Migadu-Scanner: scn0.migadu.com X-TUID: te42nkM6PCYr --=-=-= Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi Ihor, Because your reply is shorter, you get my first response =F0=9F=98=9B. >> [Renaming parts of the Hierarchy] > I am against renaming this. We should rather improve the syntax document > keeping the key concepts consistent with Elisp code. This is certainly something to be conservative about, but I think some small tweaks could be beneficial. See my comment below. > Org parser distinguish two principal types of syntax structures: > 1. Elements > 2. Objects > > Neither elements nor objects can intersect their boundaries, but they > can be nested. > > An object is always a part of some element or other object. > Greater element can contain other elements and objects. > Element that is not greater element can only contain objects. A thought has just occurred to me, how about instead of having =E2=80=9Celements=E2=80=9D which are split into =E2=80=9CGreater Elements= =E2=80=9D and other =E2=80=9CElements=E2=80=9D, what if we simply added the prefix =E2=80=9Clesser=E2=80=9D to the later? I.e. go from =E2=81=83 Elements =E2=80=A2 Greater Elements =E2=80=A2 (other) Elements to =E2=81=83 Elements =E2=80=A2 Greater Elements =E2=80=A2 Lesser Elements I think having something explicit like this could reduce the chance of confusion. > [Comments on headings and sections] This accords with my reading of the document and the way I=E2=80=99ve imple= mented things in OrgMode.jl (see ). All the best, Timothy --=-=-=--