[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/evil-nerd-commenter 6d1e01bfb5 076/235: updated README
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/evil-nerd-commenter 6d1e01bfb5 076/235: updated README |
Date: |
Thu, 6 Jan 2022 02:59:36 -0500 (EST) |
branch: elpa/evil-nerd-commenter
commit 6d1e01bfb52598083efd61d7c2b5b6e81c8404bc
Author: Chen Bin <chenbin.sh@gmail.com>
Commit: Chen Bin <chenbin.sh@gmail.com>
updated README
---
README.org | 37 ++++++++++++++++++++-----------------
1 file changed, 20 insertions(+), 17 deletions(-)
diff --git a/README.org b/README.org
index 76df077ba7..c48db53d40 100644
--- a/README.org
+++ b/README.org
@@ -1,16 +1,14 @@
* evil-nerd-commenter (v1.3.1)
-*Please note this program could be used independently WITHOUT evil-mode!*
+*This program could be used independently WITHOUT evil-mode!*
-As a developer, I often need comment/uncomment lines for debugging or adding
some short comment in the code block.
+This program is [[http://www.vim.org/scripts/script.php?script_id=1218][Nerd
Commenter]] simulator which help you comment lines efficiently.
-As I know, the [[http://www.vim.org/scripts/script.php?script_id=1218][Nerd
Commenter]] for Vim is the most efficient way to doing this thing.
Unfortunately, there is no similar plugin in Emacs.
+Other useful utilities are added to make it better than the original VIM
plugin. For example, you can copy and comment lines in one step
-That's why I develop this Nerd Commenter simulator for Emacs people. Besides,
I'm also adding my own utilities into this plugin. For example, a command to
comment© lines is added recently.
+I recommend you use it with [[http://gitorious.org/evil][evil]] though evil is
optional.
-I highly recommend you use it with [[http://gitorious.org/evil][evil]].
-
-Evil makes you take advantage of power of Vi to comment lines in shocking
speed. For example, you can press key `,,99j` or `99,ci` to comment out 99
lines.
+Evil is a Vim simulator which makes text manipulation very efficient. For
example, you can press key `,,99j` or `99,ci` to comment out 99 lines.
* Why evil-nerd-commenter is better?
** A simple use case on the efficiency
@@ -61,7 +59,7 @@ Further explanation, the content of evilnc-default-hotkeys is:
As you can see, the default hot key for commenting lines is "M-;" when you
don't use [[http://emacswiki.org/emacs/Evil][evil-mode]].
The advantage of use "M-;" is you can set mark on the first line and scroll
several pages down and comment all the lines in that region by "M-;". The key
point here is you save the extra two key strikes to make marked region wrap the
whole content of first and last line.
-I prefer vi key binds. So I also use
[[http://emacswiki.org/emacs/Evil][evil-mode]]. Evil-mode is only *optional*!
Some people dont use it because they prefer emacs native key binding.
+I prefer vi key binds. So I also use
[[http://emacswiki.org/emacs/Evil][evil-mode]]. Evil-mode is only *optional*!
Some people don't use it because they prefer emacs native key binding.
Feel free to copy the content of evilnc-default-hotkeys into your .emacs
instead calling it directly. So you can define your own hotkeys.
@@ -91,29 +89,31 @@ If you don't use emacs package manager (Why?) to install
evil-nerd-commenter the
* Usage
** Available commands and hot keys
Here are available commands. They are not dependent on
[[http://emacswiki.org/emacs/Evil][evil-mode]]:
-*** evilnc-comment-or-uncomment-lines (HIGHLY RECOMMENDED)
+*** evilnc-comment-or-uncomment-lines (RECOMMENDED)
comment/uncomment lines. This command supports negative arguments.
The hotkey is ",ci" in evil-mode and "M-;" (M means Alt key) in emacs normal
mode.
*This may be the only command and hot key you need to learn!*
-*** evilnc-comment-or-uncomment-to-the-line (RECOMMENDED)
-comment/uncomment from current line to the user-specified line.
+*** evilnc-quick-comment-or-uncomment-to-the-line (RECOMMENDED)
+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.
-The hotkey is ",cl" in evil-mode and "C-c l" (C means Ctrl key) in emacs
normal mode.
+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
beause the rightest digit of "503" is 3.
-*** evilnc-copy-and-comment-lines (RECOMMENDED)
-copy and paste lines, then comment out original lines. This command supports
negative arguments.
+The hotkey is ",cl" or ",ll" in evil-mode and "C-c l" (C means Ctrl key) in
emacs normal mode.
+*** evilnc-comment-or-uncomment-paragraphs (RECOMMENDED)
+comment/uncomment paragraphs which separated by empty lines
-The hotkey is ",cc" in evil-mode and "C-c c" in emacs normal mode.
+*** evilnc-copy-and-comment-lines
+copy and paste lines, then comment out original lines. This command supports
negative arguments.
-*** evilnc-comment-or-uncomment-paragraphs (HIGHLY RECOMMENDED)
-comment/uncomment paragraphs which separated by empty lines
+The hotkey is ",cc" in evil-mode and "C-c c" in emacs normal mode.
*** evilnc-toggle-comment-empty-lines
toggle the flag to comment/uncomment empty lines.
+The hotkey is ",cv" in evil-mode.
*** evilnc-copy-to-line
Copy from the current line to the user-specified line.
@@ -143,6 +143,9 @@ For example:
(global-set-key (kbd "C-c C-t C-l") 'evilnc-kill-to-line)
#+END_SRC
+*** evilnc-comment-or-uncomment-to-the-line
+Comment to the specified line. evilnc-quick-comment-or-uncomment-to-the-line
may be better alternative.
+
** Examples
*** Example 1
"C-u NUM M-x evilnc-comment-or-uncomment-lines", comment/uncomment next NUM
lines.
- [nongnu] elpa/evil-nerd-commenter e1d39be8e3 044/235: Added additional evil example, (continued)
- [nongnu] elpa/evil-nerd-commenter e1d39be8e3 044/235: Added additional evil example, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 237040205e 046/235: Made definition of evilnc-comment-operator a callable function, evilnc-define-comment-operator. Only does anything if 'evil-define-operator bound and 'evilnc-comment-operator isn't., ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter fbd9d01a8c 043/235: Added visual map to readme recommendations, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter b9cfe0c7a6 054/235: some evil tips, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 69a8710e3d 053/235: v1.2.4, updated doc on set up, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 9c43de8b19 064/235: Merge pull request #22 from chrueg/master, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter ee14b9def5 057/235: invert line done, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter b456b82cce 068/235: Merge pull request #24 from untf/master, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter e6a8ef9399 072/235: minor wording error, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter b44141bd06 074/235: Revert "minor wording error", ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 6d1e01bfb5 076/235: updated README,
ELPA Syncer <=
- [nongnu] elpa/evil-nerd-commenter 2dc8d8dd6c 078/235: README updated, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 337c66f376 080/235: web-mode is supported v1.5.0, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 627ac531a1 085/235: issue 5 the evil-visual 100 percent resolved, v1.5.1, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 906f532241 092/235: M-; should start a comment on an empty line #34 v1.5.3, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 4d03da77c8 093/235: Make copy-and-comment interactive, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter fe82e6a0ff 091/235: README v1.5.2, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 81e16b5fd1 095/235: Merge branch 'TheBB-master', ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 155d608d21 094/235: v1.5.4 minor fix, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter f1fe14e756 102/235: updated workaround doc for emacs24.4, ELPA Syncer, 2022/01/06
- [nongnu] elpa/evil-nerd-commenter 7557777d8f 103/235: Try to require evil when compiling, ELPA Syncer, 2022/01/06