From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Philip Kaludercic Newsgroups: gmane.emacs.orgmode,gmane.emacs.help Subject: Re: org-mode for package documentation Date: Sun, 28 May 2023 11:08:07 +0000 Message-ID: <87bki4zpbc.fsf@posteo.net> References: <87bkj7g1ed.fsf@posteo.net> <87leh97kwl.fsf@thaodan.de> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="6338"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Christopher Dimech , Help Emacs Orgmode , Help Gnu Emacs To: =?utf-8?Q?Bj=C3=B6rn?= Bidar Original-X-From: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org Sun May 28 13:09:08 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 1q3EGo-0001QR-L1 for geo-emacs-orgmode@m.gmane-mx.org; Sun, 28 May 2023 13:09:06 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1q3EFy-0002zm-C7; Sun, 28 May 2023 07:08:14 -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 1q3EFw-0002yR-Tn for emacs-orgmode@gnu.org; Sun, 28 May 2023 07:08:12 -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 1q3EFv-0004Ql-CI for emacs-orgmode@gnu.org; Sun, 28 May 2023 07:08:12 -0400 Original-Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id F3F74240027 for ; Sun, 28 May 2023 13:08:07 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1685272088; bh=BiRlEyP0aMWpG7laHGb87RJGsBjPtFZsWsMSKM3KA2g=; h=From:To:Cc:Subject:Autocrypt:Date:Message-ID:MIME-Version: Content-Transfer-Encoding:From; b=dio75+ve+Vzep4YInsnxO7loqbm0O1FWh8/gi5ou9mnYgLBobj4YoSUKQFYCFnnrS cNr4H4t/0jVjU9HI7IPDuTjqL86fL3EgFdTbonFYK+bNrTPur/QVJFF/XUS5Zfoo8K mSQuN994QAqn/TkW6rTYoHiVdrMOBiGkEaDgITLxzSCfFVp5Egus/FgcyHB1/LqjUb h3wQU9Mh3WgWp24QetobIN2JHI5S2glfFtg9kvq/Y157eC/8nkbcN4/PDpBDbtmLO/ oTaRmKAxuG9vcDFg3gTqspB5ivTY+nx2g+JXjMRvrbcmypp5kGFeo/j9btq2LNMI3a cZVCSO9GSZo2A== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4QTbVb3dfbz6tm4; Sun, 28 May 2023 13:08:07 +0200 (CEST) In-Reply-To: <87leh97kwl.fsf@thaodan.de> (=?utf-8?Q?=22Bj=C3=B6rn?= Bidar"'s message of "Sat, 27 May 2023 20:18:34 +0300") Autocrypt: addr=philipk@posteo.net; keydata= mDMEZBBQQhYJKwYBBAHaRw8BAQdAHJuofBrfqFh12uQu0Yi7mrl525F28eTmwUDflFNmdui0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiWBBMWCAA+FiEEDg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwMFCQHhM4AFCwkI BwIGFQoJCAsCBBYCAwECHgECF4AACgkQ8xYDWXahwulikAEA77hloUiSrXgFkUVJhlKBpLCHUjA0 mWZ9j9w5d08+jVwBAK6c4iGP7j+/PhbkxaEKa4V3MzIl7zJkcNNjHCXmvFcEuDgEZBBQQhIKKwYB BAGXVQEFAQEHQI5NLiLRjZy3OfSt1dhCmFyn+fN/QKELUYQetiaoe+MMAwEIB4h+BBgWCAAmFiEE Dg7HY17ghYlni8XN8xYDWXahwukFAmQQUEICGwwFCQHhM4AACgkQ8xYDWXahwukm+wEA8cml4JpK NeAu65rg+auKrPOP6TP/4YWRCTIvuYDm0joBALw98AMz7/qMHvSCeU/hw9PL6u6R2EScxtpKnWof z4oM Received-SPF: pass client-ip=185.67.36.65; envelope-from=philipk@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:155130 gmane.emacs.help:143775 Archived-At: Bj=C3=B6rn Bidar writes: > Philip Kaludercic writes: > >> Christopher Dimech writes: >> >>> Dear Compeers, >>> >>> Some months ago there had been a discussion about using org-mode >>> to produce package documentation. Which would allow the use of=20=20 >>> Latex3 (e.g. use of colour, floating images). >> >> Where/when did this happen? Could you provide a few pointers? > > I don't know exactly but when use-package was merged into Emacs there > were discussions if keeping the documentation in org-mode format is > fine. > > From what I understood it is possible. Using org-mode to generate TeXinfo manuals is already possible, due to the ox-texinfo backend, but I haven't been personally that satisfied with the quality of the output, due to the lack of (easy) support for the fine distinctions in markup that texinfo provides. That is why the use-package documentation had to be translated from org-mode to texinfo, which was part of the reason the process of merging took so long.