Vim plugin for intensely nerdy commenting powers
Go to file
Caleb Maclennan ec802fe1d3
Merge pull request #151 from klaasb/realnesting
Support automatic real nesting of comments without placeholders, if supported by the language.
2016-05-24 16:17:09 +03:00
doc spelling: fix spelling issues 2016-05-23 16:53:22 -04:00
plugin Automatic real nesting for languages with support 2016-05-24 13:52:21 +02:00
.gitignore gitignore the tags file 2010-06-15 10:39:50 +12:00
Rakefile use rakefile from nerdtree 2010-07-21 10:31:49 +08:00
README.md Merge pull request #215 from atk91/patch-1 2016-05-23 22:44:15 +03:00

Installation

*For simplicity, let's use [VIM_ROOT] which will mean ~/.vim (*nix) or ~/vimfiles (Windows)

The NERD Commenter requires Vim 7 or higher is comprised of 2 files:

plugin/NERD_commenter.vim  
doc/NERD_commenter.txt 

Classic Install

  1. Extract the plugin files into your [VIM_ROOT]/plugin and [VIM_ROOT]/doc folders respectively.
  2. Finish the install by updating your help files. Run:
:helptags [VIM_ROOT]/doc

See |add-local-help| for more details.

Pathogen Install

  1. Navigate to your [VIM_ROOT]/bundle directory in your local Vim setup
  2. git clone https://github.com/scrooloose/nerdcommenter.git

Vundle Install

  1. Add Plugin 'scrooloose/nerdcommenter' to your .vimrc file.
  2. Run :BundleInstall

Post Install

After the 'Classic' or 'Pathogen' install, make sure that you have filetype plugins enabled, as the script makes use of
|'commentstring'| where possible (which is usually set in a filetype plugin).
See |filetype-plugin-on| for details, but basically, stick this in your vimrc:

filetype plugin on

Usage

The following key mappings are provided by default (there is also a menu
provided that contains menu items corresponding to all the below mappings):

Most of the following mappings are for normal/visual mode only. The |NERDComInsertComment| mapping is for insert mode only.

[count]<leader>cc |NERDComComment|
Comment out the current line or text selected in visual mode.

[count]<leader>cn |NERDComNestedComment|
Same as <leader>cc but forces nesting.

[count]<leader>c<space> |NERDComToggleComment|
Toggles the comment state of the selected line(s). If the topmost selected
line is commented, all selected lines are uncommented and vice versa.

[count]<leader>cm |NERDComMinimalComment|
Comments the given lines using only one set of multipart delimiters.

[count]<leader>ci |NERDComInvertComment|
Toggles the comment state of the selected line(s) individually.

[count]<leader>cs |NERDComSexyComment|
Comments out the selected lines ``sexily''

[count]<leader>cy |NERDComYankComment|
Same as <leader>cc except that the commented line(s) are yanked first.

<leader>c$ |NERDComEOLComment|
Comments the current line from the cursor to the end of line.

<leader>cA |NERDComAppendComment|
Adds comment delimiters to the end of line and goes into insert mode between
them.

|NERDComInsertComment|
Adds comment delimiters at the current cursor position and inserts between.
Disabled by default.

<leader>ca |NERDComAltDelim|
Switches to the alternative set of delimiters.

[count]<leader>cl
[count]<leader>cb |NERDComAlignedComment|
Same as |NERDComComment| except that the delimiters are aligned down the
left side (<leader>cl) or both sides (<leader>cb).

[count]<leader>cu |NERDComUncommentLine|
Uncomments the selected line(s).