NonGNU-devel ELPA - evil-nerd-commenter

Comment/uncomment lines. This command supports negative arguments.

The hotkey is ",cl" in evil-mode and "M-;" in all modes. "M" means ALT key.

If a region selected, the region is expand to make sure the region contain whole lines. Then we comment/uncomment the expanded region. NUM is ignored.

If the region is inside of ONE line, we comment/uncomment that region. In this case, CORRECT comment syntax will be used for C++/Java/Javascript.

This may be the only command you need to learn!

comment/uncomment from current line to the user-specified line. You can input the rightest digit(s) to specify the line number if you want to type less.

For example, say current line number is 497. C-u 3 M-x evilnc-quick-comment-or-uncomment-to-the-line will comment to the line 503 because the rightest digit of "503" is 3.

The hotkey is ",cl" or ",ll" in evil-mode and C-c l (C means Ctrl key) in emacs normal mode.

comment/uncomment paragraphs which is separated by empty lines.

Copy and paste lines, then comment out original lines. This command supports negative arguments.

The hotkey is ",cc" in evil-mode and C-c c in emacs normal mode.

Comment lines and insert original lines into kill-ring.

Comment to the specified line.

Comment or uncomment current html tag or selected region.

It supports html and jsx without any set up. It's not dependent on any third party package.

Please note you don't need force the whole line selection (pressing V) in evil-mode. This command is smart to select whole lines if needed.

Comment or uncomment html tag(s).

If no region is selected, current tag under focus is automatically selected. In this case, only one tag is selected.

If user manually selects region, the region could cross multiple sibling tags and automatically expands to include complete tags. So user only need press v key in evil-mode to select multiple tags.

Or you can use evilnc-comment-or-uncomment-html-paragraphs to comment/uncomment paragraphs containing html tags.

Paragraph is text separated by empty lines.

Sample to combine evilnc-comment-or-uncomment-html-paragraphs and evilnc-comment-or-uncomment-paragraphs:

(defun my-current-line-html-p (paragraph-region)
  (let* ((line (buffer-substring-no-properties (line-beginning-position)
					       (line-end-position)))
	 (re (format "^[ \t]*\\(%s\\)?[ \t]*</?[a-zA-Z]+"
		     (regexp-quote (evilnc-html-comment-start)))))
    ;; current paragraph does contain html tag
    (if (and (>= (point) (car paragraph-region))
	     (string-match-p re line))
	t)))

(defun my-evilnc-comment-or-uncomment-paragraphs (&optional num)
  "Comment or uncomment NUM paragraphs which might contain html tags."
  (interactive "p")
  (unless (featurep 'evil-nerd-commenter) (require 'evil-nerd-commenter))
  (let* ((paragraph-region (evilnc--get-one-paragraph-region))
	 (html-p (or (save-excursion
		       (sgml-skip-tag-backward 1)
		       (my-current-line-html-p paragraph-region))
		     (save-excursion
		       (sgml-skip-tag-forward 1)
		       (my-current-line-html-p paragraph-region)))))
    (if html-p (evilnc-comment-or-uncomment-html-paragraphs num)
      (evilnc-comment-or-uncomment-paragraphs num))))

Toggle the flag to comment/uncomment empty lines.

The hotkey is ",cv" in evil-mode.

Copy from the current line to the user-specified line.

It's for non-evil user only.

You need assign hotkey for it.

For example:

(global-set-key (kbd "C-c C-t C-l") 'evilnc-copy-to-line)

Toggle flag evilnc-invert-comment-line-by-line.

When the flag is true, the command evilnc-comment-or-uncomment-lines, evilnc-comment-or-uncomment-to-the-line, and evilnc-comment-or-uncomment-paragraphs will be influenced. They will invert each line's comment status instead comment the whole thing.

Please note this command may NOT work on complex evil text object.

Kill from the current line to the user-specified line.

It's for non-evil user only.

You need assign hotkey for it.

For example:

(global-set-key (kbd "C-c C-t C-l") 'evilnc-kill-to-line)

If a line is snippet wrapped HTML tags in HTML template, only the HTML syntax is used to comment out the line by default.

But if you (setq evilnc-comment-both-snippet-html t), snippet will be commented out with its own syntax at first. Then the wrapped html tag will be comment out using HTML syntax. This flag has effect on all above commands. Web-mode should be enabled to use this flag.

Comment out N lines, putting it inside a box. N could be negative. If N is nil, comment out current paragraph. This command uses builtin API comment-box.

The hotkey is ",cs" in evil-mode

Please setup `imenu-create-index-function' to `evilnc-imenu-create-index-function'.

Setup on using counsel-imenu to list comments in current buffer,

(defun counsel-imenu-comments ()
  (interactive)
  (let* ((imenu-create-index-function 'evilnc-imenu-create-index-function))
    (unless (featurep 'counsel) (require 'counsel))
    (counsel-imenu)))

C-u NUM M-x evilnc-comment-or-uncomment-lines, comment/uncomment next NUM lines.

Select a region and M-x evilnc-comment-or-uncomment-lines. The region will be automatically expanded to contain whole lines. Then we comment/uncomment the region.

C-u 56 M-x evilnc-comment-or-uncomment-to-the-line, comment/uncomment from current line to line 56.

C-u 2 M-x evilnc-copy-and-comment-lines, copy 2 lines and paste them below the original line. Then comment out original lines. The focus will be moved to the new lines.

C-u 2 M-x evilnc-comment-or-uncomment-paragraphs, comment out two paragraphs. This is useful if you have large hunk of data to be commented out as below:

var myJson={
  "key1":"v1",
  "key2":"v2",
  "key3":"v3"
}

Say there are two lines of javascript code,

if(flag==true){ doSomething(); }
//if(flag==false){ doSomething(); }

The first line is production code. The second line is your debug code. You want to invert the comment status of these two lines (for example, comment out first line and uncomment the second line) for debug purpose.

All you need to is M-x evilnc-toggle-invert-comment-line-by-line then C-u 2 evilnc-comment-or-uncomment-lines. The first command turn on some flag, so the behavior of (un)commenting is different.