Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / doc / mh-mail.me
1 .\"     This file is automatically generated.  Do not edit!
2 .\" @(#)$Id: mh-mail.rf,v 1.6 1992/05/12 22:23:34 jromine Exp $
3 .SC MH-MAIL 5
4 .NA
5 mh-mail \- message format for MH message system
6 .SY
7 any \fIMH\fR command
8 .DE
9 \fIMH\fR processes messages in a particular format.
10 It should be noted that although neither Bell nor Berkeley mailers produce
11 message files in the format that \fIMH\fR prefers,
12 \fIMH\fR can read message files in that antiquated format.
13
14 Each user possesses a mail drop box which initially receives
15 all messages processed by \fIpost\fR\0(8).
16 \fIInc\fR\0(1) will read from that drop box and incorporate the new messages
17 found there into the user's own mail folders (typically `+inbox').
18 The mail drop
19 box consists of one or more messages.
20
21 Messages
22 are expected to consist of lines of text.
23 Graphics and binary data are not handled.
24 No data compression is accepted.
25 All text is clear
26 ASCII 7-bit data.
27
28 The general \*(lqmemo\*(rq framework of RFC\-822 is used.
29 A message consists of a block of information in a rigid format,
30 followed by general text with no specified format.
31 The rigidly formatted first part of a message is called the header,
32 and the free-format portion is called the body.
33 The header must always exist, but the body is optional.
34 These parts are separated by an empty line,
35 i.e., two consecutive newline characters.
36 Within \fIMH\fR,
37 the header and body may be separated by a line consisting of dashes:
38
39 .nf
40 .in +.5i
41 .ne 10
42 .eo
43 .so /opt/mh-6.8.5/lib/components
44 .ec
45 .in -.5i
46 .fi
47
48 The header is composed of one or more header items.
49 Each header item can be viewed as a single logical line of ASCII
50 characters.
51 If the text of a header item extends across several
52 real lines, the continuation lines are indicated by leading
53 spaces or tabs.
54
55 Each header item is called a component and is composed of a
56 keyword or name, along with associated text.
57 The keyword begins at the
58 left margin, may NOT contain spaces or tabs, may not exceed 63
59 characters (as specified by RFC\-822), and is terminated by a colon (`:').
60 Certain
61 components (as identified by their keywords) must follow rigidly
62 defined formats in their text portions.
63
64 The text for most formatted components
65 (e.g., \*(lqDate:\*(rq and \*(lqMessage\-Id:\*(rq)
66 is produced automatically.
67 The only ones entered by the
68 user are address fields such as \*(lqTo:\*(rq, \*(lqcc:\*(rq, etc.
69 Internet addresses
70 are assigned mailbox names and host computer specifications.
71 The
72 rough format is \*(lqlocal@domain\*(rq, such as \*(lqMH@UCI\*(rq,
73 or \*(lqMH@UCI\-ICSA.ARPA\*(rq.
74 Multiple addresses are separated by commas.
75 A missing host/domain is assumed to be the local host/domain.
76
77 As mentioned above,
78 a blank line (or a line of dashes)
79 signals that all following text up to the end of the file is the body.
80 No formatting is expected or enforced within the body.
81
82 Following is a list of header components that are considered
83 meaningful to various MH programs.
84 .in +.5i
85 .ti -.5i
86 Date:
87 .br
88 Added by \fIpost\fR\0(8),
89 contains date and time of the message's entry into the transport system.
90
91 .ti -.5i
92 From:
93 .br
94 Added by \fIpost\fR\0(8),
95 contains the address of the author or authors (may be more than one if a
96 \*(lqSender:\*(rq field is present).
97 Replies are typically directed to addresses in the \*(lqReply\-To:\*(rq or
98 \*(lqFrom:\*(rq field (the former has precedence if present).
99
100 .ti -.5i
101 Sender:
102 .br
103 Added by \fIpost\fR\0(8)
104 in the event that the message already has a \*(lqFrom:\*(rq line.
105 This line contains the address of the actual sender.
106 Replies are never sent to addresses in the \*(lqSender:\*(rq field.
107
108 .ti -.5i
109 To:
110 .br
111 Contains addresses of primary recipients.
112
113 .ti -.5i
114 cc:
115 .br
116 Contains addresses of secondary recipients.
117
118 .ti -.5i
119 Bcc:
120 .br
121 Still more recipients.
122 However, the \*(lqBcc:\*(rq line is not copied onto the message as delivered,
123 so these recipients are not listed.
124 \fIMH\fR uses an encapsulation method for blind copies, see \fIsend\fR\0(1).
125
126 .ti -.5i
127 Fcc:
128 .br
129 Causes \fIpost\fR\0(8) to copy the message into the specified folder for the
130 sender,
131 if the message was successfully given to the transport system.
132
133 .ti -.5i
134 Message\-ID:
135 .br
136 A unique message identifier added by \fIpost\fR\0(8) if the `\-msgid' flag
137 is set.
138
139 .ti -.5i
140 Subject:
141 .br
142 Sender's commentary.  It is displayed by \fIscan\fR\0(1).
143
144 .ti -.5i
145 In\-Reply\-To:
146 .br
147 A commentary line added by \fIrepl\fR\0(1) when replying to a message.
148
149 .ti -.5i
150 Resent\-Date:
151 .br
152 Added when redistributing a message by \fIpost\fR\0(8).
153
154 .ti -.5i
155 Resent\-From:
156 .br
157 Added when redistributing a message by \fIpost\fR\0(8).
158
159 .ti -.5i
160 Resent\-To:
161 .br
162 New recipients for a message resent by \fIdist\fR\0(1).
163
164 .ti -.5i
165 Resent\-cc:
166 .br
167 Still more recipients.
168 See \*(lqcc:\*(rq and \*(lqResent\-To:\*(rq.
169
170 .ti -.5i
171 Resent\-Bcc:
172 .br
173 Even more recipients.
174 See \*(lqBcc:\*(rq and \*(lqResent\-To:\*(rq.
175
176 .ti -.5i
177 Resent\-Fcc:
178 .br
179 Copy resent message into a folder.
180 See \*(lqFcc:\*(rq and \*(lqResent\-To:\*(rq.
181
182 .ti -.5i
183 Resent\-Message\-Id:
184 .br
185 A unique identifier glued on by \fIpost\fR\0(8) if the `\-msgid' flag
186 is set.
187 See \*(lqMessage\-Id:\*(rq and \*(lqResent\-To:\*(rq.
188
189 .ti -.5i
190 Resent:
191 .br
192 Annotation for \fIdist\fR\0(1) under the `\-annotate' option.
193
194 .ti -.5i
195 Forwarded:
196 .br
197 Annotation for \fIforw\fR\0(1) under the `\-annotate' option.
198
199 .ti -.5i
200 Replied:
201 .br
202 Annotation for \fIrepl\fR\0(1) under the `\-annotate' option.
203 .in -.5i
204 .sp
205 .Fi
206 ^/var/spool/mail/$USER~^Location of mail drop
207 .Pr
208 None
209 .Sa
210 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
211 .De
212 None
213 .Co
214 None
215 .En