Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / RCS / post.rf,v
1 head    1.7;
2 access;
3 symbols;
4 locks; strict;
5
6
7 1.7
8 date    92.10.29.22.24.50;      author jromine; state Exp;
9 branches;
10 next    1.6;
11
12 1.6
13 date    92.10.16.21.36.19;      author jromine; state Exp;
14 branches;
15 next    1.5;
16
17 1.5
18 date    90.04.05.15.14.35;      author sources; state Exp;
19 branches;
20 next    1.4;
21
22 1.4
23 date    90.03.22.11.31.41;      author sources; state Exp;
24 branches;
25 next    1.3;
26
27 1.3
28 date    90.03.20.19.42.22;      author sources; state Exp;
29 branches;
30 next    1.2;
31
32 1.2
33 date    90.03.20.17.36.36;      author sources; state Exp;
34 branches;
35 next    1.1;
36
37 1.1
38 date    90.03.20.17.21.20;      author sources; state Exp;
39 branches;
40 next    ;
41
42
43 desc
44 @@
45
46
47 1.7
48 log
49 @typo
50 @
51 text
52 @.\"    @@(MHWARNING)
53 .\" @@(#)$Id: post.rf,v 1.6 1992/10/16 21:36:19 jromine Exp jromine $
54 .SC POST 8
55 .NA
56 post \- deliver a message
57 .SY
58 @@(MHETCPATH)/post 
59 \%[\-alias\ aliasfile]
60 \%[\-filter\ filterfile] \%[\-nofilter]
61 @@BEGIN: TMA
62 \%[\-encrypt] \%[\-noencrypt] 
63 @@END: TMA
64 \%[\-format] \%[\-noformat]
65 @@BEGIN: MIME
66 \%[\-mime] \%[\-nomime]
67 @@END: MIME
68 \%[\-msgid] \%[\-nomsgid]
69 \%[\-verbose] \%[\-noverbose]
70 \%[\-watch] \%[\-nowatch]
71 \%[\-width\ columns]
72 file
73 \%[\-help]
74 .DE
75 \fIPost\fR is the program called by \fIsend\fR\0(1)
76 to deliver the message in \fIfile\fR to local and remote users.
77 In fact, all of the functions attributed to \fIsend\fR
78 on its manual page are performed by \fIpost\fR,
79 with \fIsend\fR acting as a relatively simple preprocessor.
80 Thus, it is \fIpost\fR which parses the various header fields,
81 appends From: and Date: lines,
82 @@BEGIN: MMDFMTS
83 and interacts with the \fIMMDF\fR transport system.
84 @@END: MMDFMTS
85 @@BEGIN: MHMTS
86 and delivers and/or queues the messages.
87 @@END: MHMTS
88 @@BEGIN: SENDMTS
89 and interacts with the \fISendMail\fR transport system.
90 @@END: SENDMTS
91 \fIPost\fR will not normally be called directly by the user.
92
93 \fIPost\fR
94 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq
95 header lines of
96 the specified message for destination addresses, checks these
97 addresses for validity, and formats them so as to conform to 
98 ARPAnet Internet Message Format protocol,
99 unless the `\-noformat' flag is set.
100 This will normally cause \*(lq@@\fIlocal\-site\fR\*(rq to
101 be appended to each local destination address, as well
102 as any local return addresses.  
103 The `\-width\ columns' switch can be used to indicate the preferred length
104 of the header components that contain addresses.
105
106 If a \*(lqBcc:\*(rq field is encountered,
107 its addresses will be used for delivery,
108 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
109 recipients.
110 The blind recipients will receive an entirely new message with
111 a minimal set of headers.
112 Included in the body of the message will be a copy of the message sent to the
113 sighted recipients.
114 If `\-filter\ filterfile' is specified,
115 then this copy is filtered (re\-formatted)
116 prior to being sent to the blind recipients.
117 @@BEGIN: MIME
118 Otherwise,
119 to use the MIME rules for encapsulation,
120 specify the `\-mime' switch.
121 @@END: MIME
122
123 The `\-alias\ aliasfile' switch can be used to specify a file that post should
124 take aliases from.  More than one file can be specified, each being preceded
125 with `\-alias'.
126 In any event,
127 the primary alias file is read first.
128
129 The `\-msgid' switch indicates that
130 a \*(lqMessage\-ID:\*(rq or \*(lqResent\-Message\-ID:\*(rq
131 field should be added to the header.
132
133 The `\-verbose' switch indicates that the user should be informed of each
134 step of the posting/filing process.
135
136 The `\-watch' switch indicates that the user would like to watch the transport
137 system's handling of the message (e.g., local and \*(lqfast\*(rq delivery).
138
139 \fIPost\fR consults the envariable \fB$SIGNATURE\fR to
140 determine the sender's personal name in constructing the \*(lqFrom:\*(rq line
141 of the message.
142 .Fi
143 ^@@(MHETCPATH)/mtstailor~^tailor file
144 ^@@(MHBINPATH)/refile~^Program to process Fcc:s
145 ^@@(MHETCPATH)/mhl~^Program to process Bcc:s
146 ^@@(MHETCPATH)/MailAliases~^Primary alias file
147 .Pr
148 \fIpost\fR does \fBNOT\fR consult the user's \&.mh\(ruprofile
149 .Sa
150 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822),
151 .br
152 mhmail(1), send(1), mh\-mail(5), mh\-alias(5)
153 .De
154 `\-alias @@(MHETCPATH)/MailAliases'
155 @@BEGIN: TMA
156 `\-noencrypt'
157 @@END: TMA
158 .Ds
159 `\-format'
160 @@BEGIN: MIME
161 .Ds
162 `\-nomime'
163 @@END: MIME
164 .Ds
165 `\-nomsgid'
166 .Ds
167 `\-noverbose'
168 .Ds
169 `\-nowatch'
170 .Ds
171 `\-width\ 72'
172 .Ds
173 `\-nofilter'
174 .Co
175 None
176 .Bu
177 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according to the
178 822 specification,
179 but \fIpost\fR won't let you use them.
180 .En
181 @
182
183
184 1.6
185 log
186 @MIME changes
187 @
188 text
189 @d2 1
190 a2 1
191 .\" @@(#)$Id: post.rf,v 1.5 1990/04/05 15:14:35 sources Exp jromine $
192 d118 1
193 a118 1
194 '\-nowatch'
195 @
196
197
198 1.5
199 log
200 @add ID
201 @
202 text
203 @d2 1
204 a2 1
205 .\" @@(#)$Id:$
206 d14 3
207 d66 5
208 d109 4
209 @
210
211
212 1.4
213 log
214 @put things back, do .NA stuff another way
215 @
216 text
217 @d2 1
218 @
219
220
221 1.3
222 log
223 @typo
224 @
225 text
226 @d2 2
227 a3 2
228 .TH POST 8 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
229 .SH .NA
230 d5 1
231 a5 1
232 .SH .SY
233 @
234
235
236 1.2
237 log
238 @fixup for makewhatis
239 @
240 text
241 @d2 1
242 a2 1
243 .TH POST 8 [mh.6] MH
244 @
245
246
247 1.1
248 log
249 @Initial revision
250 @
251 text
252 @d2 2
253 a3 2
254 .SC POST 8
255 .NA
256 d5 1
257 a5 1
258 .SY
259 @