Updated build-nmh-cygwin for release of Cygwin nmh 1.5-2. To use:

[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%
 .\"
-.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 :
@@ -171,7 +191,7 @@ The name of the system-wide default
 .I maildelivery
 file.
 See
-.BR slocal (1)
+.IR slocal (1)
 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
-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.
@@ -237,11 +257,9 @@ the named POP service host is consulted.
 \"  .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.
-
 \"  .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
-
 .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.
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%etcdir%/mts.conf~^nmh mts configuration file
 .fi
-
 .SH "PROFILE COMPONENTS"
 None
-
 .SH "SEE ALSO"
-mh\-mts(8), post(8)
-
+.IR mh\-mts (8),
+.IR 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.