X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fsend.man1;h=4292a2d43ddfe7df0bab26f710c2f986f1b8a2d3;hp=a1a134ac0ba660758e6905917c1e0a3fb058e362;hb=32b2354dbaf4bf934936eb5b102a4a3d2fdd209a;hpb=f12a3e5036a986f579b80861f4421bcb86f84cee diff --git a/man/send.man1 b/man/send.man1 index a1a134a..4292a2d 100644 --- a/man/send.man1 +++ b/man/send.man1 @@ -10,30 +10,12 @@ 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 [ \-Version ] .RB [ \-help ] -.RB [ \-attach -.IR header-field-name ] -.RB [ \-attachformat -.IR 0 " | " 1 " | " 2 ] .ad .SH DESCRIPTION .B Send @@ -46,112 +28,46 @@ is re\-distributing a message, as invoked from then the corresponding \*(lqResent\-xxx\*(rq fields are examined instead. .PP -By default, .B send uses the program -.B post -to do the actual -delivery of the messages, although this can be changed by defining the -.I postproc -profile component. Most of the features attributed to +.B spost +to do the actual delivery of the messages. +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. +.BR spost . +.PP +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- +.I show-suffix- 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-Description: VERSION 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 -.B \-push -is specified, -.B send -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 -.B \-forward -is given, then a copy -of the draft will be attached to this failure notice. Using -.B \-push -differs from putting -.B send -in the background because the output is -trapped and analyzed by -.BR nmh . -.PP -If .B \-verbose is specified, .B send @@ -208,20 +124,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 +134,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 +145,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,26 +180,17 @@ 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 -^postproc:~^Program to post the message +^Attachment\-Header:~^To set the name of the attachment header field .fi .SH "SEE ALSO" -comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8) +comp(1), dist(1), forw(1), repl(1), mh\-alias(5), spost(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