doomemacs/modules/config/default
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 Introduce general.el & rewrite map! 2018-12-22 04:14:43 -05:00
+emacs-bindings.el Introduce general.el & rewrite map! 2018-12-22 04:14:43 -05:00
+evil-bindings.el Introduce general.el & rewrite map! 2018-12-22 04:14:43 -05:00
config.el Introduce general.el & rewrite map! 2018-12-22 04:14:43 -05:00
README.org 💥 Move :private modules to :config 2018-02-14 23:36:27 -05:00

:config default

This module provides a set of reasonable defaults, including:

  • A Spacemacs-esque keybinding scheme
  • Extra Ex commands for evil-mode users
  • A yasnippet snippets library tailored to Doom emacs
  • A configuration for (almost) universally repeating searches with ; and ,

The defaults module is intended as a "reasonable-defaults" module, but also as a reference for your own private modules. You'll find my private module in a separate repo.

Refer to the Customization page on the wiki for details on starting your own private module.

Install

This module has no external dependencies.

Configuration

Using another snippets library

Don't want to use provided one? Then add this to your private module,

;; in config/$USER/packages.el
(package! emacs-snippets :ignore t)

;; in config/$USER/config.el
(def-package-hook! emacs-snippets :disabled t)
(after! yasnippet
  (push "~/path/to/my/private/snippets" yas-snippet-dirs))

I'm not an evil user…

That's fine. All evil configuration is ignored if :feature evil is disabled.

Appendix

Commands

  • +default/browse-project
  • +default/browse-templates
  • +default/find-in-templates
  • +default/browse-emacsd
  • +default/find-in-emacsd
  • +default/browse-notes
  • +default/find-in-notes
  • +default/find-in-snippets

Hacks

  • epa-pinentry-mode is set to 'loopback, forcing gpg-agent to use the Emacs minibuffer when prompting for your passphrase. Only works with GPG 2.1+!