[PATCH 18/31] docs: set "foreign" software in italics, not bold

"G. Branden Robinson" <[email protected]> Thu, 23 Apr 2026 17:59:56 -0500
Newsgroups	gmane.editors.nano.devel
Message-ID	<20260423225956.rek7qndw6dhpnhxq@illithid>
libmagic, ncurses, and terminfo are software components that aren't
topics of nano's own man pages.

groff_man_style(7):
     .B [text]
...
            Use bold for literal portions of syntax synopses, for
            command‐line options in running text, and for literals that
            are major topics of the subject under discussion; for
            example, this page uses bold for macro, string, and register
            names.  In an EX/EE example of interactive I/O (such as a
            shell session), set only user input in bold.
...
     .I [text]
...
            Use italics for file and path names, for environment
            variables, for C data types, for enumeration or preprocessor
            constants in C, for variant (user‐replaceable) portions of
            syntax synopses, for the first occurrence (only) of a
            technical concept being introduced, for names of journals
            and of literary works longer than an article, and anywhere a
            parameter requiring replacement by the user is encountered.
            An exception involves variant text in a context already
            typeset in italics, such as file or path names with
            replaceable components; in such cases, follow the convention
            of mathematical typography: set the file or path name in
            italics as usual but use roman for the variant part (see IR
            and RI below), and italics again in running roman text when
            referring to the variant material.
---
 doc/nano.1   |  6 +++---
 doc/nanorc.5 | 10 +++++-----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/doc/nano.1 b/doc/nano.1
index c8ec7f9a..482c74c4 100644
--- a/doc/nano.1
+++ b/doc/nano.1
@@ -174,9 +174,9 @@ .SH OPTIONS
 in your \fInanorc\fR file.)
 .TP
 .BR \-K ", " \-\-rawsequences
-Interpret escape sequences directly, instead of asking \fBncurses\fR
+Interpret escape sequences directly, instead of asking \fIncurses\fR
 to translate them.  (If you need this option to get some keys to work
-properly, it means that the \fBterminfo\fR terminal description that
+properly, it means that the \fIterminfo\fR 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.
@@ -375,7 +375,7 @@ .SH OPTIONS
 .TP
 .BR \-! ", " \-\-magic
 When neither the file's name nor its first line give a clue,
-try using libmagic to determine the applicable syntax.
+try using \fIlibmagic\fR to determine the applicable syntax.
 .TP
 .BR \-@ ", " \-\-colonparsing
 When a filename given on the command line ends in a colon plus digits
diff --git a/doc/nanorc.5 b/doc/nanorc.5
index dd869a02..53302e6d 100644
--- a/doc/nanorc.5
+++ b/doc/nanorc.5
@@ -206,8 +206,8 @@ .SH OPTIONS
 .TP
 .B set magic
 When neither the file's name nor its first line give a clue,
-try using libmagic to determine the applicable syntax.
-(Calling libmagic can be relatively time consuming.
+try using \fIlibmagic\fR to determine the applicable syntax.
+(Calling \fIlibmagic\fR can be relatively time consuming.
 It is therefore not done by default.)
 .TP
 .BI "set matchbrackets \[dq]" characters \[dq]
@@ -304,9 +304,9 @@ .SH OPTIONS
 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
+Interpret escape sequences directly, instead of asking \fIncurses\fR
 to translate them.  (If you need this option to get some keys to work
-properly, it means that the \fBterminfo\fR terminal description that is used
+properly, it means that the \fIterminfo\fR 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.
@@ -514,7 +514,7 @@ .SH SYNTAX HIGHLIGHTING
 either, then compare this \fIregex\fR (or regexes) against the
 result of querying the \fBmagic\fR database about the current
 file, to determine whether this syntax should be used for it.
-(This querying is done only when \fBlibmagic\fR is actually installed
+(This querying is done only when \fIlibmagic\fR is actually installed
 on the system and \fB\-\-magic\fR or \fBset magic\fR was given.)
 .TP
 .BI formatter " program " \fR[ "argument " \fR.\|.\|.]
-- 
2.30.2
signature.asc (application/pgp-signature, 833 B)