From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.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 CaNFJjS0N2NVfgAAbAwnHQ (envelope-from ) for ; Sat, 01 Oct 2022 05:29:56 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id 8OJJJDS0N2MkAwAAG6o9tA (envelope-from ) for ; Sat, 01 Oct 2022 05:29:56 +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 34A29EC94 for ; Sat, 1 Oct 2022 05:29:56 +0200 (CEST) Received: from localhost ([::1]:55238 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oeTCN-0006vc-9N for larch@yhetil.org; Fri, 30 Sep 2022 23:29:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:44226) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oeTBl-0006uv-Hm for emacs-orgmode@gnu.org; Fri, 30 Sep 2022 23:29:17 -0400 Received: from mail-pf1-x42e.google.com ([2607:f8b0:4864:20::42e]:33535) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oeTBj-0007Gn-S4 for emacs-orgmode@gnu.org; Fri, 30 Sep 2022 23:29:17 -0400 Received: by mail-pf1-x42e.google.com with SMTP id w2so5811695pfb.0 for ; Fri, 30 Sep 2022 20:29:15 -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=NSYNkxlqDy0wk2CIGcRHwpARHXya+ZU5G8CyHjNFSwc=; b=WTDgjyE0SyLHbGkFZpaGzAHK2v2reW5FFAEufOv8gPTtzP4rVbwJ/40uVblNgu3BsH oZgBeydChaZE+PkF9uw3JfJ1vb3PeFGUbs5RO3uaKmj6pOHggBgz8FEP51esu4FsO/sy q0kpTlYZHALrfhWbfKn5GLqfmXfkBcGXD20g62jqa6ZyoJEQtuyo1R/YrGapdcq/GcLA R+1HeCxm4OLw56YQvHe0rIurlajWVN9kZ+XqcFJd7vPz0A3xlITxUGPEg11htuDO0M6X MpeRyKx8EW6pYfPO8FO3a5g+pStOTsvTfAVH/eP9/T7HWu8UQB7BjojT5rcdBLa5PzBQ LrXQ== 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=NSYNkxlqDy0wk2CIGcRHwpARHXya+ZU5G8CyHjNFSwc=; b=HHAj6V2WIOBPKhwkbFzkBab8XLiZZOiLQ+Iv2OYna1BK91EMCjSyWWJWIeUxQYH90j eZ/7E0s8QrLoGZG2JvyDoZqrDeJSvQBaert1gR7X2NEYbc7QeAF7GR3CyJ2CE1VpAkeH ZA5QWRQcIbWb8WOMuQ3vwbiwM4RW5FqN7SusqyVGG4ogO218T5EpmvkES6pIn7iKZIdd ysqs/Ke/GpmfUeUPeHFkaYneKMPhwyQc0DKeiXeOSOExAFVGjVsvA9RpKZBJQDX2wGEK LiWw25Duz6vr0dbm/9AEVhDmITuhG/Co/iSLlknwj/fSVl+QPb3SbgYV1bAWDlI3B/vf bdeg== X-Gm-Message-State: ACrzQf2ArGD3Yw+UZhcCLsro0o2Z/fkaTQO7IiQJtfky/FqASXo3cd0A axQxwIRbay4MXVto9pCADMk= X-Google-Smtp-Source: AMsMyM6+4zIO8TqvT5DS6JfTr9qNpD4Muy+yz0tFfBQLgumwZI34+ukzGDBRYh3n4d5czOKKXoXtpA== X-Received: by 2002:a65:4c85:0:b0:43b:f860:98f9 with SMTP id m5-20020a654c85000000b0043bf86098f9mr10131438pgt.368.1664594954500; Fri, 30 Sep 2022 20:29:14 -0700 (PDT) Received: from localhost ([2409:8970:a80:3a4:8ec6:81ff:fe70:339d]) by smtp.gmail.com with ESMTPSA id f19-20020a63de13000000b00434e1d3b2ecsm2435313pgg.79.2022.09.30.20.29.12 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 30 Sep 2022 20:29:13 -0700 (PDT) From: Ihor Radchenko To: Max Nikulin Cc: emacs-orgmode@gnu.org Subject: Re: [HELP] Fwd: Org format as a new standard source format for GNU manuals In-Reply-To: References: <87bkqx4jyg.fsf@localhost> Date: Sat, 01 Oct 2022 11:30:06 +0800 Message-ID: <878rm02pc1.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::42e; envelope-from=yantar92@gmail.com; helo=mail-pf1-x42e.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=1664594996; 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=NSYNkxlqDy0wk2CIGcRHwpARHXya+ZU5G8CyHjNFSwc=; b=kCW0NTbFeVzym88IG01TctDX3TORVwA2WP1H3vihfUlpQJrljAULaA0wetwMOF0qWGcCkY 2EunqnqPAiCh1qwIzvGj/LbdcAAk5KbDCUyG70HUtD2dGCGpOHTyGggybhOq1unABLnspE ZToTCFS62kuIGtQINmTIVN2Utma27sDgNLdYnBVf5pjSk5Jex+KKl969k/w8ZymYaBrgdq HdDDyjyIOX1agTezzP47cy0cdZ6aDM+5vj+Vi3H41NyZhLIM3cTPsV+i2+w3iCaUN/3YaI s1G0pzMGmJrV9LHzbmNoJEOdDHtgiRYGC/kz5TqA3BTHF7qMuuheaAy+yiuJ7Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1664594996; a=rsa-sha256; cv=none; b=uI465sYoxLnMVli7nYHEY114ViaFD5nNvHZZaIlMWjrMrKN6UP/dJmidox5dRewZMc4yD3 AUfrFLJm+hM5wLHUz6AIq9lEvZNrZrZl03ygCZxcOo9iGCzcdp6pqtBwLP+pPfxzF3gkwc hBkc3DZq9F8+O2GOb5FVzBz+hpbcW16xX0YpQHh8hMZJJ+gbmxFM8HjvB85ttYh4PFfILr pkg3+ybKrs+7AQDDwtNbqFdite+ZWsZy4Wdle3qVeaIi0ebZgyRvpQPhFihWEO82AUGPdK 1DHMmM+WlEvtxw0vene9b7XJRzORNm6wEbHGJMaYXbDZFAeykAR6kHT4e3y/uA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=WTDgjyE0; 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: -8.64 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=WTDgjyE0; 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: 34A29EC94 X-Spam-Score: -8.64 X-Migadu-Scanner: scn0.migadu.com X-TUID: W1r29mGyT3qr Max Nikulin writes: > On 30/09/2022 10:31, Ihor Radchenko wrote: >> >> Texinfo provides numerous subtle distinctions that show up clearly in >> each of these output formats. Compare, for example, @var, @dfn and >> @emph; compare @code, @samp, @file, @command, @option, @kbd, and @key. > > I have not read the emacs-devel thread, so I may ask about something > that already has been discussed. > > Are there cases when texinfo may use nested formatting commands of the > same type, something like @samp{a @code{b @samp{c} d} e}? My concern is > that current org-element parser may be a blocker. AFAIK, the only nested construct in Texinfo spec is @acronym{GNU, @acronym{GNU}'s Not Unix} https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#g_t_0040acronym But it should not be a blocker. We can use two different elements for this instead or employ the requirement of balanced parenthesis inside, similar to what we do in the HEADERS for inline src blocks https://orgmode.org/worg/dev/org-syntax.html#Source_Blocks > Another point is that most of the mentioned commands a close to > verbatim, but Org has much more special characters recognized as markup > and no markup is allowed inside Org verbatim snippets. Escaping (by zero > width spaces?) of code and samples may be prohibitively inconvenient in > Org if markup should be recognized inside. We need a new special object type for markup that does not suffer from the limitations of our current single-char-style *markup* constructs. (It is not even solely motivated by this request from RMS; we just need something to allow whitespace in verbatim boundaries) > One more point is external tools like pandoc export from Org to other > formats. When Org extensions are implemented in elisp, such tools become > hardly usable. Unsure if some kind of declarative style sheets will be > enough. We already have Org extensions for links. I envision supporting GNU manuals in a similar fashion. Only a subset of universally useful extensions will become the actual part of Org syntax spec. At the end, Org should remain generic export format without going too far into manual-specific requirements. Specific exports should be supported optionally, similar to our ol-*.el libraries. -- Ihor Radchenko, Org mode contributor, Learn more about Org mode at https://orgmode.org/. Support Org development at https://liberapay.com/org-mode, or support my work at https://liberapay.com/yantar92