Re: Integration of Info manuals in programming modes, Re: Integration of Info manuals in programming modes

[Eli Zaretskii]

> From: Björn Bidar <bjorn.bidar@thaodan.de>
> Cc: James Thomas <jimjoe@gmx.net>,  emacs-devel@gnu.org
> Date: Sun, 08 Dec 2024 22:10:59 +0200
> 
> Eli Zaretskii <eliz@gnu.org> writes:
> 
> >> From: James Thomas <jimjoe@gmx.net>
> >> Date: Sun, 08 Dec 2024 13:43:58 +0530
> >> 
> >> Eli Zaretskii <eliz@gnu.org> writes:
> >> 
> >> >> One thing where Info is on-topic here are Emacs integrations.
> >> >>
> >> >> I remember how useful it was when I had texinfo links directly
> >> >> available in Emacs:
> >> >> https://www.draketo.de/light/english/free-software/read-your-python-module-documentation-emacs
> >> >
> >> > Sorry, I don't understand: info-look.el already supports "C-h S" for
> >> > Python code, assuming you have a Python manual in Info format
> >> > installed.
> >> 
> >> Just wanna chime in that this is not perfect, for other reasons: For
> >> e.g. 'C-h S' on 'print' does not give the index item "* built-in
> >> function; print" because, as you can see, it's not named appropriately
> >> in Sphinx's generation.
> >
> > Please report that to whoever maintains the Python manual or Sphinx.
> > info-look.el can fix many problems in the manuals, but not all of
> > them.
> 
> That's a good idea. I want to add to context that Sphinx plugins can
> break the Info output entirely.
> 
> I think it would be worth from Gnu put resources into improving the
> Texinfo output in Sphinx as it is so wide used by many projects and thus
> can provide the most manuals outside the Gnu project right now.

This should be taken up with the Texinfo developers.  Not sure they
will be prepared to do that, but it's their call.