From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id sMqeJ0CMOWOAXwAAbAwnHQ (envelope-from ) for ; Sun, 02 Oct 2022 15:04:00 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id OMNkJ0CMOWNQ8gAAauVa8A (envelope-from ) for ; Sun, 02 Oct 2022 15:04:00 +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 50F933FC3A for ; Sun, 2 Oct 2022 15:04:00 +0200 (CEST) Received: from localhost ([::1]:51898 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oeydR-0003iB-Fo for larch@yhetil.org; Sun, 02 Oct 2022 09:03:58 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:35650) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oeyaw-0003GM-Na for emacs-orgmode@gnu.org; Sun, 02 Oct 2022 09:01:23 -0400 Received: from mail-pf1-x42d.google.com ([2607:f8b0:4864:20::42d]:45838) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oeyau-0000e2-Ss for emacs-orgmode@gnu.org; Sun, 02 Oct 2022 09:01:22 -0400 Received: by mail-pf1-x42d.google.com with SMTP id c3so3205555pfb.12 for ; Sun, 02 Oct 2022 06:01:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:from:to:cc:subject:date; bh=mMDpYTD880A0bwWpkM6sdJFNBsK4Orx8+sLg/EaH2rk=; b=bc5F9LTxgl1lCCmIQt48WqDXXSZV8mOF+jd6JujUY/iC+GjUGjs9byZRfoM9RLx+ZX 4r/3cqtfkSetypsObXVBT9u87V2lJXo+cVvzqMYZ5FbYUKkTlmqDwDdKhcijtmfRLFg7 JwXg3mXSSMROg2X3GFZDw79+I5SYSmK9+fyzsQmymMER7CZ7PoupSd9nExxdQgvRLllo cD8sBQJGNKIIQqfqaLvd9T06wMc/5jrrojcRBseueWcwqw5RAcfrvEiTTLAK0HUfMcVb 3p23G28xbm8kCUFMwtLmUJarV+DCa0pc8iAT7rTxs50VybpmTFn+Uv9EppS137rH6qxj MbaQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc:subject:date; bh=mMDpYTD880A0bwWpkM6sdJFNBsK4Orx8+sLg/EaH2rk=; b=mgOYKPjxFyJH6JK04hOhnEIg6HMyHdOlKrDc53yjS5sRT9ybYau+MOUgFsgHICzqDO MczO/jvMOtj5UaDGAh2Ie3ssdQK4xg2PtS0tWS+msUpo2pCIXRwBk9W+pth/hRZGz8RA /G1VMV4WiPkRdEbs056DvroHZughH8vAR6oY53Rwfv2IsC70S5ZJTZWs4NjEZizg86FX 28kNH54JPI04NJcu6HMbnlKrV0HFrq++gM0oZ1Hg+SO5jNgloZjXhCAcociWSt88M2GE 8h0pZWE697Rnvkz99KzfCfN+5k+NmKzlrHkxaNF9YT+ZDElU/arm7iOzChV9fl98ihw2 vVPg== X-Gm-Message-State: ACrzQf1ExFqiIx2WWU5VeCTEJZG+oSvhk+pTbnnMg7pjtUooXkGsjCjI ZbuXEz/sJuTM+BV+2zAueIYc1gRpq+eSAw== X-Google-Smtp-Source: AMsMyM7O5fy3Y7vm9ff9vhPZqGn2UVuaxdecizZC8FmUrHD18azt7J4jqQrYbGadVJwlkev5ZrYKlQ== X-Received: by 2002:a63:8ac7:0:b0:445:80ef:2b8 with SMTP id y190-20020a638ac7000000b0044580ef02b8mr6324452pgd.120.1664715679204; Sun, 02 Oct 2022 06:01:19 -0700 (PDT) Received: from localhost ([2409:8970:a80:3a4:8ec6:81ff:fe70:339d]) by smtp.gmail.com with ESMTPSA id x15-20020a17090a530f00b00205de6ff5e2sm4669534pjh.56.2022.10.02.06.01.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 02 Oct 2022 06:01:18 -0700 (PDT) From: Ihor Radchenko To: "Fraga, Eric" Cc: Max Nikulin , "emacs-orgmode@gnu.org" Subject: Re: [HELP] Fwd: Org format as a new standard source format for GNU manuals In-Reply-To: <87ill233z1.fsf@ucl.ac.uk> References: <87bkqx4jyg.fsf@localhost> <878rm02pc1.fsf@localhost> <87ill3st88.fsf@localhost> <87h70m252s.fsf@localhost> <87ill233z1.fsf@ucl.ac.uk> Date: Sun, 02 Oct 2022 21:02:11 +0800 Message-ID: <87mtaez8do.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::42d; envelope-from=yantar92@gmail.com; helo=mail-pf1-x42d.google.com X-Spam_score_int: -17 X-Spam_score: -1.8 X-Spam_bar: - X-Spam_report: (-1.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_ENVFROM_END_DIGIT=0.25, 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.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=1664715840; 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=mMDpYTD880A0bwWpkM6sdJFNBsK4Orx8+sLg/EaH2rk=; b=GDi7tiK9W9rqSlzDTO8+KBzoj/wWAqNrjZtOODf0VlydE3gelL3Vw+W5OrG2rTivRG7IbJ QgZIM7f8Bl8JOQffzydFqe4+Bcf4ad112dRAfgh4gKLs+ARck36hHGQ8jBojS0a4FzyXp1 Qiv6fduwYyAOSmYwkUucFl6+3bnvZPm3X/GETA83sNqoHjokWaMzp9jRT5Rx7rEb0kxtIN eKOK8pSuggo0Xsb2iucLZbz3mlbyNDy2xmDgItdPKX6WUFad5/8MTUWK0iwly8BMftgVGx fzAPi3HwEI0KskQC20DJ/jR5f481liJi4y8yqIDBoDBGPEfsSVF5BfNl58goCw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664715840; a=rsa-sha256; cv=none; b=lZwHnGOImwuJ0zPPGrlvGcLqF8gYSlEfsWrkX/i+WM7XmR2LkOB+ck2MEfwTmn2pDW1Dnh TDbGUcB5NMELcUFNhyJJSrjAbtQbsaa6hbSy6ax6KzUFeMUqeFCVbk74G94CvbAh/NZLcd gmKSgtb2wVRnd48RaUW1HMQnmpucbBfEsW5uy6AbdcQrwxAkPeKP5aVvhmKR6BC4yPoUEE /4Ewi9jiJsRDwpezH6hW3xObGlzhBz1zKEodwJuMd6lxVbj6UQXMz2et9JDqk4HONKW4/6 GgmyxyfSppLX6u4RRgWm2iWJ00egpNOGFLOfO+GJWW0ExoQY0qQyphnPQZ+Oww== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=bc5F9LTx; 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: -1.84 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=bc5F9LTx; 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: 50F933FC3A X-Spam-Score: -1.84 X-Migadu-Scanner: scn1.migadu.com X-TUID: qRuuCPuND/0a "Fraga, Eric" writes: > I like the idea of inline special blocks. Given that we have recently > introduced [cite:...] as new syntax, could we generalise this and allow > any xxx in [xxx:...]? This syntax will make it difficult to pass optional arguments, like in @abbr{FSF, Free Software Foundation}. Also, escaping "]" will be tricky. > With this, the example Max gave from texinfo: > >> By convention, the dynamic library for @var{language} is >> @code{libtree-@{sitter@}-@var{"language"}.@var{ext}}, where @var{ext} is the >> system-specific extension for dynamic libraries. > > could look like > > By convention, the dynamic library for [var:language] is > [code:libtree-{sitter}-[var:"language"].[var:ext]], where [var:ext] > is the system-specific extension for dynamic libraries. I am thinking about something like _name{} _name{{}} <--- extra {} is added as needed for escaping _name[:key value ...]{} The syntax idea is to follow the relevance between [[links]] and [cite:citations] but here we have src_name[...]{...} and _name[...]{} instead. By convention, the dynamic library for _var{language} is _code{{libtree-{sitter}-_var{"language"}._var{ext}}}, where _var{ext} is the system-specific extension for dynamic libraries. We may even follow Max's idea about AST and make it so that _bold{contents} will be parsed just like *contents*. > noting the recursive embedded syntax. (and not knowing texinfo, I've > assumed that @{ and @} are escapes for the braces but could be something > else.) Yep, @{ and @} are the escaped { and } in Texinfo. -- Ihor Radchenko aka yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at