From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.bugs Subject: bug#27230: eldoc doc Date: Mon, 26 Jun 2017 04:04:18 +0300 Message-ID: <4107369a-5d50-7e46-2e81-57c4ef5c7965@yandex.ru> References: <282e174a-e9c0-6bec-32f5-ed9d772e5e1d@yandex.ru> <83efu8ta6n.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: blaine.gmane.org 1498439116 23688 195.159.176.226 (26 Jun 2017 01:05:16 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 26 Jun 2017 01:05:16 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:54.0) Gecko/20100101 Thunderbird/54.0 Cc: 27230@debbugs.gnu.org To: "Charles A. Roelli" , Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jun 26 03:05:11 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dPISj-0005nF-5F for geb-bug-gnu-emacs@m.gmane.org; Mon, 26 Jun 2017 03:05:09 +0200 Original-Received: from localhost ([::1]:44280 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dPISo-0001J7-6K for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Jun 2017 21:05:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37159) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dPISh-0001HX-9z for bug-gnu-emacs@gnu.org; Sun, 25 Jun 2017 21:05:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dPISc-0000Mr-CT for bug-gnu-emacs@gnu.org; Sun, 25 Jun 2017 21:05:07 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:35137) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dPISc-0000Ml-9b for bug-gnu-emacs@gnu.org; Sun, 25 Jun 2017 21:05:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dPISb-00025V-Qs for bug-gnu-emacs@gnu.org; Sun, 25 Jun 2017 21:05:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Dmitry Gutov Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 26 Jun 2017 01:05:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 27230 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 27230-submit@debbugs.gnu.org id=B27230.14984390687969 (code B ref 27230); Mon, 26 Jun 2017 01:05:01 +0000 Original-Received: (at 27230) by debbugs.gnu.org; 26 Jun 2017 01:04:28 +0000 Original-Received: from localhost ([127.0.0.1]:37814 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dPIS4-00024T-EK for submit@debbugs.gnu.org; Sun, 25 Jun 2017 21:04:28 -0400 Original-Received: from mail-wr0-f181.google.com ([209.85.128.181]:36067) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dPIS2-00024C-Q8 for 27230@debbugs.gnu.org; Sun, 25 Jun 2017 21:04:27 -0400 Original-Received: by mail-wr0-f181.google.com with SMTP id c11so132247252wrc.3 for <27230@debbugs.gnu.org>; Sun, 25 Jun 2017 18:04:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=H2gd39S/6eIwmXWYHRVrlg8tGHrp25fx+rYv52hgREE=; b=uw1g0lekYAJU+pAVuGboU2CMSk0oOLaj0ejxtw2vgIUw2eal1+YypjJZrbUhLCE1fi gMNPFP6XHpExp6JG2IURQHn3jHiW2cq6pJK8OiJjIgdb8YLGdiu3zSZDds462jz9Z62g ABZRD/WmARBHe74Vjt2BzonS053GfhPO1GT9uUZ+Qh4yv0o1lbatiPDvd/ODcxRFYgpf WO7JaQ8qEYUgdEowdcbjvoO7SeLlms8mmX98vmGVk1Xzb1KbT6YnygCSXx90M1pGfGKJ FeRiA5WkJa2/oYeizfV6M0PTJh9Rl1KLAw1VPGFKRh4YYXT2d5srx23y2K/PpkKgV7Uj uw6A== 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:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=H2gd39S/6eIwmXWYHRVrlg8tGHrp25fx+rYv52hgREE=; b=aXwNzwJHycrGdACVoUXQSJIGhsIfFGWRERXp5tS8tqlfhsR4x37iqn6jSm5ct6im16 sKaDkxrMB1NKLO+bMZA7ezANke+g0mSpAZzkF4jtAL3Z32FEqgdTbCR72BpJNDiPIVYm f3KzRuo8sYbyzWqIkUD0pfO+rC4HfftMOQrPXEjSfjl17Lc3Y0X8OIVAlSLxvbqHYpPH l3faL/CvEfcNlj2SsohVrshPAmEaTDTilu0ZSI+r+FcUNZNcXKOAh8L7fS7U+49Mvthu 9HxJQPF/ggjlOLarTFcn1+g/1C8mVvC1o/QLz+L9ObeDgHbNuvR6qSIU3SMcSTypOwZy lmhg== X-Gm-Message-State: AKS2vOxjqGKwsPdOLp87shbS5oaJZRFuUcnlSWz4ef+6bXURKLS8x3A9 uA5tpuN7hlSYwBYMSB0= X-Received: by 10.28.194.68 with SMTP id s65mr11478150wmf.121.1498439060534; Sun, 25 Jun 2017 18:04:20 -0700 (PDT) Original-Received: from [192.168.1.3] ([185.105.174.193]) by smtp.googlemail.com with ESMTPSA id w197sm10742544wme.20.2017.06.25.18.04.19 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 25 Jun 2017 18:04:19 -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-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:133908 Archived-At: On 6/25/17 10:47 PM, Charles A. Roelli wrote: > FORMAT-STRING (or nil, if not given) is stored in > `eldoc-last-message'. If ARGS are given, FORMAT-STRING is first > formatted through `format-message'. I wonder if we ever call this function with more than one argument. If not, the code and the doc call for simplification. We can avoid advertising this possibility, at least. > If `eldoc-last-message' is non-nil, display it using > `eldoc-message-function'. If it is nil, clear the echo area if > there was recently a message from ElDoc there. I think this needlessly prioritizes the implementation over the intention. And the latter is to display whatever the documentation function returns (if non-nil). Saving to eldoc-last-message is secondary, and can be mentioned later. > Return `eldoc-last-message'." This is probably non-essential, and we can avoid mentioning it.