From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Tomas Nordin Newsgroups: gmane.emacs.bugs Subject: bug#45348: 27.1; python-eldoc-setup-code uses obsolete python function Date: Mon, 28 Dec 2020 17:19:38 +0100 Message-ID: <87zh1x6gyt.fsf@posteo.net> References: <197a8432-07fd-4639-e504-0fde30d3f088@gmail.com> <877dp8dqpp.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1724"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Steven De Herdt , 45348@debbugs.gnu.org To: =?UTF-8?Q?Jo=C3=A3o_?= =?UTF-8?Q?T=C3=A1vora?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Dec 28 17:20:30 2020 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 1ktvG1-0000KS-Qq for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 28 Dec 2020 17:20:29 +0100 Original-Received: from localhost ([::1]:39736 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ktvG0-0006C9-7N for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 28 Dec 2020 11:20:28 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35792) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ktvFa-0006Bz-Oc for bug-gnu-emacs@gnu.org; Mon, 28 Dec 2020 11:20:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53273) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ktvFa-0006lU-HG for bug-gnu-emacs@gnu.org; Mon, 28 Dec 2020 11:20:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ktvFa-0003VP-B3 for bug-gnu-emacs@gnu.org; Mon, 28 Dec 2020 11:20:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Tomas Nordin Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 28 Dec 2020 16:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 45348 X-GNU-PR-Package: emacs Original-Received: via spool by 45348-submit@debbugs.gnu.org id=B45348.160917238913450 (code B ref 45348); Mon, 28 Dec 2020 16:20:02 +0000 Original-Received: (at 45348) by debbugs.gnu.org; 28 Dec 2020 16:19:49 +0000 Original-Received: from localhost ([127.0.0.1]:36586 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ktvFN-0003Us-7R for submit@debbugs.gnu.org; Mon, 28 Dec 2020 11:19:49 -0500 Original-Received: from mout01.posteo.de ([185.67.36.65]:58916) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ktvFK-0003Ua-2n for 45348@debbugs.gnu.org; Mon, 28 Dec 2020 11:19:48 -0500 Original-Received: from submission (posteo.de [89.146.220.130]) by mout01.posteo.de (Postfix) with ESMTPS id 783DE160061 for <45348@debbugs.gnu.org>; Mon, 28 Dec 2020 17:19:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1609172379; bh=aqdVr1KB22tFOB8NMRWHwu5b90xQov36O1+4pF2fh6c=; h=From:To:Cc:Subject:Date:From; b=YZ+/cuvhlEqAMFYfYKJrKwU/ldkarBGWFyRJtUslKEGqWlDC3PRVg6hjyOqwe1+Fh e7SYx63FmxK5d3nrvdb3Om47KIds+KOdd3sLQmgYSzqnzqRNV9fXLHSvfZ4Vknz/BQ N9pu1jhN5c++ORyXgnDgZE9GX/mSI7gD3YQ1bFacE2MZxKmVbm5p+cSnlV1xL/c80G FMCsXHo3EIVLHV6uYMrZeds5vM9aOs8WXwZ9A1cU9+KLu11t/ikHb6dSpbMUwWBjQ2 kZBnc2hx9giT/KvTxK0fLT5/tuRvTG78Z3aQMZrPvTpy+DKt57eJ7rsRS4pVQa6lLm DZ0vqkSV00j9w== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4D4N6f5SSfz6tmL; Mon, 28 Dec 2020 17:19:38 +0100 (CET) In-Reply-To: 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:196872 Archived-At: Jo=C3=A3o T=C3=A1vora writes: > On Wed, Dec 23, 2020, 23:54 Tomas Nordin wrote: > >> >> Meaning, if there is a docstring, we will not get the call signature, >> we get that only when there is no docstring. Personally I would prefer >> the call signature always, like in elisp. Then perhaps when doing C-c >> C-f (python-eldoc-at-point) show the (full) docstring. But that would be >> another bug-report I guess. >> > > If you think you can program this, the latest ElDoc allows you to do just > that. See the docstrings of eldoc-documentation-functions, > eldoc-documentation-strategy, eldoc-display-functions and other variables > prefixed eldoc-echo-area. Also see the new interactive command M-x eldoc. > > All of those things have been touched recently by me, and I'd appreciate > the feedback. OK, thanks. Then we know the API to read up on when it comes to that. I would be happy to try and help improving the doc support in python.el. The strategy I would suggest to do that would be -- C-c C-d python-describe-at-point Make this display full documentation akin to C-h f in elisp. Document this function to do so, currently it is un-documented. And current effect is to leave the help text in the python shell, which works sometimes. -- C-c C-f python-eldoc-at-point Make this output the first line of docstring, if there is no docstring show nothing. This is almost what happens now, only if there is no docstring the signature is given instead. -- Automatic help display of objects Make this show signatures always. (akin to elisp mode). But I don't know if anybody care to see this happen. Best regards -- Tomas