From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: charles@aurox.ch (Charles A. Roelli) Newsgroups: gmane.emacs.bugs Subject: bug#27230: eldoc doc Date: Thu, 14 Sep 2017 21:39:04 +0200 Message-ID: References: <282e174a-e9c0-6bec-32f5-ed9d772e5e1d@yandex.ru> <83efu8ta6n.fsf@gnu.org> <4107369a-5d50-7e46-2e81-57c4ef5c7965@yandex.ru> <1f39b877-4cbf-96d8-a318-7edf95f10406@yandex.ru> NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1505418014 28858 195.159.176.226 (14 Sep 2017 19:40:14 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 14 Sep 2017 19:40:14 +0000 (UTC) Cc: pok@netfonds.no, 27230@debbugs.gnu.org To: Dmitry Gutov Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Sep 14 21:40:10 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 1dsZzd-0007Nz-4z for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Sep 2017 21:40:09 +0200 Original-Received: from localhost ([::1]:49731 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dsZzk-0001NE-Ir for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Sep 2017 15:40:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34544) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dsZzZ-0001Ko-PQ for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2017 15:40:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dsZzW-0000yY-KY for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2017 15:40:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:32804) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dsZzW-0000yM-EU for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2017 15:40:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1dsZzW-00066v-4x for bug-gnu-emacs@gnu.org; Thu, 14 Sep 2017 15:40:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: charles@aurox.ch (Charles A. Roelli) Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Sep 2017 19:40:02 +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: patch Original-Received: via spool by 27230-submit@debbugs.gnu.org id=B27230.150541797723456 (code B ref 27230); Thu, 14 Sep 2017 19:40:02 +0000 Original-Received: (at 27230) by debbugs.gnu.org; 14 Sep 2017 19:39:37 +0000 Original-Received: from localhost ([127.0.0.1]:41485 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dsZz6-00066G-W5 for submit@debbugs.gnu.org; Thu, 14 Sep 2017 15:39:37 -0400 Original-Received: from sinyavsky.aurox.ch ([37.35.109.145]:59444) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dsZz5-000662-6v for 27230@debbugs.gnu.org; Thu, 14 Sep 2017 15:39:35 -0400 Original-Received: from sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) by sinyavsky.aurox.ch (Postfix) with ESMTP id 4EF4022538 for <27230@debbugs.gnu.org>; Thu, 14 Sep 2017 19:33:14 +0000 (UTC) Authentication-Results: sinyavsky.aurox.ch (amavisd-new); dkim=pass (1024-bit key) reason="pass (just generated, assumed good)" header.d=aurox.ch DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=aurox.ch; h= references:subject:subject:in-reply-to:to:from:from:message-id :date:date; s=dkim; t=1505417591; x=1506281592; bh=IX0mhrn4S+u+E X7bJqkL/lbvrKUpK9PuZWbotV48THE=; b=Il+DWNose/8I4BnWCkS90rZit/i9u n+mqiE+1DfhReP5LDOcJosaZh1P0xG0z7Yj2l3AOqdkWDkVTXf068COoGUOk10CV 0QB6kGDejhcgtcEUvmDcf8W58A534+hc6a0V5znf47/aAiU4ROo+CsOWhr08/kei mp1oVgaGSeevJI= X-Virus-Scanned: Debian amavisd-new at test.virtualizor.com Original-Received: from sinyavsky.aurox.ch ([127.0.0.1]) by sinyavsky.aurox.ch (sinyavsky.aurox.ch [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id NNYwNNeBcskO for <27230@debbugs.gnu.org>; Thu, 14 Sep 2017 19:33:11 +0000 (UTC) Original-Received: from gray (125.85.192.178.dynamic.wline.res.cust.swisscom.ch [178.192.85.125]) by sinyavsky.aurox.ch (Postfix) with ESMTPSA id 47D5B22527; Thu, 14 Sep 2017 19:33:11 +0000 (UTC) In-reply-to: <1f39b877-4cbf-96d8-a318-7edf95f10406@yandex.ru> (message from Dmitry Gutov on Thu, 14 Sep 2017 15:02:11 +0300) 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:136973 Archived-At: > From: Dmitry Gutov > Date: Thu, 14 Sep 2017 15:02:11 +0300 > > For one thing, third-party packages should *not* use eldoc-message. Right. But why should we break its calling convention without good reason, when we can see that now that other packages have been using it? Moreover, the function has probably been around for awhile, and without good documentation, it might not have been clear that it's best suited for "internal" use. This change might also be mentioned under "Incompatible Lisp Changes" in NEWS, and it should be discussed in a separate bug report since it doesn't have much to do with "eldoc doc" (which this bug was about).