GNU bug report logs - #43205
28.0.50; Eldoc protocol not useful for third-party packages

Previous Next

Package: emacs;

Reported by: Yuan Fu <casouri <at> gmail.com>

Date: Fri, 4 Sep 2020 16:14:02 UTC

Severity: normal

Found in version 28.0.50

Fixed in version 28.1

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Yuan Fu <casouri <at> gmail.com>
To: Bug Report Emacs <bug-gnu-emacs <at> gnu.org>
Subject: 28.0.50; Eldoc protocol not useful for third-party packages
Date: Fri, 4 Sep 2020 12:13:10 -0400

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.
This bug report was last modified 3 years and 349 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.