acme/mail/readme

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