commit 9c1c6c18ae2de1699fcdbf39c486973b86b5947f
parent fae5f823e15a6682f50f03ea615fd829fb75f31f
Author: Benno Schulenberg <bensberg@telfort.nl>
Date: Mon, 13 Dec 2021 16:44:25 +0100
docs: explain what it means when --rawsequences is needed
Diffstat:
3 files changed, 24 insertions(+), 16 deletions(-)
diff --git a/doc/nano.1 b/doc/nano.1
@@ -140,10 +140,12 @@ text. (The color of the stripe can be changed with \fBset stripecolor\fR
in your \fInanorc\fR file.)
.TP
.BR \-K ", " \-\-rawsequences
-Interpret escape sequences directly (instead of asking \fBncurses\fR to
-translate them). If you need this option to get your keyboard to work
-properly, please report a bug. Using this option disables \fBnano\fR's
-mouse support.
+Interpret escape sequences directly, instead of asking \fBncurses\fR
+to translate them. (If you need this option to get some keys to work
+properly, it means that the terminfo terminal description that is used
+does not fully match the actual behavior of your terminal. This can
+happen when you ssh into a BSD machine, for example.)
+Using this option disables \fBnano\fR's mouse support.
.TP
.BR \-L ", " \-\-nonewlines
Don't automatically add a newline when a text does not end with one.
diff --git a/doc/nano.texi b/doc/nano.texi
@@ -425,10 +425,12 @@ in your nanorc file.)
@item -K
@itemx --rawsequences
-Interpret escape sequences directly (instead of asking @code{ncurses} to
-translate them). If you need this option to get your keyboard to work
-properly, please report a bug. Using this option disables @command{nano}'s
-mouse support.
+Interpret escape sequences directly, instead of asking @code{ncurses}
+to translate them. (If you need this option to get some keys to work
+properly, it means that the terminfo terminal description that is used
+does not fully match the actual behavior of your terminal. This can
+happen when you ssh into a BSD machine, for example.)
+Using this option disables @command{nano}'s mouse support.
@item -L
@itemx --nonewlines
@@ -1053,10 +1055,12 @@ This makes it possible to rejustify blocks of quoted text when composing
email, and to rewrap blocks of line comments when writing source code.
@item set rawsequences
-Interpret escape sequences directly (instead of asking @code{ncurses} to
-translate them). If you need this option to get your keyboard to work
-properly, please report a bug. Using this option disables @command{nano}'s
-mouse support.
+Interpret escape sequences directly, instead of asking @code{ncurses}
+to translate them. (If you need this option to get some keys to work
+properly, it means that the terminfo terminal description that is used
+does not fully match the actual behavior of your terminal. This can
+happen when you ssh into a BSD machine, for example.)
+Using this option disables @command{nano}'s mouse support.
@item set rebinddelete
Interpret the @kbd{Delete} and @kbd{Backspace} keys differently so that
diff --git a/doc/nanorc.5 b/doc/nanorc.5
@@ -271,10 +271,12 @@ This makes it possible to rejustify blocks of quoted text when composing
email, and to rewrap blocks of line comments when writing source code.
.TP
.B set rawsequences
-Interpret escape sequences directly (instead of asking \fBncurses\fR to
-translate them). If you need this option to get your keyboard to work
-properly, please report a bug. Using this option disables \fBnano\fR's
-mouse support.
+Interpret escape sequences directly, instead of asking \fBncurses\fR
+to translate them. (If you need this option to get some keys to work
+properly, it means that the terminfo terminal description that is used
+does not fully match the actual behavior of your terminal. This can
+happen when you ssh into a BSD machine, for example.)
+Using this option disables \fBnano\fR's mouse support.
.TP
.B set rebinddelete
Interpret the Delete and Backspace keys differently so that both Backspace
