Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / doc / post.me
1 .\"     This file is automatically generated.  Do not edit!
2 .\" @(#)$Id: post.rf,v 1.7 1992/10/29 22:24:50 jromine Exp $
3 .SC POST 8
4 .NA
5 post \- deliver a message
6 .SY
7 /opt/mh-6.8.5/lib/post 
8 \%[\-alias\ aliasfile]
9 \%[\-filter\ filterfile] \%[\-nofilter]
10 \%[\-format] \%[\-noformat]
11 \%[\-mime] \%[\-nomime]
12 \%[\-msgid] \%[\-nomsgid]
13 \%[\-verbose] \%[\-noverbose]
14 \%[\-watch] \%[\-nowatch]
15 \%[\-width\ columns]
16 file
17 \%[\-help]
18 .DE
19 \fIPost\fR is the program called by \fIsend\fR\0(1)
20 to deliver the message in \fIfile\fR to local and remote users.
21 In fact, all of the functions attributed to \fIsend\fR
22 on its manual page are performed by \fIpost\fR,
23 with \fIsend\fR acting as a relatively simple preprocessor.
24 Thus, it is \fIpost\fR which parses the various header fields,
25 appends From: and Date: lines,
26 and interacts with the \fISendMail\fR transport system.
27 \fIPost\fR will not normally be called directly by the user.
28
29 \fIPost\fR
30 searches the \*(lqTo:\*(rq, \*(lqcc:\*(rq, \*(lqBcc:\*(rq, \*(lqFcc:\*(rq, and \*(lqResent\-xxx:\*(rq
31 header lines of
32 the specified message for destination addresses, checks these
33 addresses for validity, and formats them so as to conform to 
34 ARPAnet Internet Message Format protocol,
35 unless the `\-noformat' flag is set.
36 This will normally cause \*(lq@\fIlocal\-site\fR\*(rq to
37 be appended to each local destination address, as well
38 as any local return addresses.  
39 The `\-width\ columns' switch can be used to indicate the preferred length
40 of the header components that contain addresses.
41
42 If a \*(lqBcc:\*(rq field is encountered,
43 its addresses will be used for delivery,
44 and the \*(lqBcc:\*(rq field will be removed from the message sent to sighted
45 recipients.
46 The blind recipients will receive an entirely new message with
47 a minimal set of headers.
48 Included in the body of the message will be a copy of the message sent to the
49 sighted recipients.
50 If `\-filter\ filterfile' is specified,
51 then this copy is filtered (re\-formatted)
52 prior to being sent to the blind recipients.
53 Otherwise,
54 to use the MIME rules for encapsulation,
55 specify the `\-mime' switch.
56
57 The `\-alias\ aliasfile' switch can be used to specify a file that post should
58 take aliases from.  More than one file can be specified, each being preceded
59 with `\-alias'.
60 In any event,
61 the primary alias file is read first.
62
63 The `\-msgid' switch indicates that
64 a \*(lqMessage\-ID:\*(rq or \*(lqResent\-Message\-ID:\*(rq
65 field should be added to the header.
66
67 The `\-verbose' switch indicates that the user should be informed of each
68 step of the posting/filing process.
69
70 The `\-watch' switch indicates that the user would like to watch the transport
71 system's handling of the message (e.g., local and \*(lqfast\*(rq delivery).
72
73 \fIPost\fR consults the envariable \fB$SIGNATURE\fR to
74 determine the sender's personal name in constructing the \*(lqFrom:\*(rq line
75 of the message.
76 .Fi
77 ^/opt/mh-6.8.5/lib/mtstailor~^tailor file
78 ^/opt/mh-6.8.5/bin/refile~^Program to process Fcc:s
79 ^/opt/mh-6.8.5/lib/mhl~^Program to process Bcc:s
80 ^/opt/mh-6.8.5/lib/MailAliases~^Primary alias file
81 .Pr
82 \fIpost\fR does \fBNOT\fR consult the user's \&.mh\(ruprofile
83 .Sa
84 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822),
85 .br
86 mhmail(1), send(1), mh\-mail(5), mh\-alias(5)
87 .De
88 `\-alias /opt/mh-6.8.5/lib/MailAliases'
89 .Ds
90 `\-format'
91 .Ds
92 `\-nomime'
93 .Ds
94 `\-nomsgid'
95 .Ds
96 `\-noverbose'
97 .Ds
98 `\-nowatch'
99 .Ds
100 `\-width\ 72'
101 .Ds
102 `\-nofilter'
103 .Co
104 None
105 .Bu
106 \*(lqReply\-To:\*(rq fields are allowed to have groups in them according to the
107 822 specification,
108 but \fIpost\fR won't let you use them.
109 .En