git.marmaro.de Git - mmh/blob - man/send.man1

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH SEND %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 send \- send a message
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B send
  11 .RB [ \-alias
  12 .IR aliasfile ]
  13 .RB [ \-forward " | " \-noforward ]
  14 .RB [ \-push " | " \-nopush ]
  15 .RB [ \-verbose " | " \-noverbose ]
  16 .RB [ \-watch " | " \-nowatch ]
  17 .RB [ msg
  18 \&...]
  19 .RB [ \-version ]
  20 .RB [ \-help ]
  21 .ad
  22 .SH DESCRIPTION
  23 .B Send
  24 will cause each of the specified messages to be delivered
  25 to each of the destinations in the \*(lqTo:\*(rq, \*(lqCc:\*(rq,
  26 \*(lqBcc:\*(rq, \*(lqDcc:\*(rq, and \*(lqFcc:\*(rq fields of the message.  If
  27 .B send
  28 is re\-distributing a message, as invoked from
  29 .BR dist ,
  30 then the
  31 corresponding \*(lqResent\-xxx\*(rq fields are examined instead.
  32 .PP
  33 .B send
  34 uses the program
  35 .B spost
  36 to do the actual delivery of the messages.
  37 Most of the features attributed to
  38 .B send
  39 are actually performed by
  40 .BR spost .
  41 .PP
  42 The draft is scanned for attachment header fields.
  43 Their name defaults to ``Attach'', but may be changed by the value of the
  44 .I Attachment-Header
  45 profile entry.
  46 If such header fields are found, or the body contains non-ASCII characters,
  47 the message is converted to a MIME message.
  48 This conversion occurs before all other processing.
  49 .PP
  50 The first part of the MIME message is the draft body if the body is non-empty.
  51 The body of each attachment header field is interpreted as a file name,
  52 and each file named is included as a separate part in the MIME message.
  53 .PP
  54 For file names with dot suffixes, the context is scanned for a
  55 .I mhshow-suffix-
  56 entry for that suffix.
  57 The content-type for the part is taken from that context entry if a match is
  58 found.
  59 If no match is found or the file does not have a dot suffix, the content-type
  60 is text/plain if the file contains only ASCII characters or
  61 application/octet-stream otherwise.
  62 .PP
  63 The last component of the path name is taken as the name of the MIME parts.
  64 A message part header for an attachment might be:
  65 .PP
  66 .nf
  67 Content-Type: text/plain; name="VERSION"; charset="us-ascii"
  68 Content-Disposition: attachment; filename="VERSION"
  69 .fi
  70 .PP
  71 If
  72 .B \-push
  73 is specified,
  74 .B send
  75 will detach itself from the user's
  76 terminal and perform its actions in the background.  If
  77 .BR push 'd
  78 and the draft can't be sent, then an error message will be sent (using
  79 .BR mhmail )
  80 back to the user.  If
  81 .B \-forward
  82 is given, then a copy
  83 of the draft will be attached to this failure notice.  Using
  84 .B \-push
  85 differs from putting
  86 .B send
  87 in the background because the output is
  88 trapped and analyzed by
  89 .BR nmh .
  90 .PP
  91 If
  92 .B \-verbose
  93 is specified,
  94 .B send
  95 will indicate the interactions
  96 occurring with the transport system, prior to actual delivery.
  97 If
  98 .B \-watch
  99 is specified
 100 .B send
 101 will monitor the delivery of local
 102 and network mail.  Hence, by specifying both switches, a large detail
 103 of information can be gathered about each step of the message's entry
 104 into the transport system.
 105 .PP
 106 .B Send
 107 with no
 108 .I msg
 109 argument will send the current message in the draft folder.
 110 .B Send
 111 always takes messages from the draft folder.
 112 (But, a
 113 .I +folder
 114 argument might be added in the future.)
 115 Consult the
 116 .BR mh-draft (7)
 117 man page for more information.
 118 .PP
 119 Once the transport system has successfully accepted custody of the
 120 message, the message will be renamed with a leading comma, which allows
 121 it to be retrieved until the next draft message is sent.  If there are
 122 errors in the formatting of the message,
 123 .B send
 124 will abort with a
 125 (hopefully) helpful error message.
 126 .PP
 127 If a \*(lqBcc:\*(rq field is encountered, its addresses will be used for
 128 delivery, and the \*(lqBcc:\*(rq field will be removed from the message
 129 sent to sighted recipients.  The blind recipients will receive an entirely
 130 new message with a minimal set of headers.  Included in the body of the
 131 message will be a copy of the message sent to the sighted recipients.
 132 .PP
 133 If a \*(lqDcc:\*(rq field is encountered, its addresses will be used for
 134 delivery, and the \*(lqDcc:\*(rq field will be removed from the message.  The
 135 blind recipients will receive the same message sent to the sighted
 136 recipients. *WARNING* Recipients listed in the \*(lqDcc:\*(rq field receive no
 137 explicit indication that they have received a \*(lqblind copy\*(rq.
 138 This can cause blind recipients to
 139 inadvertently reply to all of the sighted recipients of the
 140 original message, revealing that they received a blind copy.
 141 On the other hand, since a normal reply to a message sent
 142 via a \*(lqBcc:\*(rq field
 143 will generate a reply only to the sender of the original message,
 144 it takes extra effort in most mailers to reply to the included
 145 message, and so would usually only be done deliberately, rather
 146 than by accident.
 147 .PP
 148 Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq,
 149 and \*(lqDate:\ now\*(rq will be appended to the headers in the message.
 150 If the environment variable
 151 .B $SIGNATURE
 152 is set, then its value
 153 is used as your personal name when constructing the \*(lqFrom:\*(rq
 154 line of the message.  If this environment variable is not set, then
 155 .B send
 156 will consult the profile entry \*(lqSignature\*(rq for
 157 this information.
 158 .PP
 159 If
 160 .B send
 161 is re\-distributing a message (when invoked by
 162 .BR dist ),
 163 then \*(lqResent\-\*(rq will be prepended to each of these
 164 fields: \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
 165 If the message already contains a \*(lqFrom:\*(rq field, then a
 166 \*(lqSender: user@local\*(rq field will be added as well.  (An already
 167 existing \*(lqSender:\*(rq field is an error!)
 168 .PP
 169 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
 170 to the specified folder for the sender in the format in which it will
 171 appear to any non\-Bcc receivers of the message.  That is, it will have
 172 the appended fields and field reformatting.  The \*(lqFcc:\*(rq fields
 173 will be removed from all outgoing copies of the message.
 174 .PP
 175 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 176 additional alias files given by the
 177 .B \-alias
 178 .I aliasfile
 179 switch will be
 180 read (more than one file, each preceded by
 181 .BR \-alias ,
 182 can be named).
 183 See
 184 .BR mh\-alias (5)
 185 for more information.
 186
 187 .SH FILES
 188 .fc ^ ~
 189 .nf
 190 .ta \w'%etcdir%/ExtraBigFileName  'u
 191 ^$HOME/.mmh/profile~^The user profile
 192 ^+drafts~^The draft folder
 193 .fi
 194
 195 .SH "PROFILE COMPONENTS"
 196 .fc ^ ~
 197 .nf
 198 .ta 2.4i
 199 .ta \w'ExtraBigProfileName  'u
 200 ^Path:~^To determine the user's mail storage
 201 ^Draft\-Folder:~^To set the default draft\-folder
 202 ^Aliasfile:~^For a default alias file
 203 ^Signature:~^To determine the user's mail signature
 204 ^Attachment\-Header:~^To set the name of the attachment header field
 205 .fi
 206
 207 .SH "SEE ALSO"
 208 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), spost(8)
 209
 210 .SH DEFAULTS
 211 .nf
 212 .RB ` msg "' defaults to the current message in the draft folder"
 213 .RB ` \-forward '
 214 .RB ` \-nopush '
 215 .RB ` \-noverbose '
 216 .RB ` \-nowatch '
 217 .fi
 218
 219 .SH CONTEXT
 220 None
 221
 222 .SH BUGS
 223 Under some configurations, it is not possible to monitor the mail delivery
 224 transaction;
 225 .B \-watch
 226 is a no-op on those systems.