From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Basil L. Contovounesios" via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#31405: 25.3; Python.el doesn't provide infos to info-lookup-symbol Date: Thu, 12 Aug 2021 16:13:34 +0100 Message-ID: <871r6yd7c1.fsf@tcd.ie> References: <8736yz4jp9.fsf@k-7.ch> <87k0kqkayt.fsf@gnus.org> Reply-To: "Basil L. Contovounesios" Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="27248"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: seb@k-7.ch, Stefan Kangas , Noam Postavsky , 31405@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Aug 12 17:14:09 2021 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1mECPJ-0006s2-2G for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 12 Aug 2021 17:14:09 +0200 Original-Received: from localhost ([::1]:32962 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mECPH-0003g9-S8 for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 12 Aug 2021 11:14:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35448) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mECPC-0003fu-4N for bug-gnu-emacs@gnu.org; Thu, 12 Aug 2021 11:14:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:56419) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mECPB-0004Ev-Ud for bug-gnu-emacs@gnu.org; Thu, 12 Aug 2021 11:14:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mECPB-0004vU-PU for bug-gnu-emacs@gnu.org; Thu, 12 Aug 2021 11:14:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 12 Aug 2021 15:14:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31405 X-GNU-PR-Package: emacs Original-Received: via spool by 31405-submit@debbugs.gnu.org id=B31405.162878123218910 (code B ref 31405); Thu, 12 Aug 2021 15:14:01 +0000 Original-Received: (at 31405) by debbugs.gnu.org; 12 Aug 2021 15:13:52 +0000 Original-Received: from localhost ([127.0.0.1]:39732 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mECOy-0004ur-9x for submit@debbugs.gnu.org; Thu, 12 Aug 2021 11:13:52 -0400 Original-Received: from mail-wr1-f48.google.com ([209.85.221.48]:44832) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mECOs-0004ub-Tb for 31405@debbugs.gnu.org; Thu, 12 Aug 2021 11:13:47 -0400 Original-Received: by mail-wr1-f48.google.com with SMTP id x12so8794088wrr.11 for <31405@debbugs.gnu.org>; Thu, 12 Aug 2021 08:13:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd.ie; s=google21; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=kZ2nS6iIEUe8DjANsuDc4NcnEn4WBqu9H3V0NcqBl/4=; b=Me0s0u8qndB/aUhg8BQLPz9DFpVNkljIL4yABbq/+Vvgk6x/5PqyM/GbdvUfwitS0a ROxZCnGM/6Hh/W2XVlfnmTqJfsyq2EaNe7XzQ0DjkG5tl8lxLeBwzI781PSv6OyUvbG7 eV/zROesAmZ7gW1xt18uMxS9uRWqKU83nW89IV+FUxqrCyhOYgM6QMFw4IfgBr0Agw07 g/GH/8ke8vGKkNOITKxIo+oLz3S/bAmyy+KAQAv8lg1Mq4qQhJ5JiO4/jLt1FKNbEJ3o c9zj9r7w2kwib1t/pbCVp24ZiIKHUmSOEexmgbaxf6bKlHawdU9INO+EbEUZDrWP1b+v 2ZRA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=kZ2nS6iIEUe8DjANsuDc4NcnEn4WBqu9H3V0NcqBl/4=; b=gVG2NBmSQGb5a0h3/ciSXGtXmvkpGsUypNFTKHGDBUS42U4VYvIVbc9S9VOtnF/RUs UBiw7JPSCd3kaF/ZrzaghPGASle3bcyak9WWExYrwXBkSTeEcJW59zino/xWLKT9twh3 ALLBnprI1a9Gpip8Uvrwcy5xcX20RNVL0yM/S5ZGPWOqW8n2yaIkzisgHZ2qJOvXz+mq U6axUkKX4H7S7Tetlf9VMTz+y/AWiaTsk2vKByg4uPJsx/tZSM2jtHUeU0u4cJ640l7l tNaB1z0okGOiPneEXkTylXBY/s3zVVaDN2zmKCB2qb8F9029Y80BdQhVGfiGa/7nZOAx /zKA== X-Gm-Message-State: AOAM53139Sayec7mQKkQt5Dpf9HYfWh3tdseS4VDwNMMr4qYPSwMaL+Z JhvMpixTlEmeMUvu09kG6gwpNA== X-Google-Smtp-Source: ABdhPJwHQ/Fg13mDIIGkW3fEHCwTlaaHwUaGEF343+e4WynqD65LSMTVFnnwJeAH6bS+IxhRZuSZmg== X-Received: by 2002:adf:ed8f:: with SMTP id c15mr1337248wro.351.1628781216662; Thu, 12 Aug 2021 08:13:36 -0700 (PDT) Original-Received: from localhost ([2a02:8084:20e2:c380:f410:82e8:3a21:eedf]) by smtp.gmail.com with ESMTPSA id l7sm3146456wmj.9.2021.08.12.08.13.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 12 Aug 2021 08:13:36 -0700 (PDT) In-Reply-To: <87k0kqkayt.fsf@gnus.org> (Lars Ingebrigtsen's message of "Thu, 12 Aug 2021 16:13:14 +0200") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:211695 Archived-At: Lars Ingebrigtsen writes: > Stefan Kangas 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