From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yuan Fu Newsgroups: gmane.emacs.bugs Subject: bug#43205: 28.0.50; Eldoc protocol not useful for third-party packages Date: Fri, 4 Sep 2020 12:13:10 -0400 Message-ID: Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.1\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3855"; mail-complaints-to="usenet@ciao.gmane.io" To: 43205@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Sep 04 18:18:43 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 1kEEQE-0000pq-Ar for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 04 Sep 2020 18:18:42 +0200 Original-Received: from localhost ([::1]:51034 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kEEQD-0004Ay-Bo for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 04 Sep 2020 12:18:41 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35410) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kEELj-0005oG-3a for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2020 12:14:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57181) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kEELi-0004KN-Pw for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2020 12:14:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kEELi-0008Lk-Lr for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2020 12:14:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Yuan Fu Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 04 Sep 2020 16:14:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 43205 X-GNU-PR-Package: emacs X-Debbugs-Original-To: Bug Report Emacs Original-Received: via spool by submit@debbugs.gnu.org id=B.159923599732020 (code B ref -1); Fri, 04 Sep 2020 16:14:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Sep 2020 16:13:17 +0000 Original-Received: from localhost ([127.0.0.1]:40490 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kEEKy-0008KN-KR for submit@debbugs.gnu.org; Fri, 04 Sep 2020 12:13:17 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:39294) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kEEKx-0008KG-Hf for submit@debbugs.gnu.org; Fri, 04 Sep 2020 12:13:15 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35276) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kEEKx-0004Qw-Bo for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2020 12:13:15 -0400 Original-Received: from mail-qk1-x735.google.com ([2607:f8b0:4864:20::735]:38171) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kEEKv-0004Ft-LV for bug-gnu-emacs@gnu.org; Fri, 04 Sep 2020 12:13:15 -0400 Original-Received: by mail-qk1-x735.google.com with SMTP id d20so6802544qka.5 for ; Fri, 04 Sep 2020 09:13:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:content-transfer-encoding:mime-version:subject:message-id:date :to; bh=d94N2ud4K9xA84bToS9fCDJrxFLLmJk4XjxlOn47h/s=; b=cvmpiRXPYt+K6YOLr74QGMqMAt6tjGjTy+/b6qxbgWzh+Sm/6WluT9POoYJnwr580l lcC5cVTK0jkqSGEy0+tBmPYJKzwxQswYoVKxafQ/2d6G+7VPZUSX6hGTvN1FBKfj22e+ 7pujh3o9M/PQtogMRHQmPflr5tUFEHp/ti+yhQMCKGobpTG6YnhMUs2ZspAixj1+KQpy nG49CjYlyABZrdgOiITAkO2mO21T3SxCRWSaWsWSFPFIcRBYAM0L80lqQsbJ4cuDbrIW zmDP8nIN7RNdRZGfywN9Br9cDVAe1NCzhOeZxApnI83HdRJCZdfAKjNuHfXFzW8neSgP 5gCQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:content-transfer-encoding:mime-version :subject:message-id:date:to; bh=d94N2ud4K9xA84bToS9fCDJrxFLLmJk4XjxlOn47h/s=; b=lGYRniRSae+sVjXCNbgWPhMcW50RrypZEo35tp+0QvUWjj1E942T8CKNqoHURWrl39 n6Gg2B4gHN+luNAV5HxKQZR+8cMG0nKBdZlAMBt6stc796mXBc0wIYKSQr6Vvm3ybviQ YveuwezMCBKCTjsjhGERuZJb2gUi+Qy27CqqQFFXzY7h8C4kzLcm+eBVTFzs2JtmR/Rv eM8Iw2Ztz9BF3uEU3K7YFQMNXQ0nu9pmEN2ffaLISMOyx7Bvl3Hv+tf0dHFn1/iQX6za A7+zIf7OIlzG74KlEcmLMekWG1TKibjrp+pRLJ7E4TegK+tYpQQrHyNNMld+oVz2hrpP USxA== X-Gm-Message-State: AOAM533rYKukPYTph4KVZweA1/dZ+kqsSH1UkTqeEBgV0JktHim0XuQb 8hgamWk/iOBPkPhXca12mCm7irkfTWE9RzZj X-Google-Smtp-Source: ABdhPJxk4buKA15H0gYQ7oQAhgap9pejJs0MqptlGLdErnZ6gVvx0+pUhgE9kqYr0AEf3XTwtsRUAA== X-Received: by 2002:a37:952:: with SMTP id 79mr8600055qkj.57.1599235991656; Fri, 04 Sep 2020 09:13:11 -0700 (PDT) Original-Received: from ?IPv6:2601:98a:4200:9210:6153:d1ba:ebc1:880f? ([2601:98a:4200:9210:6153:d1ba:ebc1:880f]) by smtp.gmail.com with ESMTPSA id d47sm4939179qta.63.2020.09.04.09.13.10 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 04 Sep 2020 09:13:11 -0700 (PDT) X-Mailer: Apple Mail (2.3608.120.23.2.1) Received-SPF: pass client-ip=2607:f8b0:4864:20::735; envelope-from=casouri@gmail.com; helo=mail-qk1-x735.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:187157 Archived-At: Currently the documentation of `eldoc-documentation-functions' says this: * `:thing', VALUE is a short string or symbol designating what is being reported on. The documentation display engine can elect to remove this information depending on space contraints; without saying what VALUE could be. For someone who want to write a frontend to display eldoc signitures, this is useless. For someone who want to write a documentation backend for eldoc, this is useless as well. I think the protocol should at least specify what VALUE could be expected: signature? full-doc? example? links? Also contraints is spelled wrong. And on line 705.