From: NRK <nrk@disroot.org>
Date: Thu, 23 Dec 2021 22:51:21 +0000 (+0600)
Subject: make the manpage more clear
X-Git-Tag: v4.5~42^2~7
X-Git-Url: http://www.git.stargrave.org/?a=commitdiff_plain;h=23edf571a7099b58890738cedf7026b7b2f39069;p=nnn.git

make the manpage more clear

some of the terms used in the manpage aren't exactly obvious, especially
to a new user. this is an attempt at making the manual more clear and
remove any potential confusion.

here's a couple issues i've noticed where users were confused due to non
clear manpage description:

https://github.com/jarun/nnn/issues/1268
https://github.com/jarun/nnn/issues/1269
https://github.com/jarun/nnn/issues/1209
---

diff --git a/nnn.1 b/nnn.1
index ba1ac8f5..293f018b 100644
--- a/nnn.1
+++ b/nnn.1
@@ -89,6 +89,7 @@ supports the following options:
 .Pp
 .Fl J
         disable auto-proceed on select
+        (eg. making a selection will no longer move cursor to the next entry)
 .Pp
 .Fl K
         test for keybind collision
@@ -113,10 +114,11 @@ supports the following options:
 .Pp
 .Fl r
         show cp, mv progress
-        (Linux-only, needs advcpmv; '^T' shows the progress on BSD/macOS)
+        (Linux-only, needs \fIadvcpmv\fR; '^T' shows the progress on BSD/macOS)
 .Pp
 .Fl R
-        disable rollover at edges
+        disable rollover at edges (eg. pressing \fIdown\fR while on the last
+        entry will no longer move cursor to the first entry and vice\-versa)
 .Pp
 .Fl "s name"
         load a session by name
@@ -142,8 +144,8 @@ supports the following options:
         show version and exit
 .Pp
 .Fl x
-        show notis on selection cp, mv, rm completion
-        copy path to system clipboard on select
+        show notis on selection cp, mv, rm completion (requires \fI.cbcp\fR plugin)
+        copy path to system clipboard on select (requires \fI.ntfy\fR plugin)
         show xterm title (if non-picker mode)
 .Pp
 .Fl h