Added all of the MH sources, including RCS files, in
[mmh] / docs / historical / mh-6.8.5 / miscellany / mhe / mhe.mss
1 @Section(mhe -- a mail management system based on MH)
2 @Index(Mail, sending and receiving)
3 Mhe is an Emacs-based system that is used as a visual front end to the MH
4 mail system. MH is the Rand Mail Handler, which is available under license
5 from the Rand Corporation. Mhe is used as a mail program to send, receive,
6 classify, move, archive, search, and edit mail using the basic MH programs
7 as the underlying mechanism. While mhe can certainly be loaded from any
8 instance of @value(Emacs), the customary usage is to use mhe for a login
9 shell, or else to execute it immediately after login, and then to sit in it
10 all day, using it as both an editor and a mail reader.
11
12 When initially run, mhe presents you with a buffer containing a listing of
13 the headers of the mail messages in your current mail folder; you can then
14 peruse this buffer with all of the usual @value(Emacs) motion and search
15 commands. To delete a message, you position the cursor on the line
16 corresponding to that message and type "D"; to reply to a message, you
17 position the cursor on the line corresponding to it and type "R". All of the
18 basic mail-handling commands in mhe are single-character commands, as
19 follows:
20 @begin(description,spread 0,spacing 1,leftMargin 1 inch,Indent -0.8 inches)
21 n@\move cursor to next line
22
23 p@\move cursor to previous line
24
25 t@\type this message (the message represented by the current line). Pops up
26 a window and shows the message in it. Mhe key bindings are still in effect
27 while the cursor is in that window.
28
29 d@\delete this message. Marks it with a "D", and arranges for it to be
30 deleted when the mhe session is terminated.
31
32 ^@\move this message to another folder. Prompts for its name. Marks it with
33 a "^" and arranges for it to be moved with the mhe session is terminated.
34
35 !@\repeat previous ^ (move) command. Uses same destination folder as
36 previous command, so no prompting is done.
37
38 u@\undelete/unmove: cancel delete or move command for this message. Since
39 the deleting and moving are not performed until mhe exits, those commands
40 can be undone.
41
42 m@\mail a message. Pops up a window whose contents are an empty mail
43 message; you fill in the "To:", "Subject:", and "Cc:" fields as you wish.
44 You can add "Fcc:" fields for file copies, "Bcc:" fields for blind copies,
45 and any other fields that you wish (such as "Reply-to:", etc.). Your
46 standard @value(Emacs) key bindings will be used in this window. When you
47 exit from the recursive edit with @b[^X^C], you will be asked for
48 instructions on handling the message, e.g. quit, send it, go back and edit
49 it some more.
50
51 r@\reply to the current message. Splits the screen, showing the message text
52 in one window and the reply in the other. Quite similar to the "mail"
53 command, except that the "Subject:",  "To:", and "Cc:" fields are filled in
54 for you. You can change them if you want, of course. When you send the
55 reply, the original message will be annotated with a "Replied:" field and
56 the date, and the letter "R" will appear in the header listing.
57
58 f@\forward the current message. Pops up a message composition window, just
59 like the "m" command, except that its initial contents are the contents of
60 the current message. When you send the message, the original that you
61 forwarded will be marked with an annotation showing that it has been
62 forwarded to someone, and the letter "R" will appear in the header listing.
63
64 e@\edit the current message. This command works just like the "type" command
65 described above, except that the keyboard has its "edit" key bindings, so
66 that you can change the message if you want.
67
68 i@\incorporate new mail. If the banner line shows that you have received new
69 mail, you can fetch it with this command. If you are currently working in
70 some folder besides +inbox, and if there is mail, then mhe will switch to
71 folder +inbox before incorporating the mail.
72
73 g@\get a new mail folder. Prompts you for the name of a new folder, and then
74 creates a new header buffer in the name of that folder. The old header
75 buffer is not destroyed, so that you can switch back and forth between them
76 as you see fit.
77
78 b@\get a bboard (bulletin board, otherwise known as newsgroup) folder. Mhe
79 lets you read newsgroup directories just as if they were mail in a mail
80 folder.
81
82 ^X^C@\Exit from Mhe.
83
84 ?@\Pop up a help window. Its topmost few lines give a command summary, and
85 if you scroll it down, various further instructions are given.
86 @end(Description)
87 Whenever the cursor is positioned in a header buffer, the above-mentioned
88 key bindings are in effect. In addition, all of the ^X-prefix key bindings
89 from your profile are left untouched, as are various other standard
90 @value(Emacs) key bindings like @b[ESC-], @b[^S], and so forth.