spacemacs/layers/better-defaults/README.org

#+TITLE: Better Defaults layer
#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="../../css/readtheorg.css" />

[[file:img/emacs.png]]

* Table of Contents                                         :TOC_4_org:noexport:
 - [[Description][Description]]
 - [[Install][Install]]
 - [[Functions][Functions]]
   - [[=spacemacs/smart-move-beginning-of-line=][=spacemacs/smart-move-beginning-of-line=]]
   - [[=spacemacs/backward-kill-word-or-region=][=spacemacs/backward-kill-word-or-region=]]
 - [[Key bindings][Key bindings]]

* Description
This layer enhances the default commands of Emacs and is primarily intended to
be used with the =emacs= editing style as it does not change anything in the Vim
key bindings.

However the =emacs= editing style is not required, you can still use this layer
while you are using the =vim= editing style if you have some kind of mixed
style.

The commands defined in this layer are taken from various sources like [[https://github.com/bbatsov/prelude][Prelude]].

* Install
To use this contribution add it to your =~/.spacemacs=

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers '(better-defaults))
#+END_SRC

* Functions
** =spacemacs/smart-move-beginning-of-line=
Pressed one time, go to the first non-whitespace character of the line, pressed
again, go to the beginning of the line.

** =spacemacs/backward-kill-word-or-region=
A combination of =kill-region= and =backward-kill-word=, depending on whether
there is an active region. If there's an active region kill that. If not kill
the preceding word.

* Key bindings

| Key Binding | Description                                                                      |
|-------------+----------------------------------------------------------------------------------|
| ~C-a~       | smart beginning of line                                                          |
| ~C-w~       | backward kill word or region                                                     |
| ~C-y~       | Automatically indenting after pasting. With prefix argument, paste text as it is |