From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Ihor Radchenko Newsgroups: gmane.emacs.orgmode,gmane.emacs.help Subject: Re: org-mode for package documentation Date: Mon, 29 May 2023 08:26:06 +0000 Message-ID: <87a5xnwnkx.fsf@localhost> References: <877csszoy6.fsf@gmail.com> <87pm6jtvwz.fsf@localhost> <87mt1n372h.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13121"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Payas Relekar , =?utf-8?Q?Bj=C3=B6rn?= Bidar , Christopher Dimech , Help Emacs Orgmode , Help Gnu Emacs To: Philip Kaludercic Original-X-From: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org Mon May 29 10:27:22 2023 Return-path: Envelope-to: geo-emacs-orgmode@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1q3YDp-0003C8-Ki for geo-emacs-orgmode@m.gmane-mx.org; Mon, 29 May 2023 10:27:21 +0200 Original-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 Original-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 Original-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 Original-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== Original-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) In-Reply-To: <87mt1n372h.fsf@posteo.net> 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+geo-emacs-orgmode=m.gmane-mx.org@gnu.org Original-Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.orgmode:155149 gmane.emacs.help:143784 Archived-At: 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