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

   1 .\"     @(MHWARNING)
   2 .\" @(#)$Id: send.rf,v 1.12 1992/12/04 17:30:23 jromine Exp $
   3 .SC SEND 1
   4 .NA
   5 send \- send a message
   6 .SY
   7 send
   8 \%[\-alias\ aliasfile]
   9 \%[\-draft]
  10 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
  11 @BEGIN: TMA
  12 \%[\-encrypt] \%[\-noencrypt]
  13 @END: TMA
  14 \%[\-filter\ filterfile] \%[\-nofilter]
  15 \%[\-format] \%[\-noformat]
  16 \%[\-forward] \%[\-noforward]
  17 @BEGIN: MIME
  18 \%[\-mime] \%[\-nomime]
  19 @END: MIME
  20 \%[\-msgid] \%[\-nomsgid]
  21 \%[\-push] \%[\-nopush]
  22 @BEGIN: MIME
  23 \%[\-split\ seconds]
  24 @END: MIME
  25 \%[\-verbose] \%[\-noverbose]
  26 \%[\-watch] \%[\-nowatch]
  27 \%[\-width\ columns]
  28 \%[file\ ...]
  29 \%[\-help]
  30 .DE
  31 \fISend\fR will cause each of the specified files to
  32 be delivered (via \fIpost\fR\0(8)) to each of the destinations
  33 in the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, and \*(lqFcc:\*(rq
  34 fields of the message.
  35 If \fIsend\fR is re\-distributing a message, as invoked from \fIdist\fR,
  36 then the corresponding \*(lqResent\-xxx\*(rq fields are examined
  37 instead.
  38
  39 If `\-push' is specified,
  40 \fIsend\fR will detach itself from the user's terminal and perform its
  41 actions in the background.
  42 If \fIpush\fR\0'd and the draft can't be sent,
  43 then the `\-forward' switch says that draft should be forwarded with
  44 the failure notice sent to the user.
  45 This differs from putting \fIsend\fR in the background because the output is
  46 trapped and analyzed by \fIMH\fR.
  47
  48 If `\-verbose' is specified, \fIsend\fR will indicate the interactions
  49 occurring with the transport system, prior to actual delivery.
  50 If `\-watch' is specified \fIsend\fR will monitor the delivery of local and
  51 network mail.  Hence, by specifying both switches, a large detail of
  52 information can be gathered about each step of the message's entry into the
  53 transport system.
  54
  55 The `\-draftfolder\ +folder' and `\-draftmessage\ msg' switches invoke the
  56 \fIMH\fR draft folder facility.
  57 This is an advanced (and highly useful) feature.
  58 Consult the \fBAdvanced Features\fR section of the \fIMH\fR manual for more
  59 information.
  60 @BEGIN: MIME
  61
  62 If `\-split' is specified,
  63 \fIsend\fR will split the draft into one or more partial messages
  64 prior to sending.
  65 This makes use of the multi-media content feature in MH.
  66 Note however that if \fIsend\fR is invoked under \fIdist\fR\0(1),
  67 then this switch is ignored\0--\0it makes no sense to redistribute a
  68 message in this fashion.
  69 Sometimes you want \fIsend\fR to pause after posting a partial message.
  70 This is usually the case when you are running \fIsendmail\fR and
  71 expect to generate a lot of partial messages.
  72 The argument to `\-split' tells it how long to pause between postings.
  73 @END: MIME
  74
  75 \fISend\fR with no \fIfile\fR
  76 argument will query whether the draft is the intended file, whereas
  77 `\-draft' will suppress this question.
  78 Once the transport system has successfully accepted custody of the message,
  79 the file will be renamed
  80 with a leading comma, which allows it to be retrieved until the
  81 next draft message is sent.
  82 If there are errors in the
  83 formatting of the message, \fIsend\fR will abort with a (hopefully)
  84 helpful error message.
  85
  86 If a \*(lqBcc:\*(rq field is encountered,
  87 its addresses will be used for delivery,
  88 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
  89 recipients.
  90 The blind recipients will receive an entirely new message with
  91 a minimal set of headers.
  92 Included in the body of the message will be a copy of the message sent to the
  93 sighted recipients.
  94 If `\-filter\ filterfile' is specified,
  95 then this copy is filtered (re\-formatted)
  96 prior to being sent to the blind recipients.
  97 @BEGIN: MIME
  98 Otherwise,
  99 to use the MIME rules for encapsulation,
 100 specify the `-mime' switch.
 101 @END: MIME
 102
 103 Prior to sending the message, the fields \*(lqFrom:\ user@local\*(rq, and
 104 \*(lqDate:\ now\*(rq will be appended to the headers in the message.
 105 If the envariable \fB$SIGNATURE\fR is set,
 106 then its value is used as your personal name when
 107 constructing the \*(lqFrom:\*(rq line of the message.
 108 If this envariable is not set,
 109 then \fIsend\fR will consult the profile entry \*(lqSignature\*(rq
 110 for this information.
 111 On hosts where \fIMH\fR was configured with the UCI option,
 112 if \fB$SIGNATURE\fR is not set and the \*(lqSignature\*(rq profile entry
 113 is not present,
 114 then the file \fB$HOME\fR/.signature is consulted.
 115 If `\-msgid' is
 116 specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
 117 message.
 118
 119 If \fIsend\fR is re\-distributing a message
 120 (when invoked by \fIdist\fR\0),
 121 then \*(lqResent\-\*(rq will be prepended to each of these fields:
 122 \*(lqFrom:\*(rq, \*(lqDate:\*(rq, and \*(lqMessage\-ID:\*(rq.
 123 If the message already contains a \*(lqFrom:\*(rq field, then a
 124 \*(lqSender: user@local\*(rq field will be added as well.
 125 (An already existing
 126 \*(lqSender:\*(rq field is an error!)
 127
 128 By using the `\-format' switch,
 129 each of the entries in
 130 the \*(lqTo:\*(rq and \*(lqcc:\*(rq fields will be replaced
 131 with \*(lqstandard\*(rq format entries.
 132 This standard format is designed to be usable by all
 133 of the message handlers on the various systems around the
 134 Internet.
 135 If `\-noformat' is given,
 136 then headers are output exactly as they appear in the message draft.
 137
 138 If an \*(lqFcc:\ folder\*(rq is encountered, the message will be copied
 139 to the specified folder for the sender in the format in which it will appear
 140 to any non\-Bcc receivers of the message.
 141 That is, it will have the appended
 142 fields and field reformatting.
 143 The \*(lqFcc:\*(rq fields will be removed from all outgoing copies of the
 144 message.
 145
 146 By using the `\-width\ columns' switch, the user can direct \fIsend\fR as to
 147 how long it should make header lines containing addresses.
 148
 149 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 150 additional alias files given by the `\-alias aliasfile' switch will be read
 151 (more than one file, each  preceeded by `\-alias', can be named).
 152 See \fImh\-alias\fR\0(5) for more information.
 153 .Fi
 154 ^$HOME/\&.mh\(ruprofile~^The user profile
 155 .Pr
 156 ^Path:~^To determine the user's MH directory
 157 .Ps
 158 ^Draft\-Folder:~^To find the default draft\-folder
 159 .Ps
 160 ^Aliasfile:~^For a default alias file
 161 .Ps
 162 ^Signature:~^To determine the user's mail signature
 163 .Ps
 164 ^mailproc:~^Program to post failure notices
 165 .Ps
 166 ^postproc:~^Program to post the message
 167 .Sa
 168 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
 169 .De
 170 `file' defaults to <mh\-dir>/draft
 171 .Ds
 172 `\-alias @(MHETCPATH)/MailAliases'
 173 .Ds
 174 `\-nodraftfolder'
 175 @BEGIN: TMA
 176 `\-noencrypt'
 177 @END: TMA
 178 .Ds
 179 `\-nofilter'
 180 .Ds
 181 `\-format'
 182 .Ds
 183 `\-forward'
 184 @BEGIN: MIME
 185 .Ds
 186 `\-nomime'
 187 @END: MIME
 188 .Ds
 189 `\-nomsgid'
 190 .Ds
 191 `\-nopush'
 192 .Ds
 193 `\-noverbose'
 194 .Ds
 195 `\-nowatch'
 196 .Ds
 197 `\-width\ 72'
 198 .Co
 199 None
 200 .Bu
 201 Under some configurations, it is not possible to mointor the
 202 mail delivery transaction; `\-watch' is a no-op on those systems.
 203 .sp
 204 @BEGIN: MIME
 205 Using `\-split\00' doesn't work correctly.
 206 @END: MIME
 207 .En