Skip to content

Miscellaneous

Emacs Lisp Autovariable: evil-want-fine-undo

Whether actions are undone in several steps. There are two possible choices: nil (“no”) means that all changes made during insert state, including a possible delete after a change operation, are collected in a single undo step. Non-nil (“yes”) means that undo steps are determined according to Emacs heuristics, and no attempt is made to aggregate changes.

For backward compatibility purposes, the value fine is interpreted as nil. This option was removed because it did not work consistently.

Default: nil

Emacs Lisp Autovariable: evil-undo-system

Undo system Evil should use. If equal to undo-tree or undo-fu, those packages must be installed. If equal to undo-tree, undo-tree-mode must also be activated. If equal to undo-redo, Evil uses commands natively available in Emacs 28.

Default: nil

Emacs Lisp Autovariable: evil-backspace-join-lines

Whether backward delete in insert state may join lines.

Default: t

Emacs Lisp Autovariable: evil-kbd-macro-suppress-motion-error

Whether left/right motions signal errors in keyboard macros. This variable only affects beginning-of-line or end-of-line errors regarding the motions h and SPC respectively. This may be desired since such errors cause macro definition or execution to be terminated. There are four possibilities:

  • record: errors are suppressed when recording macros, but not when replaying them.
  • replay: errors are suppressed when replaying macros, but not when recording them.
  • t: errors are suppressed in both cases.
  • nil: errors are never suppressed.

Default: nil

Emacs Lisp Autovariable: evil-mode-line-format

The position of the state tag in the mode line. If set to before or after, the tag is placed at the beginning or the end of the mode-line, respectively. If nil, there is no tag. Otherwise it should be a cons cell (WHERE . WHICH), where `WHERE' is either before or after, and `WHICH' is a symbol in mode-line-format. The tag is then placed before or after that symbol, respectively.

Default: before

Emacs Lisp Autovariable: evil-mouse-word

The `thing-at-point' symbol for double click selection. The double-click starts visual state in a special word selection mode. This symbol is used to determine the words to be selected. Possible values are evil-word or evil-WORD.

Default: evil-word

Emacs Lisp Autovariable: evil-bigword

The set of characters to be interpreted as WORD boundaries. This is enclosed with square brackets and used as a regular expression. By default, whitespace characters are considered WORD boundaries.

Default: "^ \t\r\n", buffer-local

Emacs Lisp Autovariable: evil-esc-delay

The time, in seconds, to wait for another key after escape. If no further event arrives during this time, the event is translated to ESC. Otherwise, it is translated according to input-decode-map. This does not apply in Emacs state, and may also be inhibited by setting evil-inhibit-esc.

Default: 0.01

Emacs Lisp Autovariable: evil-intercept-esc

Whether Evil should intercept the escape key. In the terminal, escape and a meta key sequence both generate the same event. In order to distingush these, Evil uses input-decode-map. It is not necessary to do this in a graphical Emacs session. However, if you prefer to use C-[ as escape (which is identical to the terminal escape key code), this interception must also happen in graphical Emacs sessions. Set this variable to always, t (only in the terminal) or nil (never intercept).

Default: always

Emacs Lisp Autovariable: evil-kill-on-visual-paste

Whether pasting in visual state adds the replaced text to the kill ring, making it the default for the next paste. The default, replicates the default Vim behavior.

Default: t

Emacs Lisp Autovariable: evil-echo-state

Whether to signal the current state in the echo area.

Default: t

Emacs Lisp Autovariable: evil-complete-all-buffers

Whether completion looks for matches in all buffers. This applies to C-n and C-p in insert state.

Default: t

Emacs Lisp Autovariable: evil-want-empty-ex-last-command

Whether to default to evil-ex-previous-command at empty ex prompt.

Default: t