X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fsend.man1;h=66f37ceaa0f42aa79de3a56d6de7d735f6224cbc;hp=c5bec46aed605bfe38210fea7f9018b0f4882527;hb=5b92ee6942b9b466914f5faa5fa4c00a2ebc6d35;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/send.man1 b/man/send.man1 index c5bec46..66f37ce 100644 --- a/man/send.man1 +++ b/man/send.man1 @@ -10,35 +10,19 @@ send \- send a message .B send .RB [ \-alias .IR aliasfile ] -.RB [ \-filter -.IR filterfile ] -.RB [ \-nofilter ] -.RB [ \-format " | " \-noformat ] .RB [ \-forward " | " \-noforward ] -.RB [ \-mime " | " \-nomime ] -.RB [ \-msgid " | " \-nomsgid ] .RB [ \-push " | " \-nopush ] .RB [ \-verbose " | " \-noverbose ] .RB [ \-watch " | " \-nowatch ] -.RB [ \-server -.IR servername ] -.RB [ \-port -.IR port-name/number ] -.RB [ \-width -.IR columns ] .RB [ msg \&...] .RB [ \-version ] .RB [ \-help ] -.RB [ \-attach -.IR header-field-name ] -.RB [ \-attachformat -.IR 0 " | " 1 " | " 2 ] .ad .SH DESCRIPTION .B Send will cause each of the specified messages to be delivered -to each of the destinations in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, +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 is re\-distributing a message, as invoked from @@ -57,24 +41,18 @@ profile component. Most of the features attributed to .B send are actually performed by .BR post . - .PP -If a -.I header-field-name -is supplied using the -.B -attach -option, the draft is scanned for a header whose field name matches the -supplied -.IR header-field-name . -The draft is converted to a MIME message if one or more matches are found. +The draft is scanned for attachment header fields. +Their name defaults to ``Attach'', but may be changed by the value of the +.I Attachment-Header +profile entry. +If such header fields are found, or the body contains non-ASCII characters, +the message is converted to a MIME message. This conversion occurs before all other processing. .PP -The first part of the MIME message is the draft body if that body contains -any non-blank characters. -The body of each header field whose name matches the -.I header-field-name -is interpreted as a file name, and each file named is included as a separate -part in the MIME message. +The first part of the MIME message is the draft body if the body is non-empty. +The body of each attachment header field 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 .I mhshow-suffix- @@ -82,54 +60,15 @@ entry for that suffix. The content-type for the part is taken from that context entry if a match is found. 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. -.PP -Each part contains a name attribute that is the last component of the path name. -A -.I x-unix-mode -attribute containing the file mode accompanies each part. -Finally, a description attribute is generated by running the -.I file -command on the file. +is text/plain if the file contains only ASCII characters or +application/octet-stream otherwise. .PP -The -.B -attachformat -option specifies the MIME header field formats: a value of -.B 0, -the default, -includes the -.I x-unix-mode -attribute as noted above. A value of -.B 1 -suppresses both that and the \*(lqContent-Description\*(rq header, and -adds a \*(lqContent-Disposition\*(rq header. A value of -.B 2 -adds the file -.I modification-date -parameter to the \*(lqContent-Disposition\*(rq header. You can -specify one value in your profile, and override it for individual -messages at the -.I whatnow -prompt. -.PP -Here are example message part headers, for an attachment, for each of the -.B -attachformat -values: +The last component of the path name is taken as the name of the MIME parts. +A message part header for an attachment might be: .PP .nf --attachformat 0: -Content-Type: text/plain; name="VERSION"; x-unix-mode="0644"; - charset="us-ascii" -Content-Description: ASCII text - --attachformat 1: Content-Type: text/plain; name="VERSION"; charset="us-ascii" Content-Disposition: attachment; filename="VERSION" - --attachformat 2: -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 If @@ -140,7 +79,8 @@ will detach itself from the user's terminal and perform its actions in the background. If .BR push 'd and the draft can't be sent, then an error message will be sent (using -the mailproc) back to the user. If +.BR mhmail ) +back to the user. If .B \-forward is given, then a copy of the draft will be attached to this failure notice. Using @@ -208,20 +148,6 @@ it takes extra effort in most mailers to reply to the included message, and so would usually only be done deliberately, rather than by accident. .PP -If -.B \-filter -.I filterfile -is specified, then this copy is filtered -(re\-formatted) by -.B mhl -prior to being sent to the blind recipients. -Alternately, if you specify the -.B -mime -switch, then -.B send -will -use the MIME rules for encapsulation. -.PP Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq, and \*(lqDate:\ now\*(rq will be appended to the headers in the message. If the environment variable @@ -232,10 +158,6 @@ line of the message. If this environment variable is not set, then .B send will consult the profile entry \*(lqSignature\*(rq for this information. -If -.B \-msgid -is specified, then a \*(lqMessage\-ID:\*(rq field will also -be added to the message. .PP If .B send @@ -247,40 +169,12 @@ If the message already contains a \*(lqFrom:\*(rq field, then a \*(lqSender: user@local\*(rq field will be added as well. (An already existing \*(lqSender:\*(rq field is an error!) .PP -By using the -.B \-format -switch, each of the entries in the \*(lqTo:\*(rq -and \*(lqcc:\*(rq fields will be replaced with \*(lqstandard\*(rq -format entries. This standard format is designed to be usable by all -of the message handlers on the various systems around the Internet. -If -.B \-noformat -is given, then headers are output exactly as they appear -in the message draft. -.PP If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied to the specified folder for the sender in the format in which it will appear to any non\-Bcc receivers of the message. That is, it will have the appended fields and field reformatting. The \*(lqFcc:\*(rq fields will be removed from all outgoing copies of the message. .PP -By using the -.B \-width -.I columns -switch, the user can direct -.B send -as to how long it should make header lines containing addresses. -.PP -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 .B \-alias @@ -310,7 +204,7 @@ for more information. ^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 +^Attachment\-Header:~^To set the name of the attachment header field ^postproc:~^Program to post the message .fi @@ -320,16 +214,10 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8) .SH DEFAULTS .nf .RB ` msg "' defaults to the current message in the draft folder" -.RB ` \-nofilter ' -.RB ` \-format ' .RB ` \-forward ' -.RB ` \-nomime ' -.RB ` \-nomsgid ' .RB ` \-nopush ' .RB ` \-noverbose ' .RB ` \-nowatch ' -.RB ` "\-width\ 72" ' -.RB ` "\-attachformat\ 0" ' .fi .SH CONTEXT