8 date 92.12.04.17.30.23; author jromine; state Exp;
13 date 92.11.09.18.17.15; author jromine; state Exp;
18 date 92.10.16.21.36.23; author jromine; state Exp;
23 date 92.05.19.21.56.44; author jromine; state Exp;
28 date 92.02.11.00.47.53; author jromine; state Exp;
33 date 92.01.31.16.41.11; author jromine; state Exp;
38 date 90.04.05.15.09.54; author sources; state Exp;
43 date 90.03.22.11.31.51; author sources; state Exp;
48 date 90.03.20.19.42.34; author sources; state Exp;
53 date 90.03.20.17.36.48; author sources; state Exp;
58 date 90.03.16.15.40.24; author sources; state Exp;
63 date 90.03.16.15.31.00; author sources; state Exp;
78 .\" @@(#)$Id: send.rf,v 1.11 1992/11/09 18:17:15 jromine Exp jromine $
81 send \- send a message
84 \%[\-alias\ aliasfile]
86 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
88 \%[\-encrypt] \%[\-noencrypt]
90 \%[\-filter\ filterfile] \%[\-nofilter]
91 \%[\-format] \%[\-noformat]
92 \%[\-forward] \%[\-noforward]
94 \%[\-mime] \%[\-nomime]
96 \%[\-msgid] \%[\-nomsgid]
97 \%[\-push] \%[\-nopush]
101 \%[\-verbose] \%[\-noverbose]
102 \%[\-watch] \%[\-nowatch]
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
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.
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
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
138 If `\-split' is specified,
139 \fIsend\fR will split the draft into one or more partial messages
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.
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.
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
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
170 If `\-filter\ filterfile' is specified,
171 then this copy is filtered (re\-formatted)
172 prior to being sent to the blind recipients.
175 to use the MIME rules for encapsulation,
176 specify the `-mime' switch.
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
190 then the file \fB$HOME\fR/.signature is consulted.
192 specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
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.
202 \*(lqSender:\*(rq field is an error!)
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
211 If `\-noformat' is given,
212 then headers are output exactly as they appear in the message draft.
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
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.
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.
230 ^$HOME/\&.mh\(ruprofile~^The user profile
232 ^Path:~^To determine the user's MH directory
234 ^Draft\-Folder:~^To find the default draft\-folder
236 ^Aliasfile:~^For a default alias file
238 ^Signature:~^To determine the user's mail signature
240 ^mailproc:~^Program to post failure notices
242 ^postproc:~^Program to post the message
244 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
246 `file' defaults to <mh\-dir>/draft
248 `\-alias @@(MHETCPATH)/MailAliases'
277 Under some configurations, it is not possible to mointor the
278 mail delivery transaction; `\-watch' is a no-op on those systems.
281 Using `\-split\00' doesn't work correctly.
289 @note that -watch may not always work
294 .\" @@(#)$Id: send.rf,v 1.10 1992/10/16 21:36:23 jromine Exp jromine $
306 .\" @@(#)$Id: send.rf,v 1.9 1992/05/19 21:56:44 jromine Exp jromine $
318 .\" @@(#)$Id: send.rf,v 1.8 1992/02/11 00:47:53 jromine Exp jromine $
327 @document Aliasfile may be more than one file
332 .\" @@(#)$Id: send.rf,v 1.7 1992/01/31 16:41:11 jromine Exp jromine $
347 .\" @@(#)$Id: send.rf,v 1.6 90/04/05 15:09:54 sources Exp $
350 The file specified by the profile entry \*(lqAliasfile:\*(rq and any
369 @put things back, do .NA stuff another way
383 .TH SEND 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
393 @fixup for makewhatis
404 @document Aliasfile: profile entry
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).