From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id YGWzE3sbMGMTrgAAbAwnHQ (envelope-from ) for ; Sun, 25 Sep 2022 11:12:27 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id gHe9E3sbMGPnIAEA9RJhRA (envelope-from ) for ; Sun, 25 Sep 2022 11:12:27 +0200 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 F1E4B24425 for ; Sun, 25 Sep 2022 11:12:25 +0200 (CEST) Received: from localhost ([::1]:32884 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ocNgW-0006bt-4D for larch@yhetil.org; Sun, 25 Sep 2022 05:12:24 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58634) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNeU-0006X2-OX for emacs-orgmode@gnu.org; Sun, 25 Sep 2022 05:10:19 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:44710) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNeT-0003HO-PE; Sun, 25 Sep 2022 05:10:17 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=zrngDnDEk7Bh/Dh/foyH5IjunH+nbXwMKQjY/5S3bFw=; b=evSc5o4YapFq2mztrf3/ 7cxehA+gvz6WaYgNsXk+LFXJkMZW3GYJhiImkNeXbxTQj9iWTj1Ncpr1B1RB4XFfmCcA742wlvGHp iOdb0fAblgJcwAfxm3sK9gZaks0Rh8oIXyaKU/zPpx/5m/cxYEUnRCG2ZVLDsTG4K7jTIM7Ffnq/j Geg3gZTMf/RIjpt8ZYHMZwBvL3qpV/WEbQcv4fnBsE6hiPgxVK3unWllhAbdHEtxmF/9kMgnJT1Z9 0g13WMnqEmV1YTIBKRYFM0U3gww6F86zQyM6L6/rVSXTqe7UWi3WIbXTCDMWM4NMu95oPOb6M2qOY +CnTR+lL9/dbQw==; Received: from 96.52.140.77.rev.sfr.net ([77.140.52.96]:43496 helo=hal) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ocNeA-0006rq-Je; Sun, 25 Sep 2022 05:10:02 -0400 Received: by hal (Postfix, from userid 1000) id 5E2A11E0409; Sun, 25 Sep 2022 11:09:55 +0200 (CEST) From: Bastien To: Timothy Cc: org-mode-email , mail@nicolasgoaziou.fr Subject: Re: Org Syntax Specification In-Reply-To: <871r1g936z.fsf@gmail.com> (Timothy's message of "Mon, 10 Jan 2022 02:02:34 +0800") Organization: GNU References: <871r1g936z.fsf@gmail.com> Date: Sun, 25 Sep 2022 11:09:55 +0200 Message-ID: <87czbjbz18.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1664097146; 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: 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=zrngDnDEk7Bh/Dh/foyH5IjunH+nbXwMKQjY/5S3bFw=; b=LLerf6mOU6PeSwu9zwemKP26ukLenOr/rzyOt+rbzhjhBTXsu/x/KTn5rhGiFU08EZLY52 4GAZZgthrpTxMVQysNUEODp6iSc6d2sgDW+VC01+m/YfRfqHb2I6SYge5l4lmzpMdISu93 8oY/WRBE/UI4KQYxurm8+BF2jClYRjingsI8L8Ea9iPeiNGqD/zGUAewMXpwSTiNaB1KRQ U1+hiO3DzSTEb3xaxHGctbK/m/WaWIFHtC53d+JtEfgaOOFEHEZ3piddk/exPVaKU/2Rlc JGbIPJ79BWS/9Q8QiFDsry8uwti4LwDHcL7sMTto84O6mZa+Do7Nit0pO7o7ZA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664097146; a=rsa-sha256; cv=none; b=mVhEGz6fSgKTudVtIxaWFo0gP7z0PBdGyMoRXiHVD/ZJ7pxhprSGghmUyFJdUifyilBVnn xeiBYaA+wiPD76IAnL8KBh7tOKeG3rwUgRGXYNu5IOlKHZmH22YyY3wGiKs3FZhIBLTam6 EaIdHqXwy0cM0skHm1Vnj++RWl8zROgtT0BRKx7+c2gKda26RHbSwpz8epaDmdLXWfm78+ gS3YFr59L4xXZcgf7HHvo6Qiws2kM1NujVidJoz9EJ80orH2Kkk5kl7Q3uXNBgslktoxQk LrKYDs8rlTCCrlcOKVPpk/y0BTjpx/d9axZWE505ubvTuE2ZwrI5ZEGvH6juYQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b=evSc5o4Y; dmarc=pass (policy=none) header.from=gnu.org; 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.55 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b=evSc5o4Y; dmarc=pass (policy=none) header.from=gnu.org; 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: F1E4B24425 X-Spam-Score: -3.55 X-Migadu-Scanner: scn1.migadu.com X-TUID: X+44tcSCxf7E Hi Timothy, I'm late to the party, but *thanks* for these important improvements on the https://orgmode.org/worg/dev/org-syntax.html page! A few suggestions: - Make it a description of the syntax of the latest stable Org. (For now let's consider 9.6 to be the latest stable as we are working on releasing it soon.) Perhaps this is already the case and I missed it? - Remove the "draft" status ("DRAFT v2=CE=B2"). Don't describe it as a draft in the org-manual.org if it accurately reflects the current syntax (current =3D latest stable). - Remove all the inline notes (some suggest changes in Org's grammar, that might scare the readers a bit.) - Promote the page to orgmode.org/worg/org-syntax.html: the /dev/ path in the current URL makes it read like it is the syntax for the "dev" version. What do you think? --=20 Bastien