From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.bugs Subject: bug#53316: 28.0.91; Missing Transient manual in Emacs Date: Sat, 19 Feb 2022 04:27:27 -0500 Message-ID: <66mtin2olc.fsf@fencepost.gnu.org> References: <87o845s4xv.fsf@gnus.org> <87iltgcbqx.fsf@bernoul.li> <87tuczdcqo.fsf@bernoul.li> <6ar182selo.fsf@fencepost.gnu.org> <83r182105v.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33661"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) Cc: larsi@gnus.org, p.stephani2@gmail.com, jonas@bernoul.li, 53316@debbugs.gnu.org To: Richard Stallman Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Feb 19 10:28:48 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1nLM2q-0008a9-6Y for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 19 Feb 2022 10:28:48 +0100 Original-Received: from localhost ([::1]:40860 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nLM2o-0003Pl-3C for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 19 Feb 2022 04:28:46 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:56510) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nLM2O-0003Pc-NL for bug-gnu-emacs@gnu.org; Sat, 19 Feb 2022 04:28:21 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:34759) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nLM25-0001vR-Tu for bug-gnu-emacs@gnu.org; Sat, 19 Feb 2022 04:28:14 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nLM25-0000cl-Rn for bug-gnu-emacs@gnu.org; Sat, 19 Feb 2022 04:28:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Glenn Morris Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 19 Feb 2022 09:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53316 X-GNU-PR-Package: emacs Original-Received: via spool by 53316-submit@debbugs.gnu.org id=B53316.16452628602370 (code B ref 53316); Sat, 19 Feb 2022 09:28:01 +0000 Original-Received: (at 53316) by debbugs.gnu.org; 19 Feb 2022 09:27:40 +0000 Original-Received: from localhost ([127.0.0.1]:56889 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nLM1k-0000cA-24 for submit@debbugs.gnu.org; Sat, 19 Feb 2022 04:27:40 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:48838) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nLM1i-0000bw-EZ for 53316@debbugs.gnu.org; Sat, 19 Feb 2022 04:27:38 -0500 Original-Received: from [2001:470:142:3::e] (port=54616 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nLM1c-0001ky-CX; Sat, 19 Feb 2022 04:27:32 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=2YGZqQTCWO4SFeFgVGbz9HkTIDLxxxP2W6V+Osx3mC8=; b=g2GACA9bvgCkc3OWpnLV W3dWLMAmB4U3No/AOfhmGzN4ku2bzVofVgBg9KIkHrBL1c8kVusRTMFl5sIImNV8N23He5q61zT/2 jlXTe8EULZrOQdLcMChlj86ojzggl1Bd0HKgNZQ6937vc1a2hTDyi4IHUrFd+aas38b7H0T7hxAA8 GjuCuciEDyusTOEtT7eEnbLoj9aVkvELlcSiB1lrp/jWFrLFu1B6En5e9bhxH8Kqv75QUh7l25yBd xcHp5bWx0cB8GG24fBB310nBXQWBtG255iiqq6HC3opDwcxySrLDhqT8U7ullMjbMlMmbLP868eNl r3abIakAxL5GFg==; Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1nLM1X-00041l-KA; Sat, 19 Feb 2022 04:27:29 -0500 X-Spook: SSCI SADF Secure Internet BART Majic Attorney General X-Ran: ^s6?gMkA{;lRpO1ki|-[1,%DwL%iyrL (Richard Stallman's message of "Fri, 18 Feb 2022 23:57:42 -0500") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:227176 Archived-At: My summary would be: Transient is an Emacs library developed externally to Emacs. A copy has now been added to Emacs for Emacs 28. (I assume there is no intent to move development to Emacs.) It has a manual written in Org format. The Texinfo file is automatically generated from that Org source. Originally the Transient manual was not in Emacs at all. Now the generated Texinfo file has been added to Emacs, but not the original Org source. I previously reported a similar case as Subject: bug#45143: Missing source for some doc/misc manuals? for the manuals for Org and Modus Themes. You commented in several messages in Feb 2021, such as Message-Id: Message-Id: Since the generated transient.texi file was added to Emacs, it has been manually edited, because, as was already known, Texi-generated-from-Org isn't as good as hand-written Texi. (I assume there is no intent for the upstream Transient to switch its manual from being written in Org to being written in Texinfo, in the same way that neither Org nor Modus Themes did.) To resolve bug#45143, I implemented Make machinery in Emacs to generate .texi files for those manuals from their Org sources. (Sadly these changes were not included in Emacs 27.2, so that release does not IMO include the preferred form for the Org manual.) Apparently generating transient.texi from transient.org requires some changes to Org itself, which currently only exist in upstream Org, not in Emacs master or release branch. So it isn't possible to generate the texi file for this package with just the Emacs sources.