commentary.vim : Comment stuff out; takes a motion as a target
| script karma
Downloaded by 1558
Comments, bugs, improvements
script versions (upload new version)
|Comment stuff out. 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), and gc in visual mode to comment out the selection. That's it.
I wrote this because 5 years after Vim added support for mapping an operator, I still couldn't find a commenting plugin that leveraged that feature (I overlooked vimscript #1173). Striving for minimalism, the first version weighs in at just 35 lines of code.
Oh, and it uncomments, too. The above maps actually toggle, and `gcu` uncomments a set of adjacent commented lines. Install repeat.vim, vimscript #2136, to enable repeating with . the line commenting map gcu. (The other maps are repeatable without it.)
|You know the drill.|
Click on the package to download.
ip used for rating: 220.127.116.11
||Provide :Commentary command.
Provide gc text object.
Support comments with no leading space.
Preserve whitespace in b:commentary_format.
Allow disabling backslash maps.
Fix count with linewise map.
Don't trigger modelines after commenting.
||Switch official interface from \\ to gc. \\ still works.
Allow overriding 'commentstring' with b:commentary_format.
Add User CommentaryPost callback.
||Smarter indentation handling.
Always pad with whitespace.
Support nesting: /* /1* abc *1/ */.
Support custom maps.