emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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


From: James Thomas
Subject: Re: Integration of Info manuals in programming modes, Re: Integration of Info manuals in programming modes
Date: Sun, 08 Dec 2024 14:08:25 +0530
User-agent: Gnus/5.13 (Gnus v5.13)

James Thomas <jimjoe@gmx.net> writes:

> 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.
>
>> What other GNU programming packages which have Info manuals and
>> suitable Emacs major modes are not supported by info-look.el?
>
> Speaking about python, many libraries (such as PyTorch & NumPy) use
> Sphinx, but the info generation has bug when it uses 'numpydoc' that
> requires a little manual fixing of the .texi.

And a PSA for anyone who wants to use these:

Set 'Info-hide-note-references' to 'hide' to get rid of the "see" before
every link.

--



reply via email to

[Prev in Thread] Current Thread [Next in Thread]