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