X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fmh-tailor.man;h=8c76e4b53398e8aa9378620ee42e2ddf6fc07497;hb=fa194d6d12bd0d4d2196508cbb0e5bfddb6efe37;hp=3963e4b94af58599e573405ce3e7b518c0618111;hpb=ccd3685b42cb198b11d2d4daabb58849d239df40;p=mmh

diff --git a/man/mh-tailor.man b/man/mh-tailor.man
index 3963e4b..8c76e4b 100644
--- 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
@@ -190,35 +210,17 @@ indicates that mail for \*(lqeveryone\*(rq should not be sent to them.
 This is useful for handling admin, dummy, and guest logins.
 .RE
 .SS "SMTP support"
-These options are only available if you set
+This option is only available if you set
 .B mts
 to
 .BR smtp .
 .PP
-.BR hostable :
-%etcdir%/hosts
-.RS 5
-The exceptions file for /etc/hosts used by
-.B post
-to try to find
-official names.  The format of this file is quite simple:
-.PP
-.IP 1. 4
-Comments are surrounded by sharp (`#') and newline.
-.IP 2. 4
-Words are surrounded by white space.
-.IP 3. 4
-The first word on the line is the official name of a host.
-.IP 4. 4
-All words following the official names are aliases for that host.
-.RE
-.PP
 .BR servers :
 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.
@@ -255,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
@@ -283,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
@@ -324,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.