From 2e2a40ea09f0bcbef1f80dc3d9b3ef82f03c5936 Mon Sep 17 00:00:00 2001
From: Benno Schulenberg <bensberg@telfort.nl>
Date: Fri, 23 Jan 2026 16:51:24 +0100
Subject: [PATCH] docs: document the new --solosidescroll and 'set
 solosidescroll' options

These re-enable the historical jerky single-line sideways scrolling.
---
 doc/nano.1           |  8 ++++++++
 doc/nano.texi        | 17 +++++++++++++++++
 doc/nanorc.5         |  8 ++++++++
 doc/sample.nanorc.in |  3 +++
 4 files changed, 36 insertions(+)

diff --git a/doc/nano.1 b/doc/nano.1
index d56ecb3d..34a81606 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -412,6 +412,14 @@ Furthermore, \fB^A\fR sets the mark,
 \fB^P\fR shows the position, \fB^T\fR goes to a line,
 \fB^W\fR writes out a file, and \fB^E\fR executes a command.
 Note that this overrides option \fB\-p\fR (\fB\-\-preserve\fR).
+.TP
+.BR \-1 ", " \-\-solosidescroll
+When the cursor approaches the right edge of the edit window, scroll only the
+current line sideways by a large amount, instead of scrolling all visible lines
+sideways by just the amount needed to keep the cursor in view.
+This latter whole-window smooth sideways scrolling is the new default behavior.
+The single-line jerky sideways scrolling enabled by this option was the old
+behavior \(em the only behavior that \fBnano\fR knew.
 
 .SH TOGGLES
 Several of the above options can be switched on and off also while
diff --git a/doc/nano.texi b/doc/nano.texi
index f2ba0980..01fe0ada 100644
--- a/doc/nano.texi
+++ b/doc/nano.texi
@@ -789,6 +789,15 @@ Furthermore, @kbd{^A} sets the mark,
 @kbd{^W} writes out a file, and @kbd{^E} executes a command.
 Note that this overrides option @option{-p} (@option{--preserve}).
 
+@item -1
+@itemx --solosidescroll
+When the cursor approaches the right edge of the edit window, scroll only the
+current line sideways by a large amount, instead of scrolling all visible lines
+sideways by just the amount needed to keep the cursor in view.
+This latter whole-window smooth sideways scrolling is the new default behavior.
+The single-line jerky sideways scrolling enabled by this option was the old
+behavior --- the only behavior that @command{nano} knew.
+
 @end table
 
 @sp 1
@@ -1187,6 +1196,14 @@ Display lines that exceed the screen's width over multiple screen lines.
 (You can make this soft-wrapping occur at whitespace instead of rudely at
 the screen's edge, by using also @code{set atblanks}.)
 
+@item set solosidescroll
+When the cursor approaches the right edge of the edit window, scroll only the
+current line sideways by a large amount, instead of scrolling all visible lines
+sideways by just the amount needed to keep the cursor in view.
+This latter whole-window smooth sideways scrolling is the new default behavior.
+The single-line jerky sideways scrolling enabled by this option was the old
+behavior --- the only behavior that @command{nano} knew.
+
 @item set speller "@var{program} [@var{argument} @dots{}]"
 Use the given program to do spell checking and correcting.
 @xref{@option{--speller}} for details.
diff --git a/doc/nanorc.5 b/doc/nanorc.5
index 6bb797de..5199b77c 100644
--- a/doc/nanorc.5
+++ b/doc/nanorc.5
@@ -332,6 +332,14 @@ Display lines that exceed the screen's width over multiple screen lines.
 (You can make this soft-wrapping occur at whitespace instead of rudely at
 the screen's edge, by using also \fBset atblanks\fR.)
 .TP
+.B set solosidescroll
+When the cursor approaches the right edge of the edit window, scroll only the
+current line sideways by a large amount, instead of scrolling all visible lines
+sideways by just the amount needed to keep the cursor in view.
+This latter whole-window smooth sideways scrolling is the new default behavior.
+The single-line jerky sideways scrolling enabled by this option was the old
+behavior \(em the only behavior that \fBnano\fR knew.
+.TP
 .B set speller """\fIprogram\fR [\fIargument \fR...]\fB"""
 Use the given \fIprogram\fR to do spell checking and correcting, instead of
 using the built-in corrector that calls \fBhunspell\fR(1) or \fBspell\fR(1).
diff --git a/doc/sample.nanorc.in b/doc/sample.nanorc.in
index 4b81f360..c4fad00e 100644
--- a/doc/sample.nanorc.in
+++ b/doc/sample.nanorc.in
@@ -171,6 +171,9 @@
 ## Spread overlong lines over multiple screen lines.
 # set softwrap
 
+## Scroll only the current line sideways (instead of all lines).
+# set solosidescroll
+
 ## Use this spelling checker instead of the internal one.  This option
 ## does not have a default value.
 # set speller "aspell -x -c"