Updated build-nmh-cygwin for release of Cygwin nmh 1.5-2. To use:
[mmh] / man / send.man
index 4a69b00..b954aa2 100644 (file)
@@ -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.
@@ -105,7 +111,7 @@ 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.  See
-.BR mhshow (1)
+.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.
@@ -145,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"
@@ -203,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
@@ -254,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
@@ -289,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
@@ -340,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
@@ -372,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
@@ -405,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
@@ -427,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"
@@ -441,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 '
@@ -448,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;