Added -noall/-all switches to sortm(1).

[mmh] / man / mh-tailor.man

diff --git a/man/mh-tailor.man b/man/mh-tailor.man
index 3963e4b..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
 .\"
 .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
 .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 .
 .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 :
 .RE
 .PP
 .BR localname :

@@ -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"
 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
 .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
 .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.
 .B servers
 should be one or more items.  Each item is the name of a host which
 is (hopefully) running a SMTP server.

@@ -339,4 +341,19 @@ None
 mh\-mts(8), post(8)
 
 .SH DEFAULTS
 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.