~ / neovim / comment-blockslesson 4/7

Comment blocks: gcgc, dgc and ygc

Treat a run of commented lines as one text object.

?how it works

After an operator, gc is also a text object: the largest block of commented lines around the cursor. It works with any operator:

gcgc uncomments the whole block (the gc operator applied to the gc object).
dgc deletes it, which is great for clearing out dead code.
ygc yanks it, so you can paste a commented example somewhere else.

The block stops at the first line that isn't a comment, and an empty line counts as not a comment. If the cursor isn't on a comment, nothing happens. The cursor can be on any line of the block, so there's nothing to count.

In Visual mode, gc toggles the selected lines, so Vjjgc works too, but an operator plus a motion or the gc object is usually shorter.

⌨keys

`gcgc`	uncomment the comment block around the cursornvim
`dgc`	delete the comment block around the cursornvim
`ygc`	yank the comment block around the cursornvim
`{Visual}gc`	toggle comments on the selected linesnvim

Nin neovim

The gc text object is a Neovim default too (:h o_gc), and it only exists after an operator: in Normal and Visual mode gc is the comment toggle.

3 drills

Bring a block back with gcgc: Uncomment the whole commented block around the cursor.
Clear dead code with dgc: Delete the commented-out block around the cursor.
Copy a commented example with ygc: Copy the commented-out example to the end of the file, then uncomment the copy (leave the original as it is).

The drill editor loads in your browser.