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: Sun, 27 Sep 2020 10:30:45 +0200 Message-ID: <89a118cf-65e1-5e9f-0884-577a52ca115e@gmx.at> References: <2e610c3f-6e5f-c7dd-af2e-aeb5e20d8664@gmx.at> 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="18642"; 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 Sun Sep 27 10:31:55 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 1kMS65-0004lB-OQ for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 27 Sep 2020 10:31:53 +0200 Original-Received: from localhost ([::1]:38316 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kMS64-0003bZ-Jh for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 27 Sep 2020 04:31:52 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44396) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kMS5G-0003bR-Id for bug-gnu-emacs@gnu.org; Sun, 27 Sep 2020 04:31:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36720) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kMS5G-0006hM-9G for bug-gnu-emacs@gnu.org; Sun, 27 Sep 2020 04:31:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kMS5G-0004OD-4Y for bug-gnu-emacs@gnu.org; Sun, 27 Sep 2020 04:31:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: martin rudalics Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 27 Sep 2020 08:31: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.160119545616862 (code B ref 43609); Sun, 27 Sep 2020 08:31:02 +0000 Original-Received: (at 43609) by debbugs.gnu.org; 27 Sep 2020 08:30:56 +0000 Original-Received: from localhost ([127.0.0.1]:48266 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kMS5A-0004Nu-7T for submit@debbugs.gnu.org; Sun, 27 Sep 2020 04:30:56 -0400 Original-Received: from mout.gmx.net ([212.227.17.22]:46621) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kMS56-0004Ne-Tr for 43609@debbugs.gnu.org; Sun, 27 Sep 2020 04:30:55 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1601195446; bh=1+SfY9K5YgvcZUUL630NChr0m/WSQgkfvvlTDIFL0I0=; h=X-UI-Sender-Class:Subject:To:References:From:Date:In-Reply-To; b=iGZRN7d/trQU6VhyhauYc83PiN4Y8zTmh1yaavALV7tIh42THEG3pBgEjBKE0RID6 s0Jrfkw6v6FwQShzUci65SEGMAZaQfRwltt9Nd+hefS2feyRzAmd1J3G3qZyL3At6o JpMsmSnbR6xXCPZFv4BRkSGtBzPHNxbqyFWezIuE= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from [192.168.1.101] ([212.95.5.254]) by mail.gmx.com (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1Mgeo8-1kugtm2fng-00h8ms; Sun, 27 Sep 2020 10:30:46 +0200 In-Reply-To: Content-Language: en-US X-Provags-ID: V03:K1:Xh6C/dseGkg8i2iZo6FBUIctwHBLNint4+MF/kka8t1Dit2L6s7 A+dRIszW9VZwU3yYWt9jD1r9NxE+r6D1YkDBxEHvva1hqax1bSOFmjCz5IzuS/DC2LYYn2s H4pNFIgMjtnmhTtrqB08jEAtoR/9kWY6tp5sulj0j+UVBBgZYGqm2u4UvVUxqd+NLeDkxpj Srs4UjiyfAYtsO+9xzCEQ== X-UI-Out-Filterresults: notjunk:1;V03:K0:y4lZTZnAkrs=:xCB/W3QaCZrs9dA0zHON8J x79sDlvAqmwWkw0ekPGhYWLZJ3C+TVWFH/9s5UjudhxHfLJ7qO6PaH2JSf5y7E42/QREBh9wS WJoZWvegN/CpKDtb3yzLVlK5RHlSeBZT5CR5ttYJ+NlGBcQ5X01qjrENPjCUAMnikDivtKUD6 mfBSuSoPO1THE/6+1CSVC700qUfAIgZyBiOn7mQNdznTSHqE/QDgedbT1TrsHzGqWac+Yq2R4 j1WDIGeO8NyXJ3Pl0eTSpoYWAsbGrdcVBcVEb6H4+wYYR/cDdP66bkrY7v5hA0ILuX367Vg0/ 7A9T+2JknWFjj+8BJ9THHwekKhFtn2qgPdQjkcWDUCXkvnRyvwE+W0q5B+rk0GzyNwiYxVVyT HrwfxjfuJNYu+QvDcDAs2QsoVuUS2Qx9LvhprzTDzpCpEC9AupdL2Td6vaVei9Ga0twSKs9D/ 8JCk2iX6x74fN+SxeYcGKsI8NWR1rfmZdmk0ppgcCB8GVsvIkxhEe/1puc3KoYU6uITgH/ZXi swuNVKi94PGYDO5hWlKOBnarPUEUVHVlzyfkMth/CEMwxltYJyLKoJjrG+c6PskkBkg8mla9C OKfmw/I00YBCEi3CxDcW138Xk65p4KYMxS6hncz8h7LCFiFih0BqauEkN61IQUKZTYLkunO00 hhBun85806mH99DP0AgibrBxtp6/A4qKt66LtH9K957Nkct9h5Sa/4pAKO/051Tgx5hlhht3r dvtDHqhMOzScKXLlYURwSS4vV9QMXGuzGqOQ3lqylIrJdJmUIz/2eEAY9CgMzyMlG/ni6XfM 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:189093 Archived-At: > You might want to read the docstring for > eldoc-documentation-functions, in particular the part where "Each hook > function is called with at least one argument CALLBACK". That was the first thing I tried to do. For beginners, I don't know what a "Hook of functions" is. And I completely fail to understand what a "hook function" in this context is and when and why it gets called. In short, I completely fail to understand the logic behind this variable. All I know is that I do not want to write a hook function and I do not want to get called by any agent here. > I agree that the latest changes make Eldoc gratuitously more complex, > though. You can read bug#41531, where they started. I never read that thread (it started around a time when my mailboxes were thrashed due to almost simultaneous crashes of two of my mail receiving machines) and I subsequently had to drop a few thousands of mails I received earlier. I've still not recuperated from that state. I now spent more than an hour reading that thread and am as clever as before. The first post in that thread seems to say everything already: This enables eldoc.el to exert control over how (and crucially also when) to display the docstrings to the user. In a nutshell: With eldoc-tooltip it's me and only me who decides when and how to display a doc string. I do not want to leave this decision to a package that tries to judge whether and when that Procrustean bed called echo area is ready to display that doc string, whether and how to truncate it and when to make it disappear. Sadly, this doesn't work any more in Emacs 28. Maybe there's a simple solution to my problem but nobody pointed me to it so far ... Thanks for the response, martin