Fixed typo reported by Ralph.

[mmh] / man / mh-tailor.man

diff --git a/man/mh-tailor.man b/man/mh-tailor.man
index 98eec98..8c76e4b 100644 (file)
--- a/man/mh-tailor.man
+++ b/man/mh-tailor.man
@@ -1,9 +1,9 @@
+.TH MH-TAILOR %manext5% "July 11, 2012" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\"
 .\" %nmhwarning%
 .\"

-.TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]

 .SH NAME
 .SH NAME

-mh-tailor, mts.conf \- mail transport customization for nmh message handler
+mh-tailor, mts.conf \- mail transport configuration for nmh message handler

 .SH SYNOPSIS
 .I %etcdir%/mts.conf
 .SH DESCRIPTION
 .SH SYNOPSIS
 .I %etcdir%/mts.conf
 .SH DESCRIPTION

@@ -29,10 +29,12 @@ default values and a description of their meanings are listed below:
 .PP
 .BR mts :
 .RS 5
 .PP
 .BR mts :
 .RS 5

-The mail transport method to use.  The two acceptable options are
+The mail transport method to use.  The three acceptable options are

 .B smtp
 .B smtp

-(which is the default), and
-.BR sendmail .
+(which is the default),
+.BR sendmail/smtp ,
+and
+.BR sendmail/pipe .

 .PP
 If you use
 .BR smtp ,
 .PP
 If you use
 .BR smtp ,

@@ -48,15 +50,33 @@ to the mail port on the machine specified in the
 entry.
 .PP
 If you use
 entry.
 .PP
 If you use

-.BR sendmail ,
+.BR sendmail/smtp ,

 then
 .B post
 will send messages by forking a
 local copy of
 .BR sendmail .
 then
 .B post
 will send messages by forking a
 local copy of
 .BR sendmail .

-Currently it will still speak SMTP with this local
-copy of
+It will still speak SMTP with this local copy of
+.BR sendmail .
+For backward compatibility,
+.B sendmail/smtp
+can be abbreviated to

 .BR sendmail .
 .BR sendmail .

+.PP
+The third alternative,
+.BR sendmail/pipe ,
+also forks a local copy of
+.B sendmail
+but feeds the message directly to it, using
+.B sendmail
+.BR -t .
+This replaces the old, undocumented
+.B spost
+mechanism and retains some of its limitations, such as lack of
+support for the
+.B \-whom
+switch and
+\*(lqDcc:\*(rq header field.

 .RE
 .PP
 .BR localname :
 .RE
 .PP
 .BR localname :

@@ -171,7 +191,7 @@ The name of the system-wide default
 .I maildelivery
 file.
 See
 .I maildelivery
 file.
 See

-.BR slocal (1)
+.IR slocal (1)

 for the details.
 .RE
 .PP
 for the details.
 .RE
 .PP

@@ -199,8 +219,8 @@ to
 localhost
 .RS 5
 A lists of hosts and networks which to look for SMTP servers when
 localhost
 .RS 5
 A lists of hosts and networks which to look for SMTP servers when

-posting local mail.  It turns out this is a major win for hosts which
-don't run an message transport system.  The value of
+posting non\-local mail.  It turns out this is a major win for hosts
+which don't run an message transport system.  The value of

 .B servers
 should be one or more items.  Each item is the name of a host which
 is (hopefully) running a SMTP server.
 .B servers
 should be one or more items.  Each item is the name of a host which
 is (hopefully) running a SMTP server.

@@ -237,11 +257,9 @@ the named POP service host is consulted.
 \"  .RS 5
 \"  The local BBoards domain (a UCI hack).
 \"  .RE
 \"  .RS 5
 \"  The local BBoards domain (a UCI hack).
 \"  .RE

-

 \"  .SS "BBoards & The POP"
 \"  These options are only available if you compiled \fInmh\fP with
 \"  \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.
 \"  .SS "BBoards & The POP"
 \"  These options are only available if you compiled \fInmh\fP with
 \"  \*(lqbboards:\ pop\*(rq and \*(lqpop:\ on\*(rq.

-

 \"  .PP
 \"  .BR popbbhost :
 \"  .RS 5
 \"  .PP
 \"  .BR popbbhost :
 \"  .RS 5

@@ -265,7 +283,6 @@ the named POP service host is consulted.
 \"  present, then no check is made.  This variable should be set on the POP
 \"  BBoards service host.
 \"  .RE
 \"  present, then no check is made.  This variable should be set on the POP
 \"  BBoards service host.
 \"  .RE

-

 .SS "File Locking"
 A few words on locking:
 .B nmh
 .SS "File Locking"
 A few words on locking:
 .B nmh

@@ -306,19 +323,30 @@ Prior to installing
 .BR nmh ,
 you should see how locking is done at
 your site, and set the appropriate values.
 .BR nmh ,
 you should see how locking is done at
 your site, and set the appropriate values.

-

 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%etcdir%/mts.conf~^nmh mts configuration file
 .fi
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%etcdir%/mts.conf~^nmh mts configuration file
 .fi

-

 .SH "PROFILE COMPONENTS"
 None
 .SH "PROFILE COMPONENTS"
 None

-

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-mh\-mts(8), post(8)
-
+.IR mh\-mts (8),
+.IR post (8)

 .SH DEFAULTS
 .SH DEFAULTS

-As listed above
+As listed above.  The path of the mail transport configuration
+file can be changed with the
+.B MHMTSCONF
+environment variable and augmented with the
+.B MHMTSUSERCONF
+environment variable, see mh\-profile(5).
+.SH BUGS
+Failure to open any mail transport configuration file is silently
+ignored.  Therefore, it's best to avoid dynamic creation of such
+a file with the intent of use via the
+.B MHMTSCONF
+or
+.B MHMTSUSERCONF
+environment variables.  If such use is necessary, the ability
+to successfully open the file should first be verified.