From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: martin rudalics Newsgroups: gmane.emacs.bugs Subject: bug#43609: 28.0.50; eldoc-documentation-function Date: Wed, 30 Sep 2020 10:14:56 +0200 Message-ID: References: <2e610c3f-6e5f-c7dd-af2e-aeb5e20d8664@gmx.at> <89a118cf-65e1-5e9f-0884-577a52ca115e@gmx.at> <74e25bf7-e7ad-a0e7-3fe5-36ea6afbace5@gmx.at> <82a64fee-ecdc-a24f-891a-c1ad04ed7f78@yandex.ru> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15672"; mail-complaints-to="usenet@ciao.gmane.io" To: Dmitry Gutov , 43609@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Sep 30 10:16:40 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 1kNXHz-0003y8-T2 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 30 Sep 2020 10:16:39 +0200 Original-Received: from localhost ([::1]:59148 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kNXHy-0007tK-PD for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 30 Sep 2020 04:16:39 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47462) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kNXHO-0007sP-Az for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:16:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46499) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kNXHO-0006EW-1v for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:16:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kNXHN-0004XI-T0 for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:16:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 30 Sep 2020 08:16:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43609 X-GNU-PR-Package: emacs Original-Received: via spool by 43609-submit@debbugs.gnu.org id=B43609.160145370717358 (code B ref 43609); Wed, 30 Sep 2020 08:16:01 +0000 Original-Received: (at 43609) by debbugs.gnu.org; 30 Sep 2020 08:15:07 +0000 Original-Received: from localhost ([127.0.0.1]:58042 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kNXGU-0004Vu-Ss for submit@debbugs.gnu.org; Wed, 30 Sep 2020 04:15:07 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:35357) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kNXGS-0004V3-RH for 43609@debbugs.gnu.org; Wed, 30 Sep 2020 04:15:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1601453698; bh=sjtzcZ0PYzSI9zDAeyKLgsy0AeG0p2Aabfx33kQZlhM=; h=X-UI-Sender-Class:Subject:To:References:From:Date:In-Reply-To; b=AvF5lnCHjQR6mS37Y6RmDapAqqbuz3PghnYfoO9yDFfs3k+VBulqxU40G+d6G/efY FdvjDR9lD9CjDbPFuMX4hGpkv4y+UuwQwZh05csroNcKajp79i9tGdxb7mn9GFgX35 oYNetXYe5y91IaBJuBJCxFnIar72kXscBglTPNMI= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([46.125.249.105]) by mail.gmx.com (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MOiDX-1k3V2z2Srf-00QDnQ; Wed, 30 Sep 2020 10:14:58 +0200 In-Reply-To: <82a64fee-ecdc-a24f-891a-c1ad04ed7f78@yandex.ru> Content-Language: en-US X-Provags-ID: V03:K1:35hgDbpZBhl6F9mnE1rPgbQRoOXX0sWY3VPWuaB5McH+8y6AQ30 lRy2XwacVTu8Jp9bfIMJLov1A4oimBruYnL9INUPeFzWZG2DGrHGQ92U75vtZYsvl7VYXlh x7Zkzee69Gs3uLCJI/4DtdIPNClzFtLqgV/lTrBtOnpjHqsa2VEG7ijXd1T7TM67GF1AuQD znnRLj9LnqWwDYyRRl3pA== X-UI-Out-Filterresults: notjunk:1;V03:K0:bnD2Rj7SDu8=:QNbKaCyqC/2pG2YRj/dhCN YfYB6OSMKPCFd9Uh9rrrkhlBKiui690sSB7b/XuusjmQJTteOlz8AA8ia0sJuSbv6wFzWSnu0 NuVmy14IdqSoNjtKb6bMXg+Q8iYlQRlJR+rAHsVcGS0d8x9O5lNgAbRdc+vFtRFGVQniso6uY bC69oqTVKPIsUr551/Yh92/HgUPpTz0imifAmQuS8fPPgr27csoSZaN3z9TmxZOZmenodLL4v jGgpph2ZnN38PzhffZv4CW9NGdWc6cpYgqh5SO+7+B998c8XIFyOZo3ISebOrGJh3+tFVgXgt VOD7sjkfDZaC4n6+CPJ3WdvfTdpB4zw6fBmPuVVruRdHAfGzqNnpEoHKPQ+CbPjPmQfXAOjJa yyvm8v8HAP0QQzYEMtbrWM6WlH6OnomAmHih0HEHNVPrVz7klxsWVVH+h+Bs/Uhw/AJWDaeP6 szwR5Fq3BUN3kQ9UsnoqRQSZhHBDAmocq97cV5xWidqDr65V6z7U7choooEncruG/nMVzLiRc ATr+Up65P5b6G2/lSWuK60V6oBOC6L9GR/CCn/cfM5X9dSkMDIdIm79NtjP8EhYfMxZctuc78 r8+Gr0F/mc+ECNvlPcy4nJjjjk5I3QBGA3fkWt+fTVd2Il9xG18TIuLRaSu5gLLIRETbNCPx1 n7iJpsGMNVoZHKqPDqZzxJfBUA0C1dBjtQNazsQbHOcZgFw5pv4AGL0a73nSeU1snw7c9YEyp GdL/JWwsm/3yCl4ml5hanyQj5s1nGvwTCcXrUukkf0gajEMxKIeRPNlc3kFYdrC6/3RZMXsu 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:189317 Archived-At: >> So 'eldoc-documentation-functions' just holds a list of functions I >> could call in order to get the documentation of the object at point? >> How does the notion of a "hook" enter here? > > It's a list that is usually manipulated with 'add-hook'. Like it often done with other variables named '*-functions'. Its value is (elisp-eldoc-var-docstring elisp-eldoc-funcall t). So what am I supposed to do with that? I would have to call these functions in row with some function as callback argument that also handles the :thing and :face stuff and produces and returns the doc string. >> > No, the hook functions are written already. They are basically a list >> > of functions that were previously the values of >> > eldoc-documentation-function. Except it's now a list. *And* they use >> > an asynchronous convention where the first argument they receive is a >> > callback. >> >> Is there a way to drop that callback? I just want an immediate answer. > > With my proposal, there would have been. See the original discussion. So there's no way to drop that callback and get an immediate answer. Bad to know. >> 'eldoc-documentation-strategy' is a variable so it's probably the >> function that is the value of that variable and it should suffice to use >> 'eldoc-documentation-default'. But this failed here before. > > You should probably honor this variable, if the expectation is to generally follow ElDoc's behavior but display the documentation in a different place, e.g. using a popup. Plain (funcall eldoc-documentation-strategy) gets me the already familiar (void-function nil) error. martin