GNU bug report logs - #43103
28.0.50; Default ElDoc composition strategy in Elisp mode (eldoc-documentation-strategy)

Previous Next

Package: emacs;

Reported by: João Távora <joaotavora <at> gmail.com>

Date: Sat, 29 Aug 2020 15:38:01 UTC

Severity: normal

Found in version 28.0.50

Full log


View this message in rfc822 format

From: João Távora <joaotavora <at> gmail.com>
To: Dmitry Gutov <dgutov <at> yandex.ru>
Cc: 43103 <at> debbugs.gnu.org, Eli Zaretskii <eliz <at> gnu.org>, larsi <at> gnus.org, monnier <at> iro.umontreal.ca
Subject: bug#43103: 28.0.50; Default ElDoc composition strategy in Elisp mode (eldoc-documentation-strategy)
Date: Mon, 31 Aug 2020 09:38:19 +0100
Dmitry Gutov <dgutov <at> yandex.ru> writes:
> On 30.08.2020 18:15, João Távora wrote:

> It's true, but the curious reality is that AFAIK the built-in eldoc
> functions (foremost, the Elisp one) have always used the one-line
> display, even when they could show more.
>
> These is definite wisdom in that.

I see only signs of rudimentary intial design which predates
eldoc-...-multiline-p, composition, Flymake...

> Change the default in eldoc.el. Why emacs-lisp-mode?

See subject line.

> One would probably prefer to see the description of the compilation
> error rather than the function signature, if they had to choose.

Maybe you would, you can adjust it.  I'd rather not change more defaults
than the one suggested in the subject line.

>> - even if eldoc-echo-area-use-multiline-p is set to nil, users can still
>> get to all the info collecte by ElDoc with the new
>> `eldoc-documentation-compose` strategy by pressing M-x eldoc-doc-buffer
>
> Is that the only benefit?

No.

> This command is pretty odd in its design. But if its main purpose was
> to show multiple eldoc results together

It's similar to `help-buffer`, but also switches to the buffer when
called interactively.  I don't see anything odd in that, in Emacs terms.
The command pops a window to *eldoc ...*, a less restricted view into
the continuously composed results of ElDoc collection, the echo area
being a much more restricted outlet.  In the future, there could/should
be an arbitrary number of such outlets: windows, frames, tooltips, some
more restrictive, some less, some more interactive, some less.

This is beyond the scope of this bug, though.

João




This bug report was last modified 4 years and 347 days ago.

Previous Next


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