From: Ralph Corderoy Date: Sun, 16 Oct 2016 07:52:10 +0000 (+0100) Subject: Fix end of sentence spacing in man pages, and related problems. X-Git-Url: https://diplodocus.org/git/nmh/commitdiff_plain/36e3d7dc4bc9905a9b9074defd26ee6c32e1a6b9?ds=inline Fix end of sentence spacing in man pages, and related problems. 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'. --- diff --git a/man/burst.man b/man/burst.man index e38a4aee..3df6c2a3 100644 --- a/man/burst.man +++ b/man/burst.man @@ -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 diff --git a/man/flist.man b/man/flist.man index 15349b3c..3de995d9 100644 --- a/man/flist.man +++ b/man/flist.man @@ -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 diff --git a/man/forw.man b/man/forw.man index fa4a465e..c01b62a8 100644 --- a/man/forw.man +++ b/man/forw.man @@ -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. diff --git a/man/inc.man b/man/inc.man index f40f667d..9020ff1b 100644 --- a/man/inc.man +++ b/man/inc.man @@ -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 diff --git a/man/mh-draft.man b/man/mh-draft.man index ec06210a..2c82a70d 100644 --- a/man/mh-draft.man +++ b/man/mh-draft.man @@ -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 diff --git a/man/mh-format.man b/man/mh-format.man index 29c6b60a..28ebdadd 100644 --- a/man/mh-format.man +++ b/man/mh-format.man @@ -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 diff --git a/man/mh-mail.man b/man/mh-mail.man index 6f481ca8..d36fe8d5 100644 --- a/man/mh-mail.man +++ b/man/mh-mail.man @@ -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 : diff --git a/man/mh-mime.man b/man/mh-mime.man index 6a3c06be..ad75c8d8 100644 --- a/man/mh-mime.man +++ b/man/mh-mime.man @@ -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 diff --git a/man/mh-profile.man b/man/mh-profile.man index d3a8bf16..ae085cc4 100644 --- a/man/mh-profile.man +++ b/man/mh-profile.man @@ -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 diff --git a/man/mh-tailor.man b/man/mh-tailor.man index 5e655549..226109fd 100644 --- a/man/mh-tailor.man +++ b/man/mh-tailor.man @@ -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 diff --git a/man/mhbuild.man b/man/mhbuild.man index a6193fd1..b9812e20 100644 --- a/man/mhbuild.man +++ b/man/mhbuild.man @@ -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 diff --git a/man/mhmail.man b/man/mhmail.man index e39f7ecc..cc36ce28 100644 --- a/man/mhmail.man +++ b/man/mhmail.man @@ -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 diff --git a/man/mhn.man b/man/mhn.man index 5864aa43..e2e5ffa6 100644 --- a/man/mhn.man +++ b/man/mhn.man @@ -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 diff --git a/man/mhshow.man b/man/mhshow.man index 6e1a49c2..6451f7ad 100644 --- a/man/mhshow.man +++ b/man/mhshow.man @@ -675,7 +675,7 @@ mhshow-show- .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 diff --git a/man/nmh.man b/man/nmh.man index fd187089..0c32cde5 100644 --- a/man/nmh.man +++ b/man/nmh.man @@ -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 diff --git a/man/send.man b/man/send.man index 2bce76a2..b8cfb8e8 100644 --- a/man/send.man +++ b/man/send.man @@ -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 diff --git a/man/slocal.man b/man/slocal.man index 6c8e4909..bd810d29 100644 --- a/man/slocal.man +++ b/man/slocal.man @@ -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 ? diff --git a/man/whom.man b/man/whom.man index 2e992e77..32d184f2 100644 --- a/man/whom.man +++ b/man/whom.man @@ -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