From: Ralph Corderoy <ralph@inputplus.co.uk>
Date: Tue, 5 Sep 2017 13:11:56 +0000 (+0100)
Subject: man: Fix some of the font-changing macros' parameters.
X-Git-Url: https://diplodocus.org/git/nmh/commitdiff_plain/bc0987627f1c80fddba89a32fbbd230f9a8fbe4d

man: Fix some of the font-changing macros' parameters.

Various recurring problems on two themes.  `.BR foo,' lacks the space in
`.BR foo ,'.  `.IR foo' doesn't need to alternate and can be just `.I
foo'.  Other similar changes made, e.g. `.B foo' becoming `foo'.
---

diff --git a/man/mh-mail.man b/man/mh-mail.man
index e358ce64..3fb70954 100644
--- a/man/mh-mail.man
+++ b/man/mh-mail.man
@@ -99,7 +99,7 @@ the reply address is constructed by checking the following headers (in this
 order): \*(lqMail-Reply\-To:\*(rq, \*(lqReply\-To:\*(rq, \*(lqFrom:\*(rq,
 \*(lqSender:\*(rq.  A \*(lqFrom:\*(rq header MUST exist when the message is
 sent to
-.BR post,
+.BR post ,
 otherwise the message will be rejected.
 .RE
 .PP
@@ -234,7 +234,7 @@ Used instead of the \*(lqFrom:\*(rq header when
 redistributes a message.  See \*(lqFrom:\*(rq.
 .RE
 .PP
-.BR Resent\-To:
+.BR Resent\-To :
 .RS 5
 New recipients for a message resent by
 .BR dist .
diff --git a/man/mh-profile.man b/man/mh-profile.man
index db88e92e..3b9bdcb4 100644
--- a/man/mh-profile.man
+++ b/man/mh-profile.man
@@ -28,7 +28,7 @@ This is a comment.
 .RE
 .PP
 Blank lines are not permitted in
-.IR \&.mh\-profile.
+.IR \&.mh\-profile .
 Shell quoting conventions are not available; each token is separated
 by whitespace.
 .SS "Standard Profile Entries"
@@ -363,8 +363,8 @@ superseded by the environment variable MAILDROP.
 RAND MH System (agent: Marshall Rose)
 .RS 5
 Tells front-end programs such as
-.BR comp,
-.BR forw,
+.BR comp ,
+.BR forw ,
 and
 .B repl
 your mail signature.  (This is not to be confused with a .signature
diff --git a/man/mhbuild.man b/man/mhbuild.man
index 9cd6c791..5fdf7c27 100644
--- a/man/mhbuild.man
+++ b/man/mhbuild.man
@@ -22,7 +22,7 @@ mhbuild \- translate MIME composition drafts for nmh messages
 .RB [ \-disposition " | " \-nodisposition ]
 .RB [ \-check " | " \-nocheck ]
 .RB [ \-headerencoding
-.IR encoding-algorithm
+.I encoding-algorithm
 .RB " | " \-autoheaderencoding ]
 .RB [ \-maxunencoded
 .IR line-length ]
@@ -179,7 +179,7 @@ The
 file contains default
 .B mhbuild-convert-text/html
 and
-.BR mhbuild-convert-text/plain
+.B mhbuild-convert-text/plain
 entries.  Profile entries can be used to override corresponding
 .I mhn.defaults
 entries, as usual.  Text converters should limit text line lengths
diff --git a/man/mhfixmsg.man b/man/mhfixmsg.man
index 3c110995..20c83b50 100644
--- a/man/mhfixmsg.man
+++ b/man/mhfixmsg.man
@@ -13,7 +13,7 @@ mhfixmsg \- nmh's MIME-email rewriter with various transformations
 .RI [ +folder ]
 .RI [ msgs " | "
 .IR "absolute pathname" " | "
-.RB \-file
+.B \-file
 .IR file ]
 .RB [ \-decodetext
 8bit|7bit|binary |
diff --git a/man/mhical.man b/man/mhical.man
index 5df67686..0aaf6b09 100644
--- a/man/mhical.man
+++ b/man/mhical.man
@@ -67,14 +67,14 @@ The following format components are supported:
 .fc ^ ~
 .nf
 .ta \w'description 'u
-.BR ^method~^
-.BR ^organizer~^
-.BR ^summary~^
-.BR ^description~^
-.BR ^location~^
-.BR ^dtstart~^
-.BR ^dtend~^
-.BR ^attendees~^
+.B ^method~^
+.B ^organizer~^
+.B ^summary~^
+.B ^description~^
+.B ^location~^
+.B ^dtstart~^
+.B ^dtend~^
+.B ^attendees~^
 .fi
 .RE
 .PP
diff --git a/man/mhl.man b/man/mhl.man
index 6a9a322e..9e5ea67b 100644
--- a/man/mhl.man
+++ b/man/mhl.man
@@ -317,16 +317,16 @@ addrfield or datefield, along with the appropriate formatfield variable string.
 .PP
 The \*(lqformat\*(rq flag specifies that this component will be run through
 the filter program specified by the
-.IR formatproc
+.I formatproc
 profile entry.  This filter program is expected to read data on standard
 input and output data on standard output.  Currently the \*(lqformat\*(rq
 flag is only supported for the \*(lqbody\*(rq component.  The component
 name will be prefixed to the output
-.IR after
+.I after
 the filter has been run.  The expected use of this is to filter a message
 body to create more pleasing text to use in a reply message.
 A suggested filter to use for
-.IR repl(1)
+.IR repl (1)
 is as follows:
 .PP
 .RS 5
diff --git a/man/mhmail.man b/man/mhmail.man
index 8638a0b8..43b8991b 100644
--- a/man/mhmail.man
+++ b/man/mhmail.man
@@ -11,7 +11,7 @@ mhmail \- send or read mail non-interactively with nmh
 .RB [ \-help ]
 .RB [ \-version ]
 .RB [ \-to ]
-.RI addrs
+.I addrs
 \&...
 .RB [ \-attach
 .IR file ]
@@ -30,7 +30,7 @@ mhmail \- send or read mail non-interactively with nmh
 [switches\ for
 .I post
 \&... |
-.RB \-profile
+.B \-profile
 [switches\ for
 .I send
 \&...]]
diff --git a/man/mhshow.man b/man/mhshow.man
index 48173e0c..b53b55e6 100644
--- a/man/mhshow.man
+++ b/man/mhshow.man
@@ -73,7 +73,7 @@ or
 switches will override the default settings of
 .B \-textonly
 and
-.BR \-inlineonly.
+.BR \-inlineonly .
 .PP
 The
 .B \-header
diff --git a/man/mhstore.man b/man/mhstore.man
index 2015a170..ac66b86b 100644
--- a/man/mhstore.man
+++ b/man/mhstore.man
@@ -168,7 +168,7 @@ See
 and
 .IR mhshow (1)
 for more information on
-.BR \-prefer.
+.BR \-prefer .
 .PP
 The
 .B \-noprefer
diff --git a/man/msgchk.man b/man/msgchk.man
index ca7f7d7a..39d89251 100644
--- a/man/msgchk.man
+++ b/man/msgchk.man
@@ -96,7 +96,7 @@ To specify a username for authentication with the POP server, use the
 .B \-user
 .I username
 switch.  The credentials profile entry in
-.IR mh\-profile(5)
+.IR mh\-profile (5)
 describes the ways to supply a username and password.
 .PP
 For debugging purposes, there is also a switch
diff --git a/man/next.man b/man/next.man
index 0f66d96c..15044746 100644
--- a/man/next.man
+++ b/man/next.man
@@ -11,7 +11,7 @@ next \- show the next nmh message
 .RB [ \-help ]
 .RB [ \-version ]
 .RI [ +folder ]
-.RB [\-showproc
+.RB [ \-showproc
 .IR program ]
 .RB [ \-showmimeproc
 .IR program ]
diff --git a/man/nmh.man b/man/nmh.man
index 7eeea7d3..111efeee 100644
--- a/man/nmh.man
+++ b/man/nmh.man
@@ -170,7 +170,7 @@ Commands which take a range of message numbers
 Indicates all messages in the range <num1> to <num2>, inclusive.
 The range must be nonempty.
 .TP
-.RI all
+all
 Indicates all messages, i.e.,
 .IR first - last .
 .TP
@@ -212,7 +212,7 @@ message, or with an optional +.
 Commands that take a folder name
 .RB ( inc ,
 .BR refile ,
-.BR scan,
+.BR scan ,
 \&...) accept the folder name in two formats:  \*(lq+folder\*(rq or
 \*(lq@folder\*(rq.  In both cases, \*(lqfolder\*(rq can be a
 \*(lq/\*(rq-separated path, e.g.\& \*(lqfoo/bar\*(rq.  \*(lq+folder\*(rq
diff --git a/man/pick.man b/man/pick.man
index 1cd1df2e..34fe46fa 100644
--- a/man/pick.man
+++ b/man/pick.man
@@ -171,7 +171,7 @@ will also honor a specification of the form \*(lq\-dd\*(rq, which means
 \*(lqdd days ago\*(rq.
 .PP
 Use the
-.BR \-reverse
+.B \-reverse
 switch to make
 .B pick
 find matching messages in reverse order, working from the highest message
diff --git a/man/post.man b/man/post.man
index 2e7b8af7..0e8e3093 100644
--- a/man/post.man
+++ b/man/post.man
@@ -232,7 +232,7 @@ other than the default.  The credentials profile entry in
 describes the ways to supply a username and password.
 .PP
 If SASL authentication is successful,
-.BR nmh
+nmh
 will attempt to negotiate a security layer for session encryption.
 Encrypted data is labelled with `(sasl-encrypted)' and `(sasl-decrypted)' when
 viewing the SMTP transaction with the
diff --git a/man/prev.man b/man/prev.man
index ad6b14f7..df842a79 100644
--- a/man/prev.man
+++ b/man/prev.man
@@ -11,7 +11,7 @@ prev \- show the previous nmh message
 .RB [ \-help ]
 .RB [ \-version ]
 .RI [ +folder ]
-.RB [\-showproc
+.RB [ \-showproc
 .IR program ]
 .RB [ \-showmimeproc
 .IR program ]
diff --git a/man/repl.man b/man/repl.man
index 011e358e..216238f5 100644
--- a/man/repl.man
+++ b/man/repl.man
@@ -336,7 +336,7 @@ the \*(lq>\*(rq character.
 .PP
 You can also use an external format program to format the message body.
 The format program is specified by the
-.IR formatproc
+.I formatproc
 profile entry, and is enabled by the \*(lqformat\*(rq flag.  A message
 filter using an external format program would look like this:
 .PP
diff --git a/man/send.man b/man/send.man
index 84b29887..4eb7f902 100644
--- a/man/send.man
+++ b/man/send.man
@@ -372,7 +372,7 @@ fails, or
 .B \-push
 is specified, the message will not be copied to any folder and will be
 removed by
-.BR post.
+.BR post .
 With the default
 .B refile
 switches, the message draft will be renamed according to the specification
@@ -407,7 +407,7 @@ and the
 .B \-port
 switches can be used to override the default mail server (defined by the
 .I %nmhetcdir%/mts.conf
-.RI servers
+.I servers
 entry).  The
 .B \-snoop
 switch can be used to view the SMTP transaction.  (Beware that the
@@ -441,7 +441,7 @@ describes the ways to supply a username and
 password.
 .PP
 If SASL authentication is successful,
-.BR nmh
+nmh
 will attempt to negotiate a security layer for session encryption.
 Encrypted data is labelled with `(encrypted)' and `(decrypted)' when
 viewing the SMTP transaction with the
diff --git a/man/sendfiles.man b/man/sendfiles.man
index e0b26c1a..8b98f9eb 100644
--- a/man/sendfiles.man
+++ b/man/sendfiles.man
@@ -30,7 +30,7 @@ sendfiles \- send multiple files by MIME message with nmh
 .ad
 .SH DESCRIPTION
 The shell script
-.BR sendfiles
+.B sendfiles
 is used to send a collection
 of files and directories via electronic mail.
 .PP
diff --git a/man/show.man b/man/show.man
index 226532d7..4a0f5f48 100644
--- a/man/show.man
+++ b/man/show.man
@@ -13,7 +13,7 @@ show \- display nmh messages
 .RI [ +folder ]
 .RI [ msgs ]
 .RB [ \-draft ]
-.RB [\-showproc
+.RB [ \-showproc
 .IR program ]
 .RB [ \-showmimeproc
 .IR program ]
diff --git a/man/slocal.man b/man/slocal.man
index c7bad7db..520ef531 100644
--- a/man/slocal.man
+++ b/man/slocal.man
@@ -119,9 +119,9 @@ file.
 .SS "Message Transfer Agents"
 Most modern MTAs including
 .BR sendmail ,
-.BR postfix
+.BR postfix ,
 and
-.BR exim
+.B exim
 support a \&.forward file for directing incoming mail.
 You should include the line
 .PP
diff --git a/man/whom.man b/man/whom.man
index e695b598..63ab4b63 100644
--- a/man/whom.man
+++ b/man/whom.man
@@ -70,7 +70,7 @@ and the
 .B \-port
 switches can be used to override the default mail server (defined by the
 .I %nmhetcdir%/mts.conf
-.RI servers
+.I servers
 entry).  The
 .B \-snoop
 switch can be used to view the SMTP transaction.  (Beware that the
@@ -100,7 +100,7 @@ describes the ways to supply a username and
 password.
 .PP
 If SASL authentication is successful,
-.BR nmh
+nmh
 will attempt to negotiate a security layer for session encryption.
 Encrypted data is labelled with `(encrypted)' and `(decrypted)' when
 viewing the SMTP transaction with the