commit dc99610c36603d451709b844a7fc0d582906bc2b
parent d3c0fe392316400257b57efcacc9b313808cf1b9
Author: Benno Schulenberg <bensberg@telfort.nl>
Date: Fri, 28 Dec 2018 19:20:40 +0100
docs: reword and reshuffle the description of --rawsequences
It's not just about the numeric keypad, but about the interpretation
of all editing keys (arrows, Home, End, PageUp, PageDown, Insert, and
Delete), of the escape sequences that they produce.
Diffstat:
4 files changed, 23 insertions(+), 19 deletions(-)
diff --git a/doc/nano.1 b/doc/nano.1
@@ -102,9 +102,10 @@ executed commands, so they can be easily reused in later sessions.
Don't look at the system's \fInanorc\fR nor at the user's \fInanorc\fR.
.TP
.BR \-K ", " \-\-rawsequences
-Interpret the numeric keypad keys so that they all work properly. You
-should only need to use this option if they don't, as mouse support
-won't work properly with this option enabled.
+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.
.TP
.BR \-L ", " \-\-nonewlines
Don't automatically add a newline when a file does not end with one.
diff --git a/doc/nano.texi b/doc/nano.texi
@@ -192,9 +192,10 @@ Don't look at the system's nanorc file nor at the user's nanorc.
@item -K
@itemx --rawsequences
-Interpret the numeric keypad keys so that they all work properly. You
-should only need to use this option if they don't, as mouse support
-won't work properly with this option enabled.
+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.
@item -L
@itemx --nonewlines
@@ -834,16 +835,17 @@ is an extended regular expression. The default value is
@t{"^([@w{ }\t]*([#:>|@}]|//))+"}.
Note that @code{\t} stands for a literal Tab character.
+@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.
+
@item set rebinddelete
Interpret the Delete key differently so that both Backspace and Delete
work properly. You should only need to use this option if Backspace
acts like Delete on your system.
-@item set rawsequences
-Interpret the numeric keypad keys so that they all work properly. You
-should only need to use this option if they don't, as mouse support
-won't work properly with this option enabled.
-
@item set regexp
Do extended regular expression searches by default.
diff --git a/doc/nanorc.5 b/doc/nanorc.5
@@ -201,16 +201,17 @@ is an extended regular expression. The default value is
"\fB^([\ \\t]*([#:>|}]|//))+\fP". Note that \fB\\t\fR stands for an actual
Tab character.
.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.
+.TP
.B set rebinddelete
Interpret the Delete key differently so that both Backspace and Delete
work properly. You should only need to use this option if Backspace
acts like Delete on your system.
.TP
-.B set rawsequences
-Interpret the numeric keypad keys so that they all work properly. You
-should only need to use this option if they don't, as mouse support
-won't work properly with this option enabled.
-.TP
.B set regexp
Do extended regular expression searches by default.
.TP
diff --git a/doc/sample.nanorc.in b/doc/sample.nanorc.in
@@ -126,12 +126,12 @@
## This is an extended regular expression. The default is:
# set quotestr "^([ ]*([#:>|}]|//))+"
+## Try to work around a mismatching terminfo terminal description.
+# set rawsequences
+
## Fix Backspace/Delete confusion problem.
# set rebinddelete
-## Fix numeric keypad key confusion problem.
-# set rawsequences
-
## Do extended regular expression searches by default.
# set regexp
