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