X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fsend.man1;h=6e7b19e534bbccd504ea341834e14389d84a6944;hp=c5bec46aed605bfe38210fea7f9018b0f4882527;hb=8ff284ff9167eff8f5349481529332d59ed913b1;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/send.man1 b/man/send.man1 index c5bec46..6e7b19e 100644 --- a/man/send.man1 +++ b/man/send.man1 @@ -30,15 +30,11 @@ send \- send a message \&...] .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 +53,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 +72,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. -.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. +is text/plain if the file contains only ASCII characters or +application/octet-stream otherwise. .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 @@ -250,7 +201,7 @@ existing \*(lqSender:\*(rq field is an error!) By using the .B \-format switch, each of the entries in the \*(lqTo:\*(rq -and \*(lqcc:\*(rq fields will be replaced with \*(lqstandard\*(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 @@ -310,6 +261,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 +^Attachment\-Header:~^To set the name of the attachment header field ^mailproc:~^Program to post failure notices ^postproc:~^Program to post the message .fi @@ -329,7 +281,6 @@ comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8) .RB ` \-noverbose ' .RB ` \-nowatch ' .RB ` "\-width\ 72" ' -.RB ` "\-attachformat\ 0" ' .fi .SH CONTEXT