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

* Table of Contents                                         :TOC_4_org: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 contribution add it to your =~/.spacemacs=.

#+BEGIN_SRC emacs-lisp
  (setq-default dotspacemacs-configuration-layers '(evil-commentary))
#+END_SRC

* 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              |