Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / conf / doc / RCS / mh-mail.rf,v
1 head    1.6;
2 access;
3 symbols;
4 locks; strict;
5
6
7 1.6
8 date    92.05.12.22.23.34;      author jromine; state Exp;
9 branches;
10 next    1.5;
11
12 1.5
13 date    90.04.05.15.13.12;      author sources; state Exp;
14 branches;
15 next    1.4;
16
17 1.4
18 date    90.03.22.11.31.18;      author sources; state Exp;
19 branches;
20 next    1.3;
21
22 1.3
23 date    90.03.20.19.41.56;      author sources; state Exp;
24 branches;
25 next    1.2;
26
27 1.2
28 date    90.03.20.17.36.12;      author sources; state Exp;
29 branches;
30 next    1.1;
31
32 1.1
33 date    90.03.20.17.20.56;      author sources; state Exp;
34 branches;
35 next    ;
36
37
38 desc
39 @@
40
41
42 1.6
43 log
44 @fixup for nroff problems
45 @
46 text
47 @.\"    @@(MHWARNING)
48 .\" @@(#)$Id: mh-mail.rf,v 1.5 1990/04/05 15:13:12 sources Exp jromine $
49 .SC MH-MAIL 5
50 .NA
51 mh-mail \- message format for MH message system
52 .SY
53 any \fIMH\fR command
54 .DE
55 \fIMH\fR processes messages in a particular format.
56 It should be noted that although neither Bell nor Berkeley mailers produce
57 message files in the format that \fIMH\fR prefers,
58 \fIMH\fR can read message files in that antiquated format.
59
60 Each user possesses a mail drop box which initially receives
61 all messages processed by \fIpost\fR\0(8).
62 \fIInc\fR\0(1) will read from that drop box and incorporate the new messages
63 found there into the user's own mail folders (typically `+inbox').
64 The mail drop
65 box consists of one or more messages.
66 @@BEGIN: MMDFMTS
67 To facilitate the
68 separation of messages, each message begins and ends with
69 a line consisting of nothing but four CTRL\-A (octal 001)
70 characters.
71 @@END: MMDFMTS
72 @@BEGIN: MHMTS
73 To facilitate the
74 separation of messages, each message begins and ends with
75 a line consisting of nothing but four CTRL\-A (octal 001)
76 characters.
77 @@END: MHMTS
78
79 Messages
80 are expected to consist of lines of text.
81 Graphics and binary data are not handled.
82 No data compression is accepted.
83 All text is clear
84 ASCII 7-bit data.
85
86 The general \*(lqmemo\*(rq framework of RFC\-822 is used.
87 A message consists of a block of information in a rigid format,
88 followed by general text with no specified format.
89 The rigidly formatted first part of a message is called the header,
90 and the free-format portion is called the body.
91 The header must always exist, but the body is optional.
92 These parts are separated by an empty line,
93 i.e., two consecutive newline characters.
94 Within \fIMH\fR,
95 the header and body may be separated by a line consisting of dashes:
96
97 .nf
98 .in +.5i
99 .ne 10
100 .eo
101 .so @@(MHETCPATH)/components
102 .ec
103 .in -.5i
104 .fi
105
106 The header is composed of one or more header items.
107 Each header item can be viewed as a single logical line of ASCII
108 characters.
109 If the text of a header item extends across several
110 real lines, the continuation lines are indicated by leading
111 spaces or tabs.
112
113 Each header item is called a component and is composed of a
114 keyword or name, along with associated text.
115 The keyword begins at the
116 left margin, may NOT contain spaces or tabs, may not exceed 63
117 characters (as specified by RFC\-822), and is terminated by a colon (`:').
118 Certain
119 components (as identified by their keywords) must follow rigidly
120 defined formats in their text portions.
121
122 The text for most formatted components
123 (e.g., \*(lqDate:\*(rq and \*(lqMessage\-Id:\*(rq)
124 is produced automatically.
125 The only ones entered by the
126 user are address fields such as \*(lqTo:\*(rq, \*(lqcc:\*(rq, etc.
127 Internet addresses
128 are assigned mailbox names and host computer specifications.
129 The
130 rough format is \*(lqlocal@@domain\*(rq, such as \*(lqMH@@UCI\*(rq,
131 or \*(lqMH@@UCI\-ICSA.ARPA\*(rq.
132 Multiple addresses are separated by commas.
133 A missing host/domain is assumed to be the local host/domain.
134
135 As mentioned above,
136 a blank line (or a line of dashes)
137 signals that all following text up to the end of the file is the body.
138 No formatting is expected or enforced within the body.
139
140 Following is a list of header components that are considered
141 meaningful to various MH programs.
142 .in +.5i
143 .ti -.5i
144 Date:
145 .br
146 Added by \fIpost\fR\0(8),
147 contains date and time of the message's entry into the transport system.
148
149 .ti -.5i
150 From:
151 .br
152 Added by \fIpost\fR\0(8),
153 contains the address of the author or authors (may be more than one if a
154 \*(lqSender:\*(rq field is present).
155 Replies are typically directed to addresses in the \*(lqReply\-To:\*(rq or
156 \*(lqFrom:\*(rq field (the former has precedence if present).
157
158 .ti -.5i
159 Sender:
160 .br
161 Added by \fIpost\fR\0(8)
162 in the event that the message already has a \*(lqFrom:\*(rq line.
163 This line contains the address of the actual sender.
164 Replies are never sent to addresses in the \*(lqSender:\*(rq field.
165
166 .ti -.5i
167 To:
168 .br
169 Contains addresses of primary recipients.
170
171 .ti -.5i
172 cc:
173 .br
174 Contains addresses of secondary recipients.
175
176 .ti -.5i
177 Bcc:
178 .br
179 Still more recipients.
180 However, the \*(lqBcc:\*(rq line is not copied onto the message as delivered,
181 so these recipients are not listed.
182 \fIMH\fR uses an encapsulation method for blind copies, see \fIsend\fR\0(1).
183
184 .ti -.5i
185 Fcc:
186 .br
187 Causes \fIpost\fR\0(8) to copy the message into the specified folder for the
188 sender,
189 if the message was successfully given to the transport system.
190
191 .ti -.5i
192 Message\-ID:
193 .br
194 A unique message identifier added by \fIpost\fR\0(8) if the `\-msgid' flag
195 is set.
196
197 .ti -.5i
198 Subject:
199 .br
200 Sender's commentary.  It is displayed by \fIscan\fR\0(1).
201
202 .ti -.5i
203 In\-Reply\-To:
204 .br
205 A commentary line added by \fIrepl\fR\0(1) when replying to a message.
206
207 .ti -.5i
208 Resent\-Date:
209 .br
210 Added when redistributing a message by \fIpost\fR\0(8).
211
212 .ti -.5i
213 Resent\-From:
214 .br
215 Added when redistributing a message by \fIpost\fR\0(8).
216
217 .ti -.5i
218 Resent\-To:
219 .br
220 New recipients for a message resent by \fIdist\fR\0(1).
221
222 .ti -.5i
223 Resent\-cc:
224 .br
225 Still more recipients.
226 See \*(lqcc:\*(rq and \*(lqResent\-To:\*(rq.
227
228 .ti -.5i
229 Resent\-Bcc:
230 .br
231 Even more recipients.
232 See \*(lqBcc:\*(rq and \*(lqResent\-To:\*(rq.
233
234 .ti -.5i
235 Resent\-Fcc:
236 .br
237 Copy resent message into a folder.
238 See \*(lqFcc:\*(rq and \*(lqResent\-To:\*(rq.
239
240 .ti -.5i
241 Resent\-Message\-Id:
242 .br
243 A unique identifier glued on by \fIpost\fR\0(8) if the `\-msgid' flag
244 is set.
245 See \*(lqMessage\-Id:\*(rq and \*(lqResent\-To:\*(rq.
246
247 .ti -.5i
248 Resent:
249 .br
250 Annotation for \fIdist\fR\0(1) under the `\-annotate' option.
251
252 .ti -.5i
253 Forwarded:
254 .br
255 Annotation for \fIforw\fR\0(1) under the `\-annotate' option.
256
257 .ti -.5i
258 Replied:
259 .br
260 Annotation for \fIrepl\fR\0(1) under the `\-annotate' option.
261 .in -.5i
262 .sp
263 .Fi
264 ^@@(MHDROPLOC)~^Location of mail drop
265 .Pr
266 None
267 .Sa
268 \fIStandard for the Format of ARPA Internet Text Messages\fR (aka RFC\-822)
269 .De
270 None
271 .Co
272 None
273 .En
274 @
275
276
277 1.5
278 log
279 @add ID
280 @
281 text
282 @d2 2
283 a3 2
284 .\" @@(#)$Id:$
285 .SC MH\-MAIL 5
286 d5 1
287 a5 1
288 mh\-mail \- message format for MH message system
289 @
290
291
292 1.4
293 log
294 @put things back, do .NA stuff another way
295 @
296 text
297 @d2 1
298 @
299
300
301 1.3
302 log
303 @typo
304 @
305 text
306 @d2 2
307 a3 2
308 .TH MH\-MAIL 5 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
309 .SH .NA
310 d5 1
311 a5 1
312 .SH .SY
313 @
314
315
316 1.2
317 log
318 @fixup for makewhatis
319 @
320 text
321 @d2 1
322 a2 1
323 .TH MH\-MAIL 5 [mh.6] MH
324 @
325
326
327 1.1
328 log
329 @Initial revision
330 @
331 text
332 @d2 2
333 a3 2
334 .SC MH\-MAIL 5
335 .NA
336 d5 1
337 a5 1
338 .SY
339 @