mirror of https://github.com/doomemacs/doomemacs synced 2025-08-25 14:13:37 -05:00

Files

Henrik Lissner 4daa9271a0 Introduce general.el & rewrite map!

+ Now uses an overriding keymap for leader keys, so that it is always
  available, even outside of normal/visual states. In insert/emacs
  states, or in sessions where evil is absent, an alternative prefix is
  used for leader/localleader keys. See these variables:
  + doom-leader-prefix
  + doom-leader-alt-prefix
  + doom-localleader-prefix
  + doom-localleader-alt-prefix
+ Keybinds now support alternative prefixes through the new :alt-prefix
  property. This is useful for non-evil users and non-normal evil
  states. By default, this is M-SPC (leader) and M-SPC m (localleader).
+ Removed +evil-commands flag from config/default (moved to
  feature/evil/+commands.el).
+ config/default/+bindings.el has been split into
  config/default/+{evil,emacs}-bindings.el, which one is loaded depends
  on whether evil is present or not. The latter is blank, but will soon
  be populated with a keybinding scheme for non-evil users (perhaps
  inspired by #641).
+ The define-key! macro has been replaced; it is now an alias for
  general-def.
+ Added unmap! as an alias for general-unbind.
+ The following modifier key conventions are now enforced for
  consistency, across all OSes:
    alt/option      = meta
    windows/command = super
  It used to be
    alt/option      = alt
    windows/command = meta
  Many of the default keybinds have been updated to reflect this switch,
  but it is likely to affect personal meta/super keybinds!

The map! macro has also been rewritten to use general-define-key. Here
is what has been changed:

+ map! no longer works with characters, e.g. (map! ?x #'do-something) is
  no longer supported. Keys must be kbd-able strings like "C-c x" or
  vectors like [?C-c ?x].
+ The :map and :map* properties are now the same thing. If specified
  keymaps aren't defined when binding keys, it is automatically
  deferred.
+ The way you bind local keybinds has changed:

    ;; Don't do this
    (map! :l "a" #'func-a
          :l "b" #'func-b)
    ;; Do this
    (map! :map 'local "a" #'func-a
                      "b" #'func-b)

+ map! now supports the following new blocks:
  + (:if COND THEN-FORM ELSE-FORM...)
  + (:alt-prefix PREFIX KEYS...) -- this prefix will be used for
    non-normal evil states. Equivalent to :non-normal-prefix in general.
+ The way you declare a which-key label for a prefix key has changed:

    ;; before
    (map! :desc "label" :prefix "a" ...)
    ;; now
    (map! :prefix ("a" . "label") ...)

+ It used to be that map! supported binding a key to a key sequence,
  like so:

    (map! "a" [?x])  ; pressing a is like pressing x

  This functionality was removed *temporarily* while I figure out the
  implementation.

Addresses: #448, #814, #860
Mentioned in: #940

2018-12-22 04:14:43 -05:00

autoload

Expand %:P relative to % instead of current buffer

2018-12-05 22:11:54 -05:00

test

test-evil: load :feature evil module

2018-06-15 04:46:13 +02:00

+everywhere.el

Move evilified helpful keybinds to feature/evil

2018-12-05 22:11:54 -05:00

config.el

Introduce general.el & rewrite map!

2018-12-22 04:14:43 -05:00

packages.el

feature/evil: refactor neotree-make-executor fix

2018-09-26 10:46:43 -04:00

README.org

Update & reformat module readmes for v2.0.9

2018-01-01 13:21:53 -05:00

README.org

:feature evil

Table of Contents
Removing evil-mode
Features

This holy module brings the vim experience to Emacs.

Removing evil-mode

See the corresponding question in the FAQ.

Features

A better :g[lobal] command with incremental highlighting.
Adds the :al[ign] ex command: offers an ex interface to align-regexp with incremental highlighting.
Support for more of vim's filename modifiers in ex commands (like :p, :p:h or :t) than vanilla evil-mode offers.
A list of new text objects:
- Blocks: B (from evil-textobj-anyblock)
- Args: a (from evil-args)
- Indentation: i / I / J (from evil-indent-plus)
Incorporates vim functionality ported to evil:
- vim-commentary => evil-commentary
- vim-easymotion => evil-easymotion
- vim-multiedit => evil-multiedit
- vim-multiple-cursors => evil-mc & evil-multiedit
- vim-seek or vim-sneak => evil-snipe
- vim-surround => evil-embrace & evil-surround
NERDTree equivalent is available in :tools neotree

Multiple-cursors

Two multiple-cursor implementations exist in this module: evil-mc and evil-multiedit. Together, these provide the functionality of vim-multiple-cursors.

The former lets you place "clone" cursors. The latter lets you interactively edit many regions at once (like an interactive version of :%s).

A hybrid code-folding system

This module combines evil-vimish-fold and hideshow. The former allows arbitrary folds and the latter allows folds on markers and indentation. Together, they create a more consistent (and feature-complete) code-folding system.

Most vim folding keys should work, e.g. zr, zm, za, zo, etc.

Hacks

Automatically moves to new window when splitting
From visual mode, * and # will search for the current selection instead of the word-at-point.

Differences from vim

Column-wise ranges in ex commands are enabled by default. i.e. the range in :'<,'>s/a/b will only affects the visual selection, not full lines (see evil-ex-visual-char-range).
:g will incrementally highlight buffer matches.