git.marmaro.de Git - mmh/blob - docs/historical/mh-6.8.5/conf/doc/RCS/send.rf,v

   1 head    1.12;
   2 access;
   3 symbols;
   4 locks; strict;
   5
   6
   7 1.12
   8 date    92.12.04.17.30.23;      author jromine; state Exp;
   9 branches;
  10 next    1.11;
  11
  12 1.11
  13 date    92.11.09.18.17.15;      author jromine; state Exp;
  14 branches;
  15 next    1.10;
  16
  17 1.10
  18 date    92.10.16.21.36.23;      author jromine; state Exp;
  19 branches;
  20 next    1.9;
  21
  22 1.9
  23 date    92.05.19.21.56.44;      author jromine; state Exp;
  24 branches;
  25 next    1.8;
  26
  27 1.8
  28 date    92.02.11.00.47.53;      author jromine; state Exp;
  29 branches;
  30 next    1.7;
  31
  32 1.7
  33 date    92.01.31.16.41.11;      author jromine; state Exp;
  34 branches;
  35 next    1.6;
  36
  37 1.6
  38 date    90.04.05.15.09.54;      author sources; state Exp;
  39 branches;
  40 next    1.5;
  41
  42 1.5
  43 date    90.03.22.11.31.51;      author sources; state Exp;
  44 branches;
  45 next    1.4;
  46
  47 1.4
  48 date    90.03.20.19.42.34;      author sources; state Exp;
  49 branches;
  50 next    1.3;
  51
  52 1.3
  53 date    90.03.20.17.36.48;      author sources; state Exp;
  54 branches;
  55 next    1.2;
  56
  57 1.2
  58 date    90.03.16.15.40.24;      author sources; state Exp;
  59 branches;
  60 next    1.1;
  61
  62 1.1
  63 date    90.03.16.15.31.00;      author sources; state Exp;
  64 branches;
  65 next    ;
  66
  67
  68 desc
  69 @@
  70
  71
  72 1.12
  73 log
  74 @note bug in -split 0
  75 @
  76 text
  77 @.\"    @@(MHWARNING)
  78 .\" @@(#)$Id: send.rf,v 1.11 1992/11/09 18:17:15 jromine Exp jromine $
  79 .SC SEND 1
  80 .NA
  81 send \- send a message
  82 .SY
  83 send
  84 \%[\-alias\ aliasfile]
  85 \%[\-draft]
  86 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
  87 @@BEGIN: TMA
  88 \%[\-encrypt] \%[\-noencrypt]
  89 @@END: TMA
  90 \%[\-filter\ filterfile] \%[\-nofilter]
  91 \%[\-format] \%[\-noformat]
  92 \%[\-forward] \%[\-noforward]
  93 @@BEGIN: MIME
  94 \%[\-mime] \%[\-nomime]
  95 @@END: MIME
  96 \%[\-msgid] \%[\-nomsgid]
  97 \%[\-push] \%[\-nopush]
  98 @@BEGIN: MIME
  99 \%[\-split\ seconds]
 100 @@END: MIME
 101 \%[\-verbose] \%[\-noverbose]
 102 \%[\-watch] \%[\-nowatch]
 103 \%[\-width\ columns]
 104 \%[file\ ...]
 105 \%[\-help]
 106 .DE
 107 \fISend\fR will cause each of the specified files to
 108 be delivered (via \fIpost\fR\0(8)) to each of the destinations
 109 in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, and \*(lqFcc:\*(rq
 110 fields of the message.
 111 If \fIsend\fR is re\-distributing a message, as invoked from \fIdist\fR,
 112 then the corresponding \*(lqResent\-xxx\*(rq fields are examined
 113 instead.
 114
 115 If `\-push' is specified,
 116 \fIsend\fR will detach itself from the user's terminal and perform its
 117 actions in the background.
 118 If \fIpush\fR\0'd and the draft can't be sent,
 119 then the `\-forward' switch says that draft should be forwarded with
 120 the failure notice sent to the user.
 121 This differs from putting \fIsend\fR in the background because the output is
 122 trapped and analyzed by \fIMH\fR.
 123
 124 If `\-verbose' is specified, \fIsend\fR will indicate the interactions
 125 occurring with the transport system, prior to actual delivery.
 126 If `\-watch' is specified \fIsend\fR will monitor the delivery of local and
 127 network mail.  Hence, by specifying both switches, a large detail of
 128 information can be gathered about each step of the message's entry into the
 129 transport system.
 130
 131 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
 132 \fIMH\fR draft folder facility.
 133 This is an advanced (and highly useful) feature.
 134 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
 135 information.
 136 @@BEGIN: MIME
 137
 138 If `\-split' is specified,
 139 \fIsend\fR will split the draft into one or more partial messages
 140 prior to sending.
 141 This makes use of the multi-media content feature in MH.
 142 Note however that if \fIsend\fR is invoked under \fIdist\fR\0(1),
 143 then this switch is ignored\0--\0it makes no sense to redistribute a
 144 message in this fashion.
 145 Sometimes you want \fIsend\fR to pause after posting a partial message.
 146 This is usually the case when you are running \fIsendmail\fR and
 147 expect to generate a lot of partial messages.
 148 The argument to `\-split' tells it how long to pause between postings.
 149 @@END: MIME
 150
 151 \fISend\fR with no \fIfile\fR
 152 argument will query whether the draft is the intended file, whereas
 153 `\-draft' will suppress this question.
 154 Once the transport system has successfully accepted custody of the message,
 155 the file will be renamed
 156 with a leading comma, which allows it to be retrieved until the
 157 next draft message is sent.
 158 If there are errors in the
 159 formatting of the message, \fIsend\fR will abort with a (hopefully)
 160 helpful error message.
 161
 162 If a \*(lqBcc:\*(rq field is encountered,
 163 its addresses will be used for delivery,
 164 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
 165 recipients.
 166 The blind recipients will receive an entirely new message with
 167 a minimal set of headers.
 168 Included in the body of the message will be a copy of the message sent to the
 169 sighted recipients.
 170 If `\-filter\ filterfile' is specified,
 171 then this copy is filtered (re\-formatted)
 172 prior to being sent to the blind recipients.
 173 @@BEGIN: MIME
 174 Otherwise,
 175 to use the MIME rules for encapsulation,
 176 specify the `-mime' switch.
 177 @@END: MIME
 178
 179 Prior to sending the message, the fields \*(lqFrom:\ user@@local\*(rq, and
 180 \*(lqDate:\ now\*(rq will be appended to the headers in the message.
 181 If the envariable \fB$SIGNATURE\fR is set,
 182 then its value is used as your personal name when
 183 constructing the \*(lqFrom:\*(rq line of the message.
 184 If this envariable is not set,
 185 then \fIsend\fR will consult the profile entry \*(lqSignature\*(rq
 186 for this information.
 187 On hosts where \fIMH\fR was configured with the UCI option,
 188 if \fB$SIGNATURE\fR is not set and the \*(lqSignature\*(rq profile entry
 189 is not present,
 190 then the file \fB$HOME\fR/.signature is consulted.
 191 If `\-msgid' is
 192 specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
 193 message.
 194
 195 If \fIsend\fR is re\-distributing a message
 196 (when invoked by \fIdist\fR\0),
 197 then \*(lqResent\-\*(rq will be prepended to each of these fields:
 198 \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
 199 If the message already contains a \*(lqFrom:\*(rq field, then a
 200 \*(lqSender: user@@local\*(rq field will be added as well.
 201 (An already existing
 202 \*(lqSender:\*(rq field is an error!)
 203
 204 By using the `\-format' switch,
 205 each of the entries in
 206 the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields will be replaced
 207 with \*(lqstandard\*(rq format entries.
 208 This standard format is designed to be usable by all
 209 of the message handlers on the various systems around the
 210 Internet.
 211 If `\-noformat' is given,
 212 then headers are output exactly as they appear in the message draft.
 213
 214 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
 215 to the specified folder for the sender in the format in which it will appear
 216 to any non\-Bcc receivers of the message.
 217 That is, it will have the appended
 218 fields and field reformatting.
 219 The \*(lqFcc:\*(rq fields will be removed from all outgoing copies of the
 220 message.
 221
 222 By using the `\-width\ columns' switch, the user can direct \fIsend\fR as to
 223 how long it should make header lines containing addresses.
 224
 225 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 226 additional alias files given by the `\-alias aliasfile' switch will be read
 227 (more than one file, each  preceeded by `\-alias', can be named).
 228 See \fImh\-alias\fR\0(5) for more information.
 229 .Fi
 230 ^$HOME/\&.mh\(ruprofile~^The user profile
 231 .Pr
 232 ^Path:~^To determine the user's MH directory
 233 .Ps
 234 ^Draft\-Folder:~^To find the default draft\-folder
 235 .Ps
 236 ^Aliasfile:~^For a default alias file
 237 .Ps
 238 ^Signature:~^To determine the user's mail signature
 239 .Ps
 240 ^mailproc:~^Program to post failure notices
 241 .Ps
 242 ^postproc:~^Program to post the message
 243 .Sa
 244 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 245 .De
 246 `file' defaults to <mh\-dir>/draft
 247 .Ds
 248 `\-alias @@(MHETCPATH)/MailAliases'
 249 .Ds
 250 `\-nodraftfolder'
 251 @@BEGIN: TMA
 252 `\-noencrypt'
 253 @@END: TMA
 254 .Ds
 255 `\-nofilter'
 256 .Ds
 257 `\-format'
 258 .Ds
 259 `\-forward'
 260 @@BEGIN: MIME
 261 .Ds
 262 `\-nomime'
 263 @@END: MIME
 264 .Ds
 265 `\-nomsgid'
 266 .Ds
 267 `\-nopush'
 268 .Ds
 269 `\-noverbose'
 270 .Ds
 271 `\-nowatch'
 272 .Ds
 273 `\-width\ 72'
 274 .Co
 275 None
 276 .Bu
 277 Under some configurations, it is not possible to mointor the
 278 mail delivery transaction; `\-watch' is a no-op on those systems.
 279 .sp
 280 @@BEGIN: MIME
 281 Using `\-split\00' doesn't work correctly.
 282 @@END: MIME
 283 .En
 284 @
 285
 286
 287 1.11
 288 log
 289 @note that -watch may not always work
 290 @
 291 text
 292 @d2 1
 293 a2 1
 294 .\" @@(#)$Id: send.rf,v 1.10 1992/10/16 21:36:23 jromine Exp jromine $
 295 d203 4
 296 @
 297
 298
 299 1.10
 300 log
 301 @MIME changes
 302 @
 303 text
 304 @d2 1
 305 a2 1
 306 .\" @@(#)$Id: send.rf,v 1.9 1992/05/19 21:56:44 jromine Exp jromine $
 307 d200 3
 308 @
 309
 310
 311 1.9
 312 log
 313 @MIME
 314 @
 315 text
 316 @d2 1
 317 a2 1
 318 .\" @@(#)$Id: send.rf,v 1.8 1992/02/11 00:47:53 jromine Exp jromine $
 319 d17 3
 320 d97 5
 321 d184 4
 322 @
 323
 324
 325 1.8
 326 log
 327 @document Aliasfile may be more than one file
 328 @
 329 text
 330 @d2 1
 331 a2 1
 332 .\" @@(#)$Id: send.rf,v 1.7 1992/01/31 16:41:11 jromine Exp jromine $
 333 d19 1
 334 d21 1
 335 d57 1
 336 d70 1
 337 @
 338
 339
 340 1.7
 341 log
 342 @Multimedia MH
 343 @
 344 text
 345 @d2 1
 346 a2 1
 347 .\" @@(#)$Id: send.rf,v 1.6 90/04/05 15:09:54 sources Exp $
 348 d137 1
 349 a137 1
 350 The file specified by the profile entry \*(lqAliasfile:\*(rq and any
 351 @
 352
 353
 354 1.6
 355 log
 356 @add ID
 357 @
 358 text
 359 @d2 1
 360 a2 1
 361 .\" @@(#)$Id:$
 362 d19 1
 363 d55 12
 364 @
 365
 366
 367 1.5
 368 log
 369 @put things back, do .NA stuff another way
 370 @
 371 text
 372 @d2 1
 373 @
 374
 375
 376 1.4
 377 log
 378 @typo
 379 @
 380 text
 381 @d2 2
 382 a3 2
 383 .TH SEND 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
 384 .SH .NA
 385 d5 1
 386 a5 1
 387 .SH .SY
 388 @
 389
 390
 391 1.3
 392 log
 393 @fixup for makewhatis
 394 @
 395 text
 396 @d2 1
 397 a2 1
 398 .TH SEND 1 [mh.6] MH
 399 @
 400
 401
 402 1.2
 403 log
 404 @document Aliasfile: profile entry
 405 @
 406 text
 407 @d2 2
 408 a3 2
 409 .SC SEND 1
 410 .NA
 411 d5 1
 412 a5 1
 413 .SY
 414 @
 415
 416
 417 1.1
 418 log
 419 @Initial revision
 420 @
 421 text
 422 @d123 3
 423 a125 3
 424 By using the `\-alias\ aliasfile' switch, the user can direct \fIsend\fR
 425 to consult the named files for alias definitions
 426 (more than one file, each  preceded by `\-alias', can be named).
 427 d133 2
 428 @