From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id mBT/HM7OPWNRfwAAbAwnHQ (envelope-from ) for ; Wed, 05 Oct 2022 20:37:02 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 2Oz1HM7OPWNgDwAAauVa8A (envelope-from ) for ; Wed, 05 Oct 2022 20:37:02 +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 3B13D11424 for ; Wed, 5 Oct 2022 20:37:01 +0200 (CEST) Received: from localhost ([::1]:38304 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1og9GO-0003Hi-C4 for larch@yhetil.org; Wed, 05 Oct 2022 14:37:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51948) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ofyKa-0003MH-8Y for emacs-orgmode@gnu.org; Wed, 05 Oct 2022 02:56:36 -0400 Received: from wout1-smtp.messagingengine.com ([64.147.123.24]:40791) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ofyKY-0002Jm-4L for emacs-orgmode@gnu.org; Wed, 05 Oct 2022 02:56:35 -0400 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.west.internal (Postfix) with ESMTP id 7FA94320089C for ; Wed, 5 Oct 2022 02:56:28 -0400 (EDT) Received: from imap50 ([10.202.2.100]) by compute5.internal (MEProxy); Wed, 05 Oct 2022 02:56:28 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to; s=fm2; t=1664952987; x= 1665039387; bh=qnTM77tVYzlkUdluCkpFLbGkS8tZRmkDUhSz/MVGyBc=; b=Q QQwPtvOvGMSorbIoMjhRj8aRGZQNrDJNk9egC5/f/UnbVORlnXwqHKAXm7nnXrum rLlOFRLc9voE8e2GuMN3/S3HUcof7x32FjdnOn6orIuXA1bNAgMZBPduAA/24wiU cOjR33/Wvywdn5pqNfTI76QSm0RIJ6Ua5P05sTK/IdCJ9IFGcEhlnQG/G8PzxxW8 YgRL8eYNS7EvzWttbGLfRUJ0aopXAli9RPHOdIW7l0nv0qjozjmb53+OwhLolWZs Wgag6D3Zw7IK2ngQjA7Hh16fCBzOnLb7ndR8qSluhPFYG0umZqcZ6OvxQFCIHnpa j8s2+LYzC8CtqI6Pwkfhg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:date:feedback-id:feedback-id:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to:x-me-proxy:x-me-proxy:x-me-sender :x-me-sender:x-sasl-enc; s=fm2; t=1664952987; x=1665039387; bh=q nTM77tVYzlkUdluCkpFLbGkS8tZRmkDUhSz/MVGyBc=; b=bvo4ipp9XYr/kX2id /IjFtljdCHHOwJCXGpBWSjGrxeHVzkhHI5/PsOHgwIZpkLnRKxxX2OsyNsWbMV51 f/3k7MQqGDCuYrisSuEwyDdK78MgnKHCYGHDvI0pEVlJnmOm/MRkbbMCXi6lGDYv wkdLCznOe6dwXlGLsf6pe2/qLhDTCXskTGtIYBZSyHDEvZa7M5GOJT68q6kTNvhF ten5K5tSc6PO7zYv2ST5SVKioTW/SN7ZLh6EstqdBxwvtU1jUbYnd2e8tmqKrkJD zt4v32b1/8ointhO1v8pNOqJumMYXpmxRbyMb1o+ksDsQqOgr/zo2/zy1uh2nDMH u7n9w== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrfeeivddguddufecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecunecujfgurhepofgfggfkjghffffhvffutgfgse htqhertderreejnecuhfhrohhmpedftfhitghkucfnuhhpthhonhdfuceorhgtlhhsuhgs sehfrghsthhmrghilhdrtghomheqnecuggftrfgrthhtvghrnhepvddufeffueeuvefffe eukeekleevudegheekjeeftdffvdejtefhleetkeekuedunecuffhomhgrihhnpehrrggt khgvthdqlhgrnhhgrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpe hmrghilhhfrhhomheprhgtlhhsuhgssehfrghsthhmrghilhdrtghomh X-ME-Proxy: Feedback-ID: i01814450:Fastmail Received: by mailuser.nyi.internal (Postfix, from userid 501) id BDD0C1700083; Wed, 5 Oct 2022 02:56:27 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.7.0-alpha0-1015-gaf7d526680-fm-20220929.001-gaf7d5266 Mime-Version: 1.0 Message-Id: <4f4f2b89-ee99-471f-8105-4c54fe1adfc1@app.fastmail.com> In-Reply-To: <87o7url4el.fsf@posteo.net> References: <87bkqx4jyg.fsf@localhost> <878rm02pc1.fsf@localhost> <87ill3st88.fsf@localhost> <87h70m252s.fsf@localhost> <87ill233z1.fsf@ucl.ac.uk> <87mtaez8do.fsf@localhost> <87v8p29w2v.fsf@posteo.net> <87tu4ly1ql.fsf@localhost> <87o7url4el.fsf@posteo.net> Date: Wed, 05 Oct 2022 07:56:03 +0100 From: "Rick Lupton" To: "Y. E." Subject: Re: [HELP] Fwd: Org format as a new standard source format for GNU manuals Content-Type: text/plain;charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=64.147.123.24; envelope-from=rclsub@fastmail.com; helo=wout1-smtp.messagingengine.com X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Wed, 05 Oct 2022 14:35:03 -0400 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-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1664995022; 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=qnTM77tVYzlkUdluCkpFLbGkS8tZRmkDUhSz/MVGyBc=; b=l5SeuuZMoDfIl8iwqXTZmAutJ4h7VVkgYpzwC37OpWAtFUREeoO1inBPY9DG3ZE+cciIiC e9anH7zLfpdLChhYW5j1BQAWj8fPywX1eigDMrOspEJq8PQooolhAQNhHt+Bz1ZrQEP8kw Dg/+sh0epdxw6U2jcEVfBiO5viPZeHlGj6gWL8NYTxRzUL8hZ+agGOmfMVrcLYnin3GIVG z/67ejW+xIyldT4CT5DnCb07VZehIULUgDz7VjQLQwB8UYPyjaKFRXY0lalJRUiDKcg61p 503WrWjktojF/5SN0Qvd4DNXGYhRPRwdyn9AVqLqrHQy9Y1Lp17ALjoN9Euwxw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664995022; a=rsa-sha256; cv=none; b=D0tTehg/4mFQWowWrWqgwwfAdt6ruEQVccLeBBzB9sD9a2CvNyGh9H/ZVB9XeP+lkG9E1D Lvh8P4ZxBZUmPRyKtsWaUCY8M/QEcF+ZJIxTUTKEkqrzzHe9vSf/WG4DmcdFnPacB9sCmt Z13YQ8iRp0iQbviFM4C4HzMWVwu/wX9YzlN1Ci1uP1Uoy+aqYoWCiSbtq+BTG1pkLeMesp cUC1HplJhJ/s0tmZNK6Zh/ak5geWFcV+KvfbJO5gyulVxl2QdPvT4CdK0ADHqnPiSspudE wGs8KwGGSQt553v31UDoQDJzG0L0LmCZUq+uzjhat9Wh5pvZZqQYTgbxktGWbw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=fastmail.com header.s=fm2 header.b="Q QQwPtv"; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm2 header.b=bvo4ipp9; dmarc=fail reason="SPF not aligned (relaxed)" header.from=fastmail.com (policy=none); 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: 6.75 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=fastmail.com header.s=fm2 header.b="Q QQwPtv"; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm2 header.b=bvo4ipp9; dmarc=fail reason="SPF not aligned (relaxed)" header.from=fastmail.com (policy=none); 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: 3B13D11424 X-Spam-Score: 6.75 X-Migadu-Scanner: scn1.migadu.com X-TUID: zIC42mgsG9rl Hi Ihor and all, I wonder if you have seen Pollen=E2=80=99s approach to this? https://doc= s.racket-lang.org/pollen/pollen-command-syntax.html There are two separate ideas used there which seemed related to this dis= cussion. I=E2=80=99m not sure if they are useful in the org context. =20 1. The use of a special character (=E2=97=8A by default) which introduce= s a command/inline special block. I don=E2=80=99t know if this would be = worth considering as an alternative to @ (which also seems reasonable) t= o avoid ambiguity with other syntax. As the link above discusses it=E2=80= =99s harder to type but there are solutions.=20 2. Making it easy to define custom functions that produce org syntax. A = bit like perhaps Max's suggestion to use source blocks, but instead of w= riting AST-like structure directly in the document where you want it, yo= u can call a previously defined function to build it. This is similar to= org macros but I=E2=80=99m not sure if they are so flexible as a lisp f= unction. There is also the option to choose between passing arguments as= lisp (in [ ]) or as markup (in { }) On Tue, 4 Oct 2022, at 9:28 PM, Juan Manuel Mac=C3=ADas wrote: > Ihor Radchenko writes: > >> If I were to choose an alternative symbol other than "_", I'd choose >> "@": >> >> @name{} >> @name{{> @name[:key value ...]{} >> >> 1. It is similar to Texinfo >> 2. It does not clash with TeX >> 3. We already use @ in the inline export snippets. > > I like the "@" alternative a lot. And I agree with all three points. I= t is > also compact without losing clarity, and does not give the feeling of a > blank space before, as in the case of "_". > > Best regards, > > Juan Manuel