From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jonas Bernoulli Newsgroups: gmane.emacs.devel Subject: Re: Transient manual Date: Wed, 30 Aug 2023 02:10:18 +0200 Message-ID: <875y4xfl05.fsf@bernoul.li> References: <87cyz6wtja.fsf.ref@yahoo.com> <87cyz6wtja.fsf@yahoo.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="38210"; mail-complaints-to="usenet@ciao.gmane.io" To: Po Lu , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Aug 30 04:18:38 2023 Return-path: Envelope-to: ged-emacs-devel@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 1qbAn0-0009hm-5u for ged-emacs-devel@m.gmane-mx.org; Wed, 30 Aug 2023 04:18:38 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qbAmF-00059m-NF; Tue, 29 Aug 2023 22:17:51 -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 1qb8my-0002x2-8S for emacs-devel@gnu.org; Tue, 29 Aug 2023 20:10:28 -0400 Original-Received: from mail.hostpark.net ([212.243.197.30]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qb8mu-0002Kn-R8 for emacs-devel@gnu.org; Tue, 29 Aug 2023 20:10:28 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by mail.hostpark.net (Postfix) with ESMTP id 8FCEF164B7; Wed, 30 Aug 2023 02:10:19 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=bernoul.li; h= content-type:content-type:mime-version:message-id:date:date :references:in-reply-to:subject:subject:from:from; s=sel2011a; t=1693354219; bh=94pE27erN9n7kCVIYMNInVCzX+WsUsWCRSSsYBmJv0w=; b= w9GfEc71S9sn9Hqt0iAmgZdr/BZ7JEjABunUHDey2D7++9K/1KrI0WOceBO0BXqW wVOyY95RMCti1m3sOOTAPNSpwDQl79MMt0zMNwGrlbO5JLNhFP8+5kFaq5xYmnlC /5v0XeHPpSTnzFWnBiOpBW1tx5SsE0DyTWQtU1rDXaQ= X-Virus-Scanned: by Hostpark/NetZone Mailprotection at hostpark.net Original-Received: from mail.hostpark.net ([127.0.0.1]) by localhost (mail0.hostpark.net [127.0.0.1]) (amavisd-new, port 10224) with ESMTP id ny6YKMHyW0mH; Wed, 30 Aug 2023 02:10:19 +0200 (CEST) Original-Received: from customer (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mail.hostpark.net (Postfix) with ESMTPSA id 42629164B4; Wed, 30 Aug 2023 02:10:19 +0200 (CEST) In-Reply-To: <87cyz6wtja.fsf@yahoo.com> Received-SPF: pass client-ip=212.243.197.30; envelope-from=jonas@bernoul.li; helo=mail.hostpark.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.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, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Tue, 29 Aug 2023 22:17:48 -0400 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:309524 Archived-At: Po Lu writes: > The recently imported Transient manual fails to compile as part of > Emacs, because it relies on features absent from Texinfo 4.13. For > example, it presumes that Makeinfo is capable of extrapolating the Up > fields of each node on the basis of an implicitly generated menu. Some time ago I also noticed that exporting from org to texi suddenly stopped generating certain menus. I looked at the history of org and ox-texinfo.el in particular, but could not find a code change that would explain that change in behavior. I resorted to manually discarding the removal of these menus whenever I regenerated the manual, planning to eventually investigate further. I never got around to it and apparently I wasn't paying attention one time and committed the removal of the menus. > There are some other difficulties I spotted, such as the use of Unicode > quotes rather than `` and '', and so on. I've changed the org to texi transformation to use ``...''. > I will fix these issues on master, but would the Transient developers > take care to avoid these pitfalls in the future? There are several > machines I use for Emacs development where anything newer than Texinfo > 4.13 is unobtanium, consequent of difficulties with their Perl > installations. I tried but failed. I'll ask the org developers for help to avoid that in the future. (Texinfo 4.13 is very old. It was released on 2008-09-18. The current release is 7.0.3. I don't know how much longer we should support such an ancient version because some machines are stuck on a release from 15 years ago.)