2 .\" @(#)$Id: send.rf,v 1.12 1992/12/04 17:30:23 jromine Exp $
10 \%[\-draftfolder\ +folder] \%[\-draftmessage\ msg] \%[\-nodraftfolder]
12 \%[\-encrypt] \%[\-noencrypt]
14 \%[\-filter\ filterfile] \%[\-nofilter]
15 \%[\-format] \%[\-noformat]
16 \%[\-forward] \%[\-noforward]
18 \%[\-mime] \%[\-nomime]
20 \%[\-msgid] \%[\-nomsgid]
21 \%[\-push] \%[\-nopush]
25 \%[\-verbose] \%[\-noverbose]
26 \%[\-watch] \%[\-nowatch]
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
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.
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
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
62 If `\-split' is specified,
63 \fIsend\fR will split the draft into one or more partial messages
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.
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.
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
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
94 If `\-filter\ filterfile' is specified,
95 then this copy is filtered (re\-formatted)
96 prior to being sent to the blind recipients.
99 to use the MIME rules for encapsulation,
100 specify the `-mime' switch.
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
114 then the file \fB$HOME\fR/.signature is consulted.
116 specified, then a \*(lqMessage\-ID:\*(rq field will also be added to the
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.
126 \*(lqSender:\*(rq field is an error!)
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
135 If `\-noformat' is given,
136 then headers are output exactly as they appear in the message draft.
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
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.
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.
154 ^$HOME/\&.mh\(ruprofile~^The user profile
156 ^Path:~^To determine the user's MH directory
158 ^Draft\-Folder:~^To find the default draft\-folder
160 ^Aliasfile:~^For a default alias file
162 ^Signature:~^To determine the user's mail signature
164 ^mailproc:~^Program to post failure notices
166 ^postproc:~^Program to post the message
168 comp(1), dist(1), forw(1), repl(1), mh\-alias(5), post(8)
170 `file' defaults to <mh\-dir>/draft
172 `\-alias @(MHETCPATH)/MailAliases'
201 Under some configurations, it is not possible to mointor the
202 mail delivery transaction; `\-watch' is a no-op on those systems.
205 Using `\-split\00' doesn't work correctly.