spacemacs/layers/+vim/evil-commentary/README.org

#+TITLE: Evil-commentary layer

#+TAGS: layer|vim

* Table of Contents                     :TOC_5_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
- [[#key-bindings][Key bindings]]

* Description
This layer replaces [[https://github.com/redguardtoo/evil-nerd-commenter][evil-nerd-commenter]] with [[https://github.com/linktohack/evil-commentary][evil-commentary]] for those
who prefer the behaviour of [[https://github.com/tpope/vim-commentary][vim-commentary]].

** Features:
- Provides the original vim behaviour for commenting out lines via [[https://github.com/linktohack/evil-commentary][evil-commentary]].

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =evil-commentary= to the existing =dotspacemacs-configuration-layers= list in this
file.

* Key bindings

| Key binding | Description                        |
|-------------+------------------------------------|
| ~SPC ;~     | comment operator                   |
| ~gcc~       | comment current line               |
| ~gcap~      | comment paragraphs                 |
| ~gc~        | comment out the target of a motion |
| ~gc SPC y~  | comment up to a line with avy      |
| ~gy~        | comment and yank                   |