Add examples of useful commands to run as plugin

diff --git a/nnn.1 b/nnn.1
index ccf2a9d9aec9fe8d3bce9afefc01582f91453713..ee555f648407ac44183c1b269993e8c22ae478a9 100644 (file)
--- a/nnn.1
+++ b/nnn.1
@@ -214,6 +214,18 @@ when dealing with the !, e and p commands respectively. A single combination to
     5. To skip user confirmation after command execution, suffix with \fB*\fR
 
     export NNN_PLUG='y:-_sync*'
+
+    EXAMPLES:
+    ----------------------------------- + -------------------------------------------------
+                Key:Command             |                   Description
+    ----------------------------------- + -------------------------------------------------
+    k:-_fuser -kiv $nnn*                | Interactively kill process(es) using hovered file
+    l:_git log                          | Show git log
+    n:-_vi /home/user/Dropbox/dir/note* | Take quick notes in a synced file/dir of notes
+    s:_smplayer -minigui $nnn*          | Play hovered media file, even unfinished download
+    x:_chmod +x $nnn                    | Make the hovered file executable
+    y:-_sync*                           | Flush cached writes
+    ----------------------------------- + -------------------------------------------------
 .Ed
 .Pp
 \fBNNN_USE_EDITOR:\fR use VISUAL (else EDITOR, preferably CLI, fallback vi) to handle text files.

diff --git a/plugins/README.md b/plugins/README.md
index 60fa5c05d395589b5071a56c695cea20f350047d..e19c216d9b5b65706342c8b517b524b140a46c9b 100644 (file)
--- a/plugins/README.md
+++ b/plugins/README.md
@@ -106,6 +106,17 @@ Notes:
 3. (_Again_) add `_` before the command
 4. To disable directory refresh after running a _command as plugin_, prefix the command with `-_`
 
+#### Some useful key-command examples
+
+| Key:Command | Description |
+|---|---|
+| `k:-_fuser -kiv $nnn*` | Interactively kill process(es) using hovered file |
+| `l:_git log` | Show git log |
+| `n:-_vi /home/user/Dropbox/dir/note*` | Take quick notes in a synced file/dir of notes |
+| `s:_smplayer -minigui $nnn*` | Play hovered media file, even unfinished download |
+| `x:_chmod +x $nnn` | Make the hovered file executable |
+| `y:-_sync*` | Flush cached writes |
+
 ## Access level of plugins
 
 When `nnn` executes a plugin, it does the following: