X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fsend.man;h=2edb7da1a9767f16b3a28615cc56bdee243774b5;hp=0c65f5acd4975926fad5a284615215ead149c016;hb=337338b404931f06f0db2119c9e145e8ca5a9860;hpb=ac33b2e9c3632537b93fc4755a925c682d1eb82e diff --git a/man/send.man b/man/send.man index 0c65f5a..2edb7da 100644 --- a/man/send.man +++ b/man/send.man @@ -1,6 +1,5 @@ .\" .\" %nmhwarning% -.\" $Id$ .\" .TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME @@ -11,12 +10,6 @@ send \- send a message .B send .RB [ \-alias .IR aliasfile ] -.RB [ \-draft ] -.RB [ \-draftfolder -.IR +folder ] -.RB [ \-draftmessage -.IR msg ] -.RB [ \-nodraftfolder ] .RB [ \-filter .IR filterfile ] .RB [ \-nofilter ] @@ -25,19 +18,16 @@ send \- send a message .RB [ \-mime " | " \-nomime ] .RB [ \-msgid " | " \-nomsgid ] .RB [ \-push " | " \-nopush ] -.RB [ \-split -.IR seconds ] .RB [ \-verbose " | " \-noverbose ] .RB [ \-watch " | " \-nowatch ] -.RB [ \-sasl ] -.RB [ \-saslmech -.IR mechanism ] -.RB [ \-user -.IR username ] +.RB [ \-server +.IR servername ] +.RB [ \-port +.IR port-name/number ] .RB [ \-width .IR columns ] -.RB [ file -\&...] +.RB [ msg +\&...] .RB [ \-version ] .RB [ \-help ] .RB [ \-attach @@ -47,7 +37,7 @@ send \- send a message .ad .SH DESCRIPTION .B Send -will cause each of the specified files to be delivered +will cause each of the specified messages to be delivered to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message. If .B send @@ -123,7 +113,7 @@ messages at the .I whatnow prompt. .PP -Here are example message part headers for each of the +Here are example message part headers, for an attachment, for each of the .B -attachformat values: .PP @@ -131,14 +121,14 @@ 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; charset="us-ascii" +Content-Type: text/plain; name="VERSION"; charset="us-ascii" Content-Disposition: attachment; filename="VERSION" -attachformat 2: -Content-Type: text/plain; charset="us-ascii" +Content-Type: text/plain; name="VERSION"; charset="us-ascii" Content-Disposition: attachment; filename="VERSION"; modification-date="Mon, 19 Dec 2005 22:39:51 -0600" .fi .PP @@ -176,55 +166,21 @@ and network mail. Hence, by specifying both switches, a large detail of information can be gathered about each step of the message's entry into the transport system. .PP -The -.B \-draftfolder -.I +folder -and -.B \-draftmessage +.B Send +with no .I msg -switches invoke -the -.B nmh -draft folder facility. This is an advanced (and highly -useful) feature. Consult the +argument will send the current message in the draft folder. +.B Send +always takes messages from the draft folder. +(But, a +.I +folder +argument might be added in the future.) +Consult the .BR mh-draft (5) -man page for more -information. -.PP -If -.B \-split -is specified, -.B send -will split the draft into one -or more partial messages prior to sending. This makes use of the -MIME features in -.BR nmh . -Note however that if -.B send -is -invoked under -.BR dist , -then this switch is ignored\0--\0it makes -no sense to redistribute a message in this fashion. Sometimes you want -.B send -to pause after posting a partial message. This is usually -the case when you are running -.B sendmail -and expect to generate a -lot of partial messages. The argument to -.B \-split -tells it how long -to pause between postings. +man page for more information. .PP -.B Send -with no -.I file -argument will query whether the draft -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 message will be renamed with a leading 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 @@ -315,32 +271,15 @@ switch, the user can direct .B send as to how long it should make header lines containing addresses. .PP -If -.B nmh -has been compiled with SASL support, the -.B \-sasl -switch will enable -the use of SASL authentication with the SMTP MTA. Depending on the -SASL mechanism used, this may require an additional password prompt from the -user (but the -.RI \*(lq \&.netrc \*(rq -file can be used to store this password). -.B \-saslmech -switch can be used to select a particular SASL mechanism, -and the the -.B \-user -switch can be used to select a authorization userid -to provide to SASL other than the default. -.PP -Currently SASL security layers are not supported for SMTP. -.BR nmh 's -SMTP SASL code -will always negotiate an unencrypted connection. This means that while the SMTP -authentication can be encrypted, the subsequent data stream can not. This is in -contrast to -.BR nmh 's -POP3 SASL support, where encryption is supported for both the -authentication and the data stream. +If nmh is using the SMTP MTA, the +.B \-server +and the +.B \-port +switches can be used to override the default mail server (defined by the +.RI servers +entry in +.I %etcdir%/mts.conf +). .PP The files specified by the profile entry \*(lqAliasfile:\*(rq and any additional alias files given by the @@ -359,6 +298,7 @@ for more information. .nf .ta \w'%etcdir%/ExtraBigFileName 'u ^$HOME/\&.mh\(ruprofile~^The user profile +^/drafts~^The draft folder .fi .SH "PROFILE COMPONENTS" @@ -367,7 +307,7 @@ for more information. .ta 2.4i .ta \w'ExtraBigProfileName 'u ^Path:~^To determine the user's nmh directory -^Draft\-Folder:~^To find the default draft\-folder +^Draft\-Folder:~^To set the default draft\-folder ^Aliasfile:~^For a default alias file ^Signature:~^To determine the user's mail signature ^mailproc:~^Program to post failure notices @@ -379,9 +319,8 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8) .SH DEFAULTS .nf -.RB ` file "' defaults to /draft" +.RB ` msg "' defaults to the current message in the draft folder" .RB ` \-alias "' defaults to %etcdir%/MailAliases" -.RB ` \-nodraftfolder ' .RB ` \-nofilter ' .RB ` \-format ' .RB ` \-forward ' @@ -402,8 +341,3 @@ Under some configurations, it is not possible to monitor the mail delivery transaction; .B \-watch is a no-op on those systems. -.PP -Using -.B \-split -.I 0 -doesn't work correctly.