2017-12-13 17:22:54 +00:00
|
|
|
#+TITLE: helpful layer
|
|
|
|
|
2019-12-28 08:57:57 +00:00
|
|
|
#+TAGS: emacs|layer
|
2019-12-09 21:44:48 +00:00
|
|
|
|
|
|
|
* Table of Contents :TOC_5_gh:noexport:
|
2017-12-13 17:22:54 +00:00
|
|
|
- [[#description][Description]]
|
|
|
|
- [[#features][Features:]]
|
|
|
|
- [[#install][Install]]
|
|
|
|
- [[#key-bindings][Key bindings]]
|
2020-03-23 20:03:08 +00:00
|
|
|
- [[#global-bindings][Global bindings]]
|
|
|
|
- [[#helpful-mode-bindings][Helpful mode bindings]]
|
2017-12-13 17:22:54 +00:00
|
|
|
|
|
|
|
* Description
|
2019-12-07 00:42:55 +00:00
|
|
|
This layer replaces the existing emacs related help buffers with more detailed ones.
|
2017-12-13 17:22:54 +00:00
|
|
|
|
|
|
|
** Features:
|
2019-12-07 00:42:55 +00:00
|
|
|
- Better help buffers with [[https://github.com/Wilfred/helpful][helpful]] for emacs related buffers
|
|
|
|
- Source code shown implicitly in help buffer for all lisp objects
|
|
|
|
- More detailed descriptions in the emacs specific function, variable and key help buffers
|
|
|
|
- Better formatted elisp docstrings
|
2017-12-13 17:22:54 +00:00
|
|
|
|
|
|
|
* Install
|
|
|
|
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
|
|
|
add =helpful= to the existing =dotspacemacs-configuration-layers= list in this
|
|
|
|
file.
|
|
|
|
|
|
|
|
* Key bindings
|
2020-03-23 20:03:08 +00:00
|
|
|
** Global bindings
|
2019-12-07 00:42:55 +00:00
|
|
|
This layer aims to silently replace the standard emacs help key bindings
|
|
|
|
with improved versions. So it does not introduce new bindings.
|
|
|
|
For the sake of completion you can find below all keys which are replaced
|
|
|
|
by this layer.
|
2017-12-13 17:22:54 +00:00
|
|
|
|
2019-12-09 21:44:48 +00:00
|
|
|
| Key binding | Description |
|
2019-12-07 00:42:55 +00:00
|
|
|
|-------------+--------------------------------------------------------|
|
|
|
|
| =SPC m h h= | Open helpful buffer for item under point in elisp mode |
|
|
|
|
| =SPC h d k= | Open helpful buffer for key binding |
|
|
|
|
| =SPC h d f= | Open helpful buffer for any callable object |
|
2021-01-11 16:25:33 +00:00
|
|
|
| =SPC h d v= | Open helpful buffer for variable |
|
|
|
|
| =C-h k= | Open helpful buffer for key binding |
|
|
|
|
| =C-h f= | Open helpful buffer for any callable object |
|
|
|
|
| =C-h v= | Open helpful buffer for variable |
|
2020-03-23 20:03:08 +00:00
|
|
|
|
|
|
|
** Helpful mode bindings
|
2020-03-24 20:40:51 +00:00
|
|
|
Additional key bindings available in the helpful-mode buffers.
|
2020-03-23 20:03:08 +00:00
|
|
|
|
|
|
|
| Key binding | Description |
|
|
|
|
|-------------+----------------------------------------------------|
|
|
|
|
| =SPC m q= | Close all helpful-mode buffers |
|
|
|
|
| =gr= | Reload the buffer (e.g. to see new variable value) |
|
|
|
|
| =o= | Open link with Avy |
|
|
|
|
| =q= | Close window (buffer is kept in background) |
|