Simple ElDoc frontend that displays documentation in a floating child frame
Go to file
Yuan Fu 93f89087b8
Improve eldoc-box-body face
Now every attribute takes effect.
2019-08-13 13:42:44 +08:00
eldoc-box.el Improve eldoc-box-body face 2019-08-13 13:42:44 +08:00
README.org Improve eldoc-box-body face 2019-08-13 13:42:44 +08:00
screenshot.png Update README (and screenshot) 2018-12-26 16:38:01 -05:00

ElDoc box

This package displays ElDoc documentations in a childframe.

https://melpa.org/packages/eldoc-box-badge.svg https://stable.melpa.org/packages/eldoc-box-badge.svg

/jessieh/eldoc-frame/media/commit/93f89087b84c3c8152503101a0854ffb1f596098/screenshot.png
Using with eglot in python-mode

Install

Get the file, add to load path, and

(require 'eldoc-box)

It is also available on MELPA

Usage

Function

eldoc-box-hover-mode
Display documentation of the symbol at point in a childframe on upper corner.
eldoc-box-hover-at-point-mode
If you enable this minor mode on top of eldoc-box-hover-mode, the childframe is displayed at point, instead of on the upper corner.
eldoc-box-eglot-help-at-point
See below.

Face

eldoc-box-border
Adjust :background of this face for border color.
eldoc-box-body
Default face used by childframe. I suggest to use a nice Sans Serif font such as Source Sans Pro, and a lighter or darker background.

Variable

eldoc-box-max-pixel-width & eldoc-box-max-pixel-height
Set them according to the screen resolution of your machine.
eldoc-box-only-multi-line
Set this to non-nil and eldoc-box only display multi-line message in childframe. One line messages are left in minibuffer.
eldoc-box-cleanup-interval
After this amount of seconds will eldoc-box attempt to cleanup the childframe. E.g. if it is set to 1, the childframe is cleared 1 second after you moved the point to somewhere else (that doesn't have a doc to show). This doesn't apply to eldoc-box-hover-at-point-mode, in that mode the childframe is cleared as soon as point moves.
eldoc-box-fringe-use-same-bg
T means fringe's background color is set to as same as that of default. Default to t.

Use with eglot

As of writing this README, eglot doesn't have a public mode hook, use this hook:

(add-hook 'eglot--managed-mode-hook #'eldoc-box-hover-mode t)

To keep eldoc from displaying documentation at point without enabling any minor mode above: (add-to-list 'eglot-ignored-server-capabilites :hoverProvider).

Eldoc-box also provides a convenient command eldoc-box-eglot-help-at-point. Calling this command on a symbol displays a documentation childframe at point. No need to enable any minor mode for this.

Contributors