[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Transient manual
From: |
Jonas Bernoulli |
Subject: |
Re: Transient manual |
Date: |
Wed, 30 Aug 2023 02:10:18 +0200 |
Po Lu <luangruo@yahoo.com> 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.)