X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fsend.man;h=b954aa207643fb2ba01d0471ab258f8d54e53bbf;hb=e69044f7624abe5cb2cb796d528c0cc5f29515f7;hp=0f08c5dae87f15d67df39a3320e0dbd35547ecc0;hpb=a66c30d557c09799db7cd166ba5fa2a97dbafbb3;p=mmh

diff --git a/man/send.man b/man/send.man
index 0f08c5d..b954aa2 100644
--- a/man/send.man
+++ b/man/send.man
@@ -1,7 +1,7 @@
 .\"
 .\" %nmhwarning%
 .\"
-.TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.TH SEND %manext1% "September 11, 2012" "%nmhversion%"
 .SH NAME
 send \- send a message
 .SH SYNOPSIS
@@ -23,11 +23,15 @@ send \- send a message
 .RB [ \-forward " | " \-noforward ]
 .RB [ \-mime " | " \-nomime ]
 .RB [ \-msgid " | " \-nomsgid ]
+.RB [ \-messageid
+.IR localname " | " random ]
 .RB [ \-push " | " \-nopush ]
 .RB [ \-split
 .IR seconds ]
 .RB [ \-verbose " | " \-noverbose ]
 .RB [ \-watch " | " \-nowatch ]
+.RB [ \-mts
+.IR smtp " | " sendmail/smtp " | " sendmail/pipe ]
 .RB [ \-server
 .IR servername ]
 .RB [ \-port
@@ -46,7 +50,7 @@ send \- send a message
 .RB [ \-width
 .IR columns ]
 .RB [ file
-\&...] 
+\&...]
 .RB [ \-version ]
 .RB [ \-help ]
 .RB [ \-attach
@@ -77,7 +81,6 @@ profile component.  Most of the features attributed to
 .B send
 are actually performed by
 .BR post .
-
 .PP
 By default the draft is scanned for a header named
 .IR Nmh-Attachment .
@@ -87,7 +90,10 @@ can be changed with the
 .B \-attach
 option.  This behavior can be disabled completely with the
 .B \-noattach
-option.
+option.  The
+.B whatnow
+man page describes the user interface for managing MIME attachments via
+this mechanism.
 .PP
 The first part of the MIME message is the draft body if that body contains
 any non-blank characters.
@@ -96,14 +102,17 @@ The body of each header field whose name matches the
 is interpreted as a file name, and each file named is included as a separate
 part in the MIME message.
 .PP
-For file names with dot suffixes, the context is scanned for a
+For file names with dot suffixes, the profile is scanned for a
 .I mhshow-suffix-
 entry for that suffix.
-The content-type for the part is taken from that context entry if a match is
-found.
+The content-type for the part is taken from that profile entry if a match is
+found.  If a match is not found in the user profile, the mhn.defaults
+profile is scanned next.
 If no match is found or the file does not have a dot suffix, the content-type
 is text/plain if the file contains only ASCII characters or application/octet-stream
-if it contains characters outside of the ASCII range.
+if it contains characters outside of the ASCII range.  See
+.IR mhshow (1)
+for more details and example syntax.
 .PP
 Each part contains a name attribute that is the last component of the path name.
 A
@@ -142,7 +151,7 @@ values:
 -attachformat 0:
 Content-Type: text/plain; name="VERSION"; x-unix-mode="0644";
 	charset="us-ascii"
-Content-Description: ASCII text 
+Content-Description: ASCII text
 
 -attachformat 1:
 Content-Type: text/plain; name="VERSION"; charset="us-ascii"
@@ -200,7 +209,7 @@ the
 .B nmh
 draft folder facility.  This is an advanced (and highly
 useful) feature.  Consult the
-.BR mh-draft (5)
+.IR mh-draft (5)
 man page for more
 information.
 .PP
@@ -237,7 +246,8 @@ is the intended file, whereas
 .B \-draft
 will suppress this question.
 Once the transport system has successfully accepted custody of the
-message, the file will be renamed with a leading comma, which allows
+message, the file will be renamed with a site-dependent prefix
+(usually a comma), which allows
 it to be retrieved until the next draft message is sent.  If there are
 errors in the formatting of the message,
 .B send
@@ -250,7 +260,9 @@ sent to sighted recipients.  The blind recipients will receive an entirely
 new message with a minimal set of headers.  Included in the body of the
 message will be a copy of the message sent to the sighted recipients.
 .PP
-If a \*(lqDcc:\*(rq field is encountered, its addresses will be used for
+If a \*(lqDcc:\*(rq field is encountered and the
+.B sendmail/pipe
+mail transport method is not in use, its addresses will be used for
 delivery, and the \*(lqDcc:\*(rq field will be removed from the message.  The
 blind recipients will receive the same message sent to the sighted
 recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no
@@ -285,6 +297,23 @@ If
 is specified, then a \*(lqMessage\-ID:\*(rq field will also
 be added to the message.
 .PP
+The
+.B \-messageid
+switch selects the style used for the part appearing after the @
+in \*(lqMessage\-ID:\*(rq, \*(lqResent\-Message\-ID:\*(rq, and
+\*(lqContent\-ID:\*(rq header fields.  The two acceptable options are
+.B localname
+(which is the default),
+and
+.BR random .
+With
+.BR localname ,
+the local hostname is used.  With
+.BR random ,
+a random sequence of characters is used instead.  Note that the
+.B \-msgid
+switch must be enabled for this switch to have any effect.
+.PP
 If
 .B send
 is re\-distributing a message (when invoked by
@@ -336,6 +365,12 @@ switch, the user can direct
 .B send
 as to how long it should make header lines containing addresses.
 .PP
+The mail transport system default is provided in
+.I %etcdir%/mts.conf
+but can be overriiden here with the
+.B \-mts
+switch.
+.PP
 If nmh is using the SMTP MTA, the
 .B \-server
 and the
@@ -368,7 +403,7 @@ and the the
 switch can be used to select a authorization userid
 to provide to SASL other than the default.
 .PP
-If SASL authentication is successful, 
+If SASL authentication is successful,
 .BR nmh
 will attempt to negotiate a security layer for session encryption.
 Encrypted data is labelled with `(encrypted)' and `(decrypted)' when
@@ -401,16 +436,14 @@ read (more than one file, each preceded by
 .BR \-alias ,
 can be named).
 See
-.BR mh\-alias (5)
+.IR mh\-alias (5)
 for more information.
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -423,10 +456,15 @@ for more information.
 ^mailproc:~^Program to post failure notices
 ^postproc:~^Program to post the message
 .fi
-
 .SH "SEE ALSO"
-comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
-
+.IR comp (1),
+.IR dist (1),
+.IR forw (1),
+.IR repl (1),
+.IR whatnow (1),
+.IR mh\-alias (5),
+.IR mh\-tailor (5),
+.IR post (8)
 .SH DEFAULTS
 .nf
 .RB ` file "' defaults to <mh\-dir>/draft"
@@ -437,6 +475,7 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 .RB ` \-forward '
 .RB ` \-nomime '
 .RB ` \-nomsgid '
+.RB ` "\-messageid\ localname" '
 .RB ` \-nopush '
 .RB ` \-noverbose '
 .RB ` \-nowatch '
@@ -444,10 +483,8 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 .RB ` "\-attach\ Nmh-Attachment" '
 .RB ` "\-attachformat\ 1" '
 .fi
-
 .SH CONTEXT
 None
-
 .SH BUGS
 Under some configurations, it is not possible to monitor the mail delivery
 transaction;