Re: Transient manual

[Jonas Bernoulli <jonas@bernoul.li>]

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.)