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

[James Thomas <jimjoe@gmx.net>]

James Thomas wrote:

> Eli Zaretskii wrote:
>
>>> Eli Zaretskii 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 said, if the "built-in function" part is a general pattern, we
>> could change the regexps in info-look.el to use that to our advantage;
>> patches welcome.
>
> Indeed, but I don't know this (FTR there's also 'module', 'operator' and
> a few others alongside).

FWIW I work around it now in the mode, with:

(info-lookup-add-help
 :doc-spec
 '(("(python3.12)Index" (lambda (item) (string-trim-left item ".*?; ")))))

I think I'll send in a patch (with a few tweaks) soon.

--