nnn.1 | 12 ++++++++++++ plugins/README.md | 11 +++++++++++ diff --git a/nnn.1 b/nnn.1 index ccf2a9d9aec9fe8d3bce9afefc01582f91453713..ee555f648407ac44183c1b269993e8c22ae478a9 100644 --- a/nnn.1 +++ b/nnn.1 @@ -214,6 +214,18 @@ 4. To disable directory refresh after running a \fIcommand as plugin\fR, prefix the command with \fB-_\fR 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 --- a/plugins/README.md +++ b/plugins/README.md @@ -106,6 +106,17 @@ 2. `$nnn` should be the last argument (IF you want to pass the hovered file name) 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: