[PATCH 31/31] docs: apply "poor man's keeps"

"G. Branden Robinson" <[email protected]> Thu, 23 Apr 2026 18:01:55 -0500
Newsgroups	gmane.editors.nano.devel
Message-ID	<20260423230155.2ktquleu3evlppwz@illithid>
Paginate more pleasantly when typesetting on U.S. letter paper format,
preventing individual lines of output text from "stranding" on one side
or the other of a page boundary.  (These are known in typography as
"widows" and "orphans", unfortunately with two contradictory
interpretation traditions.)

This is purely a cosmetic enhancement with no effect in the "continuous
rendering" mode used when groff renders HTML or (by default) to terminal
devices.
---
 doc/nano.1   | 18 ++++++++++++++++++
 doc/nanorc.5 | 12 +++++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/doc/nano.1 b/doc/nano.1
index 3b2bd237..3a697978 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -122,11 +122,15 @@ .SS Editing
 highlighted), and then use \fB\[ha]K\fR to cut it, or \fBM\-6\fR to copy it to
 the cutbuffer.  You can also save the marked text to a file with \fB\[ha]O\fR,
 or spell check it with \fB\[ha]T\[ha]T\fR.
+.br
+.ne 3v
 .P
 On some terminals, text can be selected also by holding down Shift while
 using the arrow keys.  Holding down the Ctrl or Alt key too increases
 the stride.
 Any cursor movement without Shift being held cancels such a selection.
+.br
+.ne 3v
 .P
 Any valid Unicode code point can be inserted into the buffer by typing
 \fBM\-V\fR followed by the hexadecimal digits of the code point (concluded
@@ -201,6 +205,8 @@ .SH Options
 .TQ
 .B \-\-ignorercfiles
 Don't look at the system's \fInanorc\fR nor at the user's \fInanorc\fR.
+.br
+.ne 4v
 .TP
 .BI "\-J " number
 .TQ
@@ -278,6 +284,8 @@ .SH Options
 Display over multiple screen rows lines that exceed the screen's width.
 (You can make this soft-wrapping occur at whitespace instead of rudely at
 the screen's edge, by using also \fB\-\-atblanks\fR.)
+.br
+.ne 4v
 .TP
 .BI "\-T " number
 .TQ
@@ -358,12 +366,16 @@ .SH Options
 .TQ
 .B \-\-emptyline
 Do not use the line below the title bar, leaving it entirely blank.
+.br
+.ne 4v
 .TP
 .BI "\-f " file
 .TQ
 .BI \-\-rcfile= file
 Read only this \fIfile\fR for setting \fBnano\fR's options, instead of reading
 both the system-wide and the user's \fInanorc\fR files.
+.br
+.ne 4v
 .TP
 .B \-g
 .TQ
@@ -431,6 +443,8 @@ .SH Options
 Preserve the XOFF and XON sequences (\fB\[ha]S\fR and \fB\[ha]Q\fR) so that
 they are caught by the terminal (stopping and resuming the output).
 Note that option \fB\-/\fR (\fB\-\-modernbindings\fR) overrides this.
+.br
+.ne 4v
 .TP
 .B \-q
 .TQ
@@ -438,6 +452,8 @@ .SH Options
 Display a \[lq]scrollbar\[rq] on the righthand side of the edit window.
 It shows the position of the viewport in the buffer
 and how much of the buffer is covered by the viewport.
+.br
+.ne 5v
 .TP
 .BI "\-r " number
 .TQ
@@ -554,6 +570,8 @@ .SH Options
 and disappears after 1.5 seconds or upon the next keystroke.
 With \fBM\-Z\fR the title bar plus status bar can be toggled.
 With \fBM\-X\fR the help lines.
+.br
+.ne 4v
 .TP
 .B \-1
 .TQ
diff --git a/doc/nanorc.5 b/doc/nanorc.5
index 8c697d49..fc87a696 100644
--- a/doc/nanorc.5
+++ b/doc/nanorc.5
@@ -340,6 +340,8 @@ .SH Options
 Put the cursor on the highlighted item in the file browser, and show
 the cursor in the help viewer, to aid braille users and people with
 poor vision.
+.br
+.ne 4v
 .TP
 .B set smarthome
 Make the Home key smarter.  When Home is pressed anywhere but at the
@@ -490,6 +492,8 @@ .SS "Syntax highlighting"
 When you need this combination inside a regular expression,
 then either the double quote or the blank should be put
 between square brackets (\fB[]\fR).
+.br
+.ne 4v
 .P
 For each kind of file a separate syntax can be defined
 via the following commands:
@@ -523,7 +527,9 @@ .SS "Syntax highlighting"
 result of querying the
 .MR magic 5
 database about the current
-file, to determine whether this syntax should be used for it.
+file, to determine whether this
+.ne 2v
+syntax should be used for it.
 (This querying is done only when \fIlibmagic\fR is actually installed
 on the system and \fB\-\-magic\fR or \[lq]\fBset magic\fR\[rq] was given.)
 .TP
@@ -729,6 +735,8 @@ .SS "Rebinding keys"
 .B zap
 Throws away the current line (or the marked region).
 (This function is bound by default to <Meta+Delete>.)
+.br
+.ne 4v
 .TP
 .B chopwordleft
 Deletes from the cursor position to the beginning of the preceding word.
@@ -1147,6 +1155,8 @@ .SH Files
 .TP
 .I /etc/nanorc
 System-wide configuration file.
+.br
+.ne 4v
 .TP
 .I \[ti]/.nanorc
 .TQ
-- 
2.30.2
signature.asc (application/pgp-signature, 833 B)