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

[Björn Bidar]

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.