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 ms9.migadu.com with LMTPS id 2KsDGelhdGTalAAASxT56A (envelope-from ) for ; Mon, 29 May 2023 10:27:21 +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 IFkAGOlhdGTCyQAAG6o9tA (envelope-from ) for ; Mon, 29 May 2023 10:27:21 +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 E7FBC211F8 for ; Mon, 29 May 2023 10:27:20 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q3YCp-0003XN-Gs; Mon, 29 May 2023 04:26:19 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q3YCj-0003Mt-Cf for emacs-orgmode@gnu.org; Mon, 29 May 2023 04:26:13 -0400 Received: from mout01.posteo.de ([185.67.36.65]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1q3YCh-0006bq-HU for emacs-orgmode@gnu.org; Mon, 29 May 2023 04:26:13 -0400 Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 3507B24002A for ; Mon, 29 May 2023 10:26:09 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1685348769; bh=lYpp9yUKCAzFeGaaCo9/xo68XPMl9GmJpPqfUCRAR5M=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:From; b=Qh1E8AWMvoAjIWhjk5wTsi0s4zkSbML5gK0D1y87mj9HwwRbeo4bwVMnN2J8am5hu bboLMNdugJXpugreX/D7cEHA8AAbQHuXPdVgxHH8wHUu/KRCS72hBo7sMZcpHXuMAL gX1btFpKptqvPy4i78RnK1PVtWuC9mKpEJwlmIvs+tvbse9kIPhWlrS84zT4Kv8g79 eHaowLN1dZvnh1z4tJKf+nZlf3+s1BxAessFrc9FVIB3nObIA0A7ncJpnZjw5x/EKM kVEOIoAGbMaslaAz5E6MpJ0qgO+/cy4rzEnpma/rpRwUwpfUFnqKCqn3deNp0h/1uw FdyljRvuy7rlg== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4QV7sD2wwvz9rxS; Mon, 29 May 2023 10:26:08 +0200 (CEST) From: Ihor Radchenko To: Philip Kaludercic Cc: Payas Relekar , =?utf-8?Q?Bj=C3=B6rn?= Bidar , Christopher Dimech , Help Emacs Orgmode , Help Gnu Emacs Subject: Re: org-mode for package documentation In-Reply-To: <87mt1n372h.fsf@posteo.net> References: <877csszoy6.fsf@gmail.com> <87pm6jtvwz.fsf@localhost> <87mt1n372h.fsf@posteo.net> Date: Mon, 29 May 2023 08:26:06 +0000 Message-ID: <87a5xnwnkx.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net; helo=mout01.posteo.de X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 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, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 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-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=1; s=key1; d=yhetil.org; t=1685348841; a=rsa-sha256; cv=none; b=dKqq6MvvE194W52vUHnImq8rplB9UFfDV/D+GrtFC2otOG5YCu+cU+9S9VZFrH3xu+f27u mtMJvpV4UswYB9+gI+QU0H7TiAGoje3AYO26SccMSUg69/Lvn4GeUXuu0KbZ7BN8efdwIX ItVjAQDfolsS8Z5ZogojpnL/QnAMG980iEciS+VUGkUBraqeZJXACnFwcTZ4VReipP5zxH /9AApvR1lSfDH2hzjvLWo8v1DNlzzegHX3AYk6n4G9Bz+fXtuq0Im260wq+zEUb9PiY14s DMZCt5Isk1K7WuPloocvtUG7rEYBmJnpO8eZhokJqBHAUT7A0GWqUVFckPmkCA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=Qh1E8AWM; dmarc=pass (policy=none) header.from=posteo.net; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1685348841; 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=WKVprLqlZUnmy8HzdUYwtXfdXpaWptVQJXCuuc5uN0M=; b=SY7FoC1DWU5NmsRAYwe0BUvgqpjJ5Nn9ZSMrzlE37RuoAbumDQwXP3I2JMcHEOS6Z0mTau vj5ksF1zt/kcUxvo8GcLYz/tRIK1R6LyxIOFTsMuRpLCcH/kBIxKZFjivP2zE6uZmLw9lG hwx9mCjDD/vHvpzFVM7GKlMIVM7lIrr9RkWmd5HiIBfeMgA6ohbgl/owfudML0sOkLqw+c +omzLPb7B1YCwfP4XSPqgVns3aSu3qC4Eaz/fVjPGVKFvbGBCjq89hCeD57F+HTywf6ct2 hARIx24XDoj1RPCAOUCaJfkng37IAXFj615nmaK4kWwReV8G9L3m3d9+FYn+6A== X-Migadu-Spam-Score: -5.88 X-Spam-Score: -5.88 X-Migadu-Queue-Id: E7FBC211F8 X-Migadu-Scanner: scn0.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=Qh1E8AWM; dmarc=pass (policy=none) header.from=posteo.net; 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-TUID: 3ZJEYBLTsYNb Philip Kaludercic writes: >> We discussed possible syntax of inline custom markup to be added. See >> https://orgmode.org/list/87bkqx4jyg.fsf@localhost Someone is to go ahead >> and try to implement it. It might be me in future, but I am prioritizing >> working on some other new features in Org for now. > > My general question is what advantage this would provide over just using > TeXinfo in the first place, if the required complexity of the markup has > to be the same as for TeXinfo in the first place? Check out the original thread where RMS officially suggested that Org can be used instead of texinfo. In short, Org provides much more configurable export output. You can customize it using Elisp or within Org document itself. You can generate parts of documentation using output of src blocks. You can fine-tune specific export output formats using inline export blocks. etc ... -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at