Skip to content

gennaro-tedesco/nvim-commaround

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nvim-commaround

PR Lua

toggle comments on and off

nvim-commaround comes and goes around, comments up and down! It toggles comments for visual blocks or inline code according to the buffer filetype: it works out of the box, it is awesome!

Installation

Install it using your favourite plugin manager; for instance if you are using vim-plug

Plug 'gennaro-tedesco/nvim-commaround'

Usage

Visually select the lines you want to act on and toggle commaround: the default mapping is

vmap <leader>c <Plug>ToggleCommaround

The plugin detects the buffer filetype and inserts block or line comments according to the selection.

demo

Customisation

The list of filetypes configuration characters can be found here. To add comment characters for a new filetype (or to modify the existing ones) specify the below in your nvim configurations (init.vim or any other option file being sourced at start-up), say

lua require('nvim-commaround.config').config["todo"] = {single = "--!", block = {left = "/*!", right = "!*/"}}

replacing "todo" with any specific filetype; leave {single = "--!", block = nil} in case no block comments are available.

To change the default mapping to toggle comments define any right hand side of the option below, for example

let g:toggle_commaround = 'gcc'

Unit tests

We make use of the busted framework for unit tests; run them with

busted -C lua

Feedback

If you find this plugin useful consider awarding it a ⭐, it is a great way to give feedback! Otherwise, any additional suggestions or merge request is warmly welcome!

About

nvim plugin to toggle comments on and off

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages