Added -mts switch to post, send, and whom. Replaced test-sendmail-pipe

[mmh] / man / mh-tailor.man

diff --git a/man/mh-tailor.man b/man/mh-tailor.man
index 98eec98..5709271 100644 (file)
--- a/man/mh-tailor.man
+++ b/man/mh-tailor.man
@@ -3,7 +3,7 @@
 .\"
 .TH MH-TAILOR %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .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
@@ -29,10 +29,12 @@ default values and a description of their meanings are listed below:
 .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
-(which is the default), and
-.BR sendmail .
+(which is the default),
+.BR sendmail/smtp ,
+and
+.BR sendmail/pipe .
 .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
-.BR sendmail ,
+.BR sendmail/smtp ,
 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 .
+.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 :
@@ -199,8 +219,8 @@ to
 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.
@@ -321,4 +341,19 @@ None
 mh\-mts(8), post(8)
 
 .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.