]> diplodocus.org Git - nmh/commitdiff
Fix end of sentence spacing in man pages, and related problems.
authorRalph Corderoy <ralph@inputplus.co.uk>
Sun, 16 Oct 2016 07:52:10 +0000 (08:52 +0100)
committerRalph Corderoy <ralph@inputplus.co.uk>
Sun, 16 Oct 2016 07:52:10 +0000 (08:52 +0100)
troff(1) input that ends a sentence at the end of the line gets the
proper inter-sentence spacing when formatted.  If the sentence ends
midline then two spaces must follow to get the same result, otherwise
the spacing looks odd.  Similarly, if a full stop is not the end of a
sentence then it should have the zero-width escape appended so if
re-formatting the source happens to place it at the end of the line then
no large gap follows it: e.g. `e.g.\&'.
Replace `et. al.' with `et al'.

18 files changed:
man/burst.man
man/flist.man
man/forw.man
man/inc.man
man/mh-draft.man
man/mh-format.man
man/mh-mail.man
man/mh-mime.man
man/mh-profile.man
man/mh-tailor.man
man/mhbuild.man
man/mhmail.man
man/mhn.man
man/mhshow.man
man/nmh.man
man/send.man
man/slocal.man
man/whom.man

index e38a4ae..3df6c2a 100644 (file)
@@ -43,10 +43,10 @@ If
 is given,
 .B burst
 will try to determine if the message is formatted with MIME and contains MIME parts of
-type \*(lqmessage/rfc822\*(rq. If it does, it will burst the message using MIME
+type \*(lqmessage/rfc822\*(rq.  If it does, it will burst the message using MIME
 formatting rules.  The
 .B \-mime
-switch can be used to enforce the use of MIME formatting. The
+switch can be used to enforce the use of MIME formatting.  The
 .B \-nomime
 switch will force
 .B burst
@@ -123,7 +123,7 @@ This leaves the context ready for a
 of the table of contents
 of the digest, and a
 .B next
-to see the first message of the digest. If
+to see the first message of the digest.  If
 .B \-noinplace
 is given, then the first message extracted from the
 first digest burst becomes the current message.  This leaves the context
index 15349b3..3de995d 100644 (file)
@@ -36,7 +36,7 @@ is used to search a list of folders and display the number
 of messages in these folders that are in a given sequence or set of
 sequences (for example the
 .RI \*(lq unseen \*(rq
-sequence). This is especially
+sequence).  This is especially
 useful if you use some mechanism such as
 .B slocal
 or
@@ -63,7 +63,7 @@ which to search for.  This option may be used multiple times to specify
 multiple sequences.  If this is not given, then the default is to search
 for all the sequences specified by the
 .RI \*(lq Unseen-Sequence \*(rq
-profile component. For more details about sequences, read the
+profile component.  For more details about sequences, read the
 .IR mh\-sequence (5)
 man page.
 .PP
index fa4a465..c01b62a 100644 (file)
@@ -267,11 +267,11 @@ before the forwarded messages.  (A major win!)
 .PP
 To use the MIME rules for encapsulation, specify the
 .B \-mime
-switch. This directs
+switch.  This directs
 .B forw
 to generate an
 .B mhbuild
-composition file. Note that
+composition file.  Note that
 .B nmh
 will not invoke
 .B mhbuild
@@ -503,7 +503,7 @@ instead of
 .BR send ,
 it's possible to confuse
 .B forw
-by re\-ordering the file (e.g. by using
+by re\-ordering the file (e.g.\& by using
 .RB \*(lq folder
 .BR \-pack \*(rq)
 before the message is successfully sent.
index f40f667..9020ff1 100644 (file)
@@ -228,7 +228,7 @@ If passed the
 switch,
 .B inc
 will use the specified command to establish the connection to the POP
-server. The string
+server.  The string
 .IR %h
 in the command will be substituted by the hostname to connect to.
 .PP
@@ -237,7 +237,7 @@ If
 uses POP, then the
 .B \-pack
 .I file
-switch is considered. If given, then
+switch is considered.  If given, then
 .B inc
 simply uses the POP to
 .B packf
index ec06210..2c82a70 100644 (file)
@@ -106,8 +106,8 @@ Both of these
 commands accept a `file' or `files' argument, and they will, if given
 .B \-draftfolder
 .I +folder
-treat these arguments as `msg' or `msgs'. (This may appear to be
-inconsistent, at first, but it saves a lot of typing) Hence,
+treat these arguments as `msg' or `msgs'.  (This may appear to be
+inconsistent, at first, but it saves a lot of typing.)  Hence,
 .PP
 .RS
 .nf
@@ -217,7 +217,7 @@ is not included in the profile entry for
 .BR send ,
 since when
 .BR comp ,
-et. al., invoke
+et al, invoke
 .B send
 directly, they supply
 .B send
@@ -226,7 +226,7 @@ with the UNIX pathname of the message draft, and
 a
 .B \-draftmessage
 .I msg
-argument. As far as
+argument.  As far as
 .B send
 is concerned, a draft folder is not being used.
 .PP
index 29c6b60..28ebdad 100644 (file)
@@ -45,7 +45,7 @@ A format string consists of ordinary text, and special multi-character
 escape sequences which begin with `%'.  When specifying a format
 string, the usual C backslash characters are honored: `\\b', `\\f',
 `\\n', `\\r', and `\\t'.  Continuation lines in format files end with
-`\\' followed by the newline character. A literal `%' can be inserted into
+`\\' followed by the newline character.  A literal `%' can be inserted into
 a format file by using the sequence `%%'.
 .\" TALK ABOUT SYNTAX FIRST, THEN SEMANTICS
 .SS SYNTAX
@@ -451,7 +451,7 @@ output width.  It can therefore be used for outputting terminal escape
 sequences.
 .PP
 There are a limited number of function escapes to output terminal escape
-sequences. These sequences are retrieved from the
+sequences.  These sequences are retrieved from the
 .IR terminfo (5)
 database according to the current terminal setting.  The (\fIbold\fR\^),
 (\fIunderline\fR\^), and (\fIstandout\fR\^) escapes set bold mode,
@@ -583,7 +583,7 @@ a space should be printed.  Next:
 .RE
 .PP
 the month and date are printed in two digits (zero filled) separated by
-a slash. Next,
+a slash.  Next,
 .PP
 .RS 5
 .nf
index 6f481ca..d36fe8d 100644 (file)
@@ -247,12 +247,12 @@ New recipients for a message resent by
 .PP
 .BR Resent\-cc :
 .RS 5
-Still more recipients. See \*(lqcc:\*(rq and \*(lqResent\-To:\*(rq.
+Still more recipients.  See \*(lqcc:\*(rq and \*(lqResent\-To:\*(rq.
 .RE
 .PP
 .BR Resent\-Bcc :
 .RS 5
-Even more recipients. See \*(lqBcc:\*(rq and \*(lqResent\-To:\*(rq.
+Even more recipients.  See \*(lqBcc:\*(rq and \*(lqResent\-To:\*(rq.
 .RE
 .PP
 .BR Resent\-Fcc :
index 6a3c06b..ad75c8d 100644 (file)
@@ -37,7 +37,7 @@ installation includes
 support.
 .PP
 Depending on the source and target character set, it may not be possible
-to convert all characters to the local character set. In this case a
+to convert all characters to the local character set.  In this case a
 substitution character will be used for the characters that cannot be
 converted.
 .SS
index d3a8bf1..ae085cc 100644 (file)
@@ -100,7 +100,7 @@ no such sequences are defined.  Otherwise, for each name given, the
 sequence is first zero'd and then each message is added to the sequence.
 Read the
 .IR mh\-sequence (5)
-man page for the details about this sequence. (profile, no default)
+man page for the details about this sequence.  (profile, no default)
 .RE
 .PP
 .BR Sequence\-Negation :
@@ -316,7 +316,7 @@ and
 .BR repl .
 Read the
 .IR mh\-draft (5)
-man page for details. (profile, no default)
+man page for details.  (profile, no default)
 .RE
 .PP
 .BI digest\-issue\- list :
@@ -795,7 +795,7 @@ program as the
 .IR whatnowproc ,
 including
 one of the standard shells.  As a result, it's not possible to pass
-information via an argument list. The convention is that environment
+information via an argument list.  The convention is that environment
 variables whose names are all upper-case are user-settable; those
 whose names are lower-case only are used internally by nmh and should
 not generally be set by the user.
@@ -803,7 +803,7 @@ not generally be set by the user.
 MAILDROP
 This variable tells
 .B inc
-the default maildrop. This supersedes the \*(lqMailDrop\*(rq profile entry.
+the default maildrop.  This supersedes the \*(lqMailDrop\*(rq profile entry.
 .TP
 MAILHOST
 This variable tells
@@ -920,7 +920,7 @@ This variable tells
 .B send
 and
 .B post
-your mail signature. This supersedes the \*(lqSignature\*(rq profile entry,
+your mail signature.  This supersedes the \*(lqSignature\*(rq profile entry,
 and is not used when the \*(lqLocal\-Mailbox\*(rq profile component is set.
 .TP
 USER
index 5e65554..226109f 100644 (file)
@@ -84,7 +84,7 @@ qualified hostname.  If this is not set, depending on the version of
 UNIX you're running,
 .B nmh
 will query the system for this value
-(e.g. uname, gethostname, etc.), and attempt to fully qualify this
+(e.g.\& uname, gethostname, etc.), and attempt to fully qualify this
 value.
 .PP
 If you are using POP to retrieve new messages, you may want to set this
@@ -100,7 +100,7 @@ hostname.
 This should only be needed, if for some reason
 .B nmh
 is not able to
-fully qualify the hostname returned by the system (e.g. uname,
+fully qualify the hostname returned by the system (e.g.\& uname,
 gethostname, etc.).
 .RE
 .PP
index a6193fd..b9812e2 100644 (file)
@@ -207,7 +207,7 @@ Profile entries can be used to override corresponding
 .I mhn.defaults
 entries, as usual.  Text converters should limit text line lengths
 to a maximum of 78 characters, and must limit them to a maximum of 998
-characters, per RFC 5322 Sec. 2.1.1.
+characters, per RFC 5322 Sec.\& 2.1.1.
 .PP
 For each
 .I TYPE
index e39f7ec..cc36ce2 100644 (file)
@@ -112,7 +112,7 @@ will not send the message and return with status 1.  You can use the switch
 .PP
 Normally, addresses appearing as arguments are put in the \*(lqTo:\*(rq
 field.  At least one such address is required when sending a message,
-i.e., if any other switches are supplied. If the
+i.e., if any other switches are supplied.  If the
 .B \-cc
 switch is used, all addresses following it, even if there are
 intervening switches other than
index 5864aa4..e2e5ffa 100644 (file)
@@ -46,7 +46,7 @@ mhn \- display/list/store/cache MIME messages
 .SH DESCRIPTION
 .B
 Mhn
-is deprecated. It is retained only
+is deprecated.  It is retained only
 for backwards compatibility.
 .PP
 You should migrate to using the
index 6e1a49c..6451f7a 100644 (file)
@@ -675,7 +675,7 @@ mhshow-show-<type>
 .fi
 .RE
 .PP
-need be present in this additional profile. Finally,
+need be present in this additional profile.  Finally,
 .B mhshow
 will attempt to consult
 .PP
index fd18708..0c32cde 100644 (file)
@@ -209,14 +209,14 @@ Commands that take a folder name
 .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
+\*(lq/\*(rq-separated path, e.g.\& \*(lqfoo/bar\*(rq.  \*(lq+folder\*(rq
 specifies a directory path to a folder.  If \*(lqfolder\*(rq starts
 with \*(lq/\*(rq then it's an absolute path from the root directory.
 If it is \*(lq.\*(rq or \*(lq..\*(rq, or starts with \*(lq./\*(rq or
 \*(lq../\*(rq, then it's relative to the current working directory.
 Otherwise it's relative to mh-profile(5)'s
 .RI \*(lq Path \*(rq,
-i.e. as given by
+i.e.\& as given by
 .RB ` "mhpath +" `.
 \*(lq@folder\*(rq is a shorthand for \*(lq+curfolder/folder\*(rq; it's
 a relative path from the current folder.  \*(lqcurfolder\*(rq is given
index 2bce76a..b8cfb8e 100644 (file)
@@ -263,7 +263,7 @@ If a \*(lqDcc:\*(rq field is encountered and the
 mail transport method is not in use, its addresses will be used for
 delivery, and the \*(lqDcc:\*(rq field will be removed from the message.  The
 blind recipients will receive the same message sent to the sighted
-recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no
+recipients.  *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no
 explicit indication that they have received a \*(lqblind copy\*(rq.
 This can cause blind recipients to
 inadvertently reply to all of the sighted recipients of the
index 6c8e490..bd810d2 100644 (file)
@@ -258,7 +258,7 @@ Perform the action.  If the action succeeds, then the message
 is considered delivered.
 .TP \w'Azzz'u
 .I R
-Perform the action. Regardless of the outcome of the action,
+Perform the action.  Regardless of the outcome of the action,
 the message is not considered delivered.
 .TP \w'Azzz'u
 .I ?
index 2e992e7..32d184f 100644 (file)
@@ -133,7 +133,7 @@ additional alias files given by the
 switch will be
 read (more than one file, each preceded by
 .BR \-alias ,
-can be named). See
+can be named).  See
 .IR mh\-alias (5)
 for more information.
 .SH FILES