From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#43609: 28.0.50; eldoc-documentation-function Date: Wed, 30 Sep 2020 11:50:46 +0300 Message-ID: <4fa76682-9fc6-ee65-3b77-0f6a63e6b672@yandex.ru> 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: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9672"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 Cc: =?UTF-8?Q?Jo=C3=A3o_?= =?UTF-8?Q?T=C3=A1vora?= , Stefan Monnier To: martin rudalics , 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:51:28 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 1kNXpg-0002Q1-9g for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 30 Sep 2020 10:51:28 +0200 Original-Received: from localhost ([::1]:40606 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kNXpf-0007ik-5d for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 30 Sep 2020 04:51:27 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53876) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kNXpG-0007iZ-QA for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:51:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:46554) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kNXpG-0008VW-Eu for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:51:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kNXpG-0005OC-DV for bug-gnu-emacs@gnu.org; Wed, 30 Sep 2020 04:51:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 30 Sep 2020 08:51:02 +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.160145585820706 (code B ref 43609); Wed, 30 Sep 2020 08:51:02 +0000 Original-Received: (at 43609) by debbugs.gnu.org; 30 Sep 2020 08:50:58 +0000 Original-Received: from localhost ([127.0.0.1]:58100 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kNXpB-0005Nu-Q9 for submit@debbugs.gnu.org; Wed, 30 Sep 2020 04:50:57 -0400 Original-Received: from mail-ej1-f42.google.com ([209.85.218.42]:37274) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kNXpA-0005Nh-RJ for 43609@debbugs.gnu.org; Wed, 30 Sep 2020 04:50:57 -0400 Original-Received: by mail-ej1-f42.google.com with SMTP id nw23so1647297ejb.4 for <43609@debbugs.gnu.org>; Wed, 30 Sep 2020 01:50:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:references:cc:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=q2YUSU7qTAed98w4qscgq0kKPDZG4QWuyti/4mTkuTM=; b=Qh9CJs+hP6jlLa7L/L3UhsfkVjbKpTYFLqbkoQEsFEWl33eM66QVR0ZWeBxFTuAdYV hUgQvlLY5jH1SBYSZBXFmq8+8AhTo0ZxdQD6x+vI8Fws7vmq4ZCTJRw4cWzkXaKF5Cfr RAna1kVgbr7Ocml8x2n3CguYkI0NeUo4F8mBWau7uz+pjEzlkxEUaOs+Fjx9XWctOyX1 fHEeFgobBTv6z2A9tNQgklYte+PitXlYsf9n95bXNxCE2XD2znnVlNkqy5cxgTt/r7E6 J0Sohna5RxLGQLCvpbFOntxShB4U7i4Ok2sfko56dkmfB7vm4tyQtLHUAmsquNcLVRSM +5JQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:references:cc:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=q2YUSU7qTAed98w4qscgq0kKPDZG4QWuyti/4mTkuTM=; b=DUATxnwBwh7CaQsGCoLWdsNjX8oU7IyJDDunMLXvCpImgXAtI0AScwU3darwfw4Gia q+2/8zuapJrURIx/0MmDQlmz0RAXMk/3Lfa+vK03eAgDDE8qgnyKyjwzNVaqwc+9EfUw fYg8ePvKEDnZWP4eY4I2BIH1vVrLA4eM4qOSbPfl8GNCy6L2KY2ZrDZiVbKzKtM6X6js pozLOzHeGVvuKgsQZVssBvZDiI9cqqPs2/a9Q52+CqcT41ouWMGxXV/zha26RRfTLG0x 8Y5Bry6UB3/sjnG2tqH6BhUlKaHp/Gdot4QC6sQjM4Izl5U2ezyfgI7VwAeSsXOPHMap i1pA== X-Gm-Message-State: AOAM533BgZgTYnRcsAFgfbtjZJXeCRQcqjint7TOo6S2URcwuw5UefEv xQxZDGjjQFiik8ueQQ9wp4o= X-Google-Smtp-Source: ABdhPJzoTeXaDmYY2UEKk0S1wR01vGaOdohLpFOmXxXvwFYx7s7YPH78uWWEGmXbuByP99VzbORAvQ== X-Received: by 2002:a17:907:72cc:: with SMTP id du12mr1684580ejc.150.1601455850964; Wed, 30 Sep 2020 01:50:50 -0700 (PDT) Original-Received: from [192.168.0.4] ([66.205.71.3]) by smtp.googlemail.com with ESMTPSA id bt19sm957046ejb.44.2020.09.30.01.50.47 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 30 Sep 2020 01:50:48 -0700 (PDT) In-Reply-To: Content-Language: en-US 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:189319 Archived-At: On 30.09.2020 11:14, martin rudalics wrote: > >> 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. ...that receives the :thing, and :face, and the doc string, and prints it out appropriately. > >>  > 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. Le sigh. This is the point where I'm bowing out.