1The Acme Mail program uses upas/fs to parse the mail box, and then
 2presents a file-browser-like user interface to reading and sending
 3messages.  The Mail window presents each numbered message like the
 4contents of a directory presented one per line.  If a message has a
 5Subject: line, that is shown indented on the following line.
 6Multipart MIME-encoded messages are presented in the obvious
 7hierarchical format.
 8
 9Mail uses upas/fs to access the mail box.  By default it reads "mbox",
10the standard user mail box.  If Mail is given an argument, it is
11passed to upas/fs as the name of the mail box (or upas/fs directory)
12to open.
13
14Although Mail works if the plumber is not running, it's designed to be
15run with plumbing enabled and many of its features work best if it is.
16
17The mailbox window has a few commands: Put writes back the mailbox;
18Mail creates a new window in which to compose a message; and Delmesg
19deletes messages by number.  The number may be given as argument or
20indicated by selecting the header line in the mailbox window.
21(Delmesg does not expand null selections, in the interest of safety.)
22
23Clicking the right button on a message number opens it; clicking on
24any of the subparts of a message opens that (and also opens the
25message itself).  Each message window has a few commands in the tag
26with obvious names: Reply, Delmsg, etc.  "Reply" replies to the single
27sender of the message, "Reply all" or "Replyall" replies to everyone
28in the From:, To:, and CC: lines.
29
30Message parts with recognized MIME types such as image/jpeg are sent
31to the plumber for further dispatch.  Acme Mail also listens to
32messages on the seemail and showmail plumbing ports, to report the
33arrival of new messages (highlighting the entry; right-click on the
34entry to open the message) and open them if you right-click on the
35face in the faces window.
36
37When composing a mail message or replying to a message, the first line
38of the text is a list of recipients of the message.  To:, and CC:, and BCC:
39lines are interpreted in the usual way. Two other header lines are
40special to Acme Mail:
41        Include: file places a copy of file in the message as an
42		inline MIME attachment.
43        Attach: file places a copy of file in the message as a regular
44		MIME attachment.
45
46Acme Mail uses these conventions when replying to messages,
47constructing headers for the default behavior.  You may edit these to
48change behavior.  Most important, when replying to a message Mail will
49always Include: the original message; delete that line if you don't
50want to include it.
51
52If the mailbox
53	/mail/box/$user/outgoing
54exists, Acme Mail will save your a copy of your outgoing messages
55there.  Attachments are described in the copy but not included.
56
57The -m mntpoint flag specifies a different mount point for /upas/fs.