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

#+TITLE: Evil-commentary layer

* Table of Contents                                         :TOC_4_gh:noexport:
- [[#description][Description]]
- [[#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]].

- Use ~gcc~ to comment out a line (takes a count),
- ~gc~ to comment out the target of a motion (for example,
- ~gcap~ to comment out a paragraph), ~gc~ in visual
  mode to comment out the selection.

For more details see the [[https://github.com/linktohack/evil-commentary][evil-commentary]] repository.

* 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 SPC y~  | comment up to a line with avy |
| ~gy~        | comment and yank              |