From 9c1c6c18ae2de1699fcdbf39c486973b86b5947f Mon Sep 17 00:00:00 2001
From: Benno Schulenberg <bensberg@telfort.nl>
Date: Mon, 13 Dec 2021 16:44:25 +0100
Subject: [PATCH] docs: explain what it means when --rawsequences is needed

---
 doc/nano.1    | 10 ++++++----
 doc/nano.texi | 20 ++++++++++++--------
 doc/nanorc.5  | 10 ++++++----
 3 files changed, 24 insertions(+), 16 deletions(-)

diff --git a/doc/nano.1 b/doc/nano.1
index b0db1a47..1aedd605 100644
--- 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
index f1ce71c6..7510c229 100644
--- 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
index 5b5fde23..0e202a1c 100644
--- 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