[PATCH 05/31] docs: move `hw` and update request invocation

"G. Branden Robinson" <[email protected]> Thu, 23 Apr 2026 17:57:50 -0500
Newsgroups	gmane.editors.nano.devel
Message-ID	<20260423225750.htgkbw3jp4pfwc4s@illithid>
Drop "terminfo" as a hyphenation exception word.  It hyphenates
idiomatically: "term-info" (whereas "ncur-ses" looks strange to a human
reader of English), and a forthcoming change will prevent its
hyphenation anyway.

Add nano configuration keywords as necessary to hyphenation word
exception list, making unnecessary several occurrences of `\%` escape
sequence to suppress hyphenation on a nonce basis.

Prefix "(--preserve)" with `\%` to prevent its hyphenation since
"preserve" is an English word and should still be hyphenated when used
in a mundane sense.
---
 doc/nano.1   |  7 +++----
 doc/nanorc.5 | 27 +++++++++++++--------------
 2 files changed, 16 insertions(+), 18 deletions(-)

diff --git a/doc/nano.1 b/doc/nano.1
index 2e61bc5d..18acf61f 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -21,6 +21,8 @@
 .SH NAME
 nano \- Nano's ANOther text editor, inspired by Pico
 .
+.hw ncurses quickblank
+.
 .SH SYNOPSIS
 .B nano
 .RI [ options "] [[\fB+" line [\fB, column "]] " file ]...
@@ -121,9 +123,6 @@ .SH EDITING
 The default key bindings can be changed via a \fInanorc\fR file \(em see
 .BR nanorc (5).
 .
-.\" Never hyphenate these:
-.hw ncurses terminfo
-.
 .SH OPTIONS
 .TP
 .BR \-A ", " \-\-smarthome
@@ -436,7 +435,7 @@ .SH OPTIONS
 \fB^D\fR searches previous, \fB^R\fR makes replacements,
 \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 option overrides option \fB\-p\fR (\fB\-\-preserve\fR).
+Note that this option overrides option \fB\-p\fR \%(\fB\-\-preserve\fR).
 .
 .SH TOGGLES
 Several of the above options can be switched on and off also while
diff --git a/doc/nanorc.5 b/doc/nanorc.5
index 9288d4b7..4afa99d4 100644
--- a/doc/nanorc.5
+++ b/doc/nanorc.5
@@ -21,6 +21,8 @@
 .SH NAME
 nanorc \- GNU nano's configuration file
 .
+.hw constantshow ncurses quickblank stateflags titlecolor
+.
 .SH DESCRIPTION
 The \fInanorc\fR files contain the default settings for \fBnano\fR,
 a small and friendly text editor.  During startup, if \fB\-\-rcfile\fR
@@ -66,9 +68,6 @@ .SH NOTICES
 .RE
 .P
 .
-.\" Never hyphenate these:
-.hw ncurses terminfo
-.
 .SH OPTIONS
 The configuration file accepts a series of \fBset\fR and \fBunset\fR
 commands, which can be used to configure nano on startup without using
@@ -164,7 +163,7 @@ .SH OPTIONS
 .B set errorcolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the status bar when an error message is displayed.
 The default value is \fBbold,white,red\fR.
-See \fBset \%titlecolor\fR for valid color names.
+See \fBset titlecolor\fR for valid color names.
 .TP
 .B set fill \fInumber\fR
 Set the target width for justifying and automatic hard-wrapping at this
@@ -176,7 +175,7 @@ .SH OPTIONS
 .B set functioncolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the concise function descriptions
 in the two help lines at the bottom of the screen.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set guidestripe \fInumber
 Draw a vertical stripe at the given column, to help judge the width of the
@@ -197,7 +196,7 @@ .SH OPTIONS
 .B set keycolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the shortcut key combos
 in the two help lines at the bottom of the screen.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set linenumbers
 Display line numbers to the left of the text area.
@@ -238,7 +237,7 @@ .SH OPTIONS
 .B set minicolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the mini bar.
 (When this option is not specified, the colors of the title bar are used.)
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set mouse
 Enable mouse support, if available for your system.  When enabled,
@@ -266,7 +265,7 @@ .SH OPTIONS
 .TP
 .B set numbercolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for line numbers.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set operatingdir \fIdirectory\fR
 At startup, make \fBnano\fR change to the given \fIdirectory\fR, and allow
@@ -283,7 +282,7 @@ .SH OPTIONS
 .B set promptcolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the prompt bar.
 (When this option is not specified, the colors of the title bar are used.)
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .BI "set punct """ characters """"
 Set the characters treated as closing punctuation when justifying
@@ -327,11 +326,11 @@ .SH OPTIONS
 .TP
 .B set scrollercolor \fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the indicator alias "scrollbar".
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set selectedcolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for selected text.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set showcursor
 Put the cursor on the highlighted item in the file browser, and show
@@ -364,7 +363,7 @@ .SH OPTIONS
 .B set spotlightcolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for highlighting a search match.
 The default value is \fBblack,\%lightyellow\fR.
-See \fBset \%titlecolor\fR for valid color names.
+See \fBset titlecolor\fR for valid color names.
 .TP
 .B set stateflags
 Use the top-right corner of the screen for showing some state flags:
@@ -376,11 +375,11 @@ .SH OPTIONS
 .TP
 .B set statuscolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the status bar.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set stripecolor \fR[\fBbold,\fR][\fBitalic,\fR]\fIfgcolor\fB,\fIbgcolor\fR
 Use this color combination for the vertical guiding stripe.
-See \fBset \%titlecolor\fR for more details.
+See \fBset titlecolor\fR for more details.
 .TP
 .B set tabsize \fInumber\fR
 Use a tab size of \fInumber\fR columns.  The value of \fInumber\fR must be
-- 
2.30.2
signature.asc (application/pgp-signature, 833 B)