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 oCK9GwEIq2FpCwEAgWs5BA (envelope-from ) for ; Sat, 04 Dec 2021 07:17:37 +0100 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 ED6BFwEIq2HCDQAA1q6Kng (envelope-from ) for ; Sat, 04 Dec 2021 06:17:37 +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 0DD8218FD6 for ; Sat, 4 Dec 2021 07:17:37 +0100 (CET) Received: from localhost ([::1]:50002 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mtOMZ-00009j-EI for larch@yhetil.org; Sat, 04 Dec 2021 01:17:35 -0500 Received: from eggs.gnu.org ([209.51.188.92]:39266) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mtOLD-00009Y-0M for emacs-orgmode@gnu.org; Sat, 04 Dec 2021 01:16:11 -0500 Received: from [2607:f8b0:4864:20::433] (port=35429 helo=mail-pf1-x433.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mtOLB-0002eN-FA for emacs-orgmode@gnu.org; Sat, 04 Dec 2021 01:16:10 -0500 Received: by mail-pf1-x433.google.com with SMTP id p13so5003439pfw.2 for ; Fri, 03 Dec 2021 22:16:09 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:in-reply-to:references:date:message-id :mime-version; bh=+6bVtiCsg8Zv0HBM1UVTiwD4dfGBXD20NAQobzPIaRQ=; b=Kfu1Gr73WOQTfiJ4miaLKJx43j/qPuoG1utz1rcby8hP7v839WCLU+BOCbG+UoQOWq R14EyAJuaCqtBfiALkyT9ozIhL7zgK3NRdnB95rZel3gpyqgtbZYGvx42KTFmjVZdbOi aKU5jqCSzzYOWPwY36xgNwySo6Q3wxq5HkPibOVV9mbHqLSbMEAt8w/PgrecEbM4eJhq yGREQmtg2Iuqv2ZIXy/R1LcgRgwQ9Rj0Zn+IXtC9pMYaom7PdXvRY85awqyHjp25tpQI A3cybNyRRMx80soRkVQOHmS8RxOjMzvCT4HINg7IzkL2RAwc0qN+TfHEd9nKw2d4Uthi MPDw== 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:in-reply-to:references:date :message-id:mime-version; bh=+6bVtiCsg8Zv0HBM1UVTiwD4dfGBXD20NAQobzPIaRQ=; b=SOFocYxp2sCnLZngqWxWVS9NC8K8DqMcmz28bjdNtZdro4ElSGaXvZeSSpmeoApGc8 e6NLcuu6mCaSJBDX5DeX6uQ6HILFfp9lyTffmvst7EVTJgpYXDBIq9eck7Q3CdkWxhpb RWXkX49AnaWd7BK4ruFCTbg87ilN1jHrddYN2Zo9Pxtv0Hhpna9GRWaUV3hpuj89df3d NNCoUlyKK6G9gqMAGVQtDC2JHvPgq8Gy4lHbv9Id+7MVgqZsDbo3NW6dmZRrNectEEWl PommbHmyG/RYc49zY+MmEQ5/uPjCvboiy3NLvSr7ptKeUuy4EQnCEuBuUabYc6eJK0lv s6jA== X-Gm-Message-State: AOAM531FgD7OsXP3SVrJMggOs9YedGqU9vuXFMfdtNwzRiIoy7rah+v+ Qy4rFboOw9GdD5Fttk4dWG0= X-Google-Smtp-Source: ABdhPJz6xxGECabpLs6VmEMEL8Bi8E92T2qf4WYHjcdavWn2G3PfAG/GaosxDTR/uuVZ4Cb/mmh2eg== X-Received: by 2002:a63:1001:: with SMTP id f1mr8241435pgl.353.1638598568014; Fri, 03 Dec 2021 22:16:08 -0800 (PST) Received: from localhost ([103.125.234.62]) by smtp.gmail.com with ESMTPSA id h5sm5247129pfi.46.2021.12.03.22.16.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 03 Dec 2021 22:16:07 -0800 (PST) From: Ihor Radchenko To: Timothy Subject: Re: Some commentary on the Org Syntax document In-Reply-To: <871r2upy8s.fsf@gmail.com> References: <87mtljpd1w.fsf@gmail.com> <871r2upy8s.fsf@gmail.com> Date: Sat, 04 Dec 2021 14:17:32 +0800 Message-ID: <87a6hggagz.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::433 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::433; envelope-from=yantar92@gmail.com; helo=mail-pf1-x433.google.com X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.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_ENVFROM_END_DIGIT=0.25, 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=1638598657; 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=+6bVtiCsg8Zv0HBM1UVTiwD4dfGBXD20NAQobzPIaRQ=; b=PxG/fhpL5vI3WcMQYKIurCLVk1N7Bu8xV9+Hp3ewfEcF2YUScatqqh26+FrmzQie5KeLgI IkhmcCV4YVIPytYz8WYKO3npVtAnlwsZd0dsZYhZOV73YSyJsw6yXoZAlYRx8L5ts/syqP qRcv6uEmO6UmzbL7JM2NHvT+vTrbqEhuG2fI29SQzt4h0igQ1gJKlHH5I31i5kRlrg0Qkz QWPHjpyUIiIm2wCC3fOBR4gPOrTXBZEJMTN58fIs/yTDWeyRTAtbVhgKRddWEjMh2Ouyix TJeMjWpUBP3GpZ7fX6C7m8zd2wHzA3ll8f5idSGD5D0V6ogtbERGZ7oNjkuyrw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1638598657; a=rsa-sha256; cv=none; b=Ol0Y6ZUnrumNwo+YztcijKzzFu+JLn812+EZg9RyBGJbVGKQt7yT/S5fPtFgtVSSX0xZYs EnRI2ZUDmwzoTak5Jcp8J8m1da3WrotoodF+oTgpmM1Fv7m4mLwT1OsmnIV6XKnUtfNXYp Gw337atP2xcj/riEyzbaOi0XB+6r9nad4TPUDGLZypJTp+GcQKsFJ/aGfEK+/hY4VgZeUC fLI43B9vcNJADiUUVDLYY/mGcoOSwNLccZV5lmzrO1Tkc527J2W8tKxsLBzqI9AgZU47S+ yZW73pwcpL5k79nKHBrreIgYMQt0+BryTAUvF1G1tee+r1vjAajpn/vDJr4cZA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Kfu1Gr73; 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.63 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=Kfu1Gr73; 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: 0DD8218FD6 X-Spam-Score: -3.63 X-Migadu-Scanner: scn0.migadu.com X-TUID: 9HKo2i0iuK2c Timothy writes: > So, the hierarchy appears to be something like. > > 1. (Headline / Section / Greater Element / Element / Object) > 2. Headline > 3. Section > 4. Greater Element > 5. (Greater Element / Element) > 6. Element > 7. Object > 8. Pattern / Form > 9. Term > We could say call (1) Components, (7) Units, (6) Objects, (5) Element or > Object (why not spell it out to avoid telling people to remember > something). I am against renaming this. We should rather improve the syntax document keeping the key concepts consistent with Elisp code. 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. Headings are an example of greater element with the following structure (headline (optional section) (optional repeat nested-headline)) Sections can only exist inside headings or top-level document (org-data element): 1. (org-data (optional whitespace) (section) (optional repeat headline)) 2. (headline (optional section) ...) Best, Ihor