bug#31405: 25.3; Python.el doesn't provide infos to info-lookup-symbol

[Basil L. Contovounesios]

Lars Ingebrigtsen <larsi@gnus.org> writes:

> Stefan Kangas <stefan@marxist.se> writes:
>
>> Sphinx is used to generate Python docs AFAIK, and it supports info
>> format output.  There is also the MELPA package python-info which is
>> "a simple Emacs package to provide an info manual for Python":
>>
>> https://github.com/wilfred/python-info
>>
>> Perhaps we should support that use case in vanilla Emacs?  One can
>> always hope that more GNU/Linux distributions takes the hint and
>> starts generating and shipping the info files for Python.  (And that
>> interested users files bugs with their respective GNU/Linux
>> distribution, Homebrew for OSX, etc. if they don't already do that.)
>
> The Melpa package doesn't seem to exist any more?  So I'm guessing there
> isn't much demand for an Info manual for Python, so adding support for
> it in info-look would just be frustrating the users, I think.
>
> On the other hand, you have a point that if Emacs did provide hooks into
> Info, then perhaps it'd entice people to start distributing .info
> files...

FWIW, Debian packages the latest Python Info manual as python3-doc.

> Hm...
>
> Oh!  I was looking in melpa-stable -- python-info is indeed in melpa.

Yes, but at first glance it seems to be specific to Python 2 and hasn't
been updated in 6 years.

> OK, I've now added support for python-mode in info-lookup-symbol, and
> seems to work in my one test, which was looking up "date", which took me
> to:
>
>  -- Class: datetime.date (year, month, day)
>
>      All arguments are required.  Arguments may be ints or longs, in the
>      following ranges:
>
> Which seems correct.  People who actually use Python should probably
> change 
>
> (info-lookup-maybe-add-help
>  :mode 'python-mode
>  :doc-spec '(("(python)Index")))
>
> to something that filters/matches more accurately, perhaps.

In my case I have to override it as

  (with-eval-after-load 'info-look
    (info-lookup-add-help
     :mode 'python-mode
     :doc-spec '(("(python3.9)Index"))))

to match the name and version of the manual installed by Debian.

Thanks,

-- 
Basil