6 Reading Your Mail
The MH-E entry point for reading mail is M-x mh-rmail. This
command incorporates your mail and creates a buffer called
`+inbox' in MH-Folder mode. The command M-x mh-rmail shows
you only new mail, not mail you have already read1.
There are some commands that need to read mail, such as Mouse-2
over the `Mail' button that display-time adds to the mode
line. You can configure Emacs to have these commands use MH-E by
setting the option read-mail-command to `mh-rmail'.
The `+inbox' buffer contains scan lines, which are one-line
summaries of each incorporated message. You can perform most MH
commands on these messages via one- or two-letter commands in either
the MH-Folder or MH-Show buffers or by using the `Message' menu.
See scan(1) for a description of the contents of the scan
lines, and see the Figure in Reading Mail Tour, for an example.
- ?
- Display cheat sheet for the MH-E commands (
mh-help).
- <RET>
- Display message (
mh-show).
- , (comma)
- Display message with all header fields (
mh-header-display).
- ; (semicolon)
- Toggle the value of
mh-decode-mime-flag
(mh-toggle-mh-decode-mime-flag).
- <SPC>
- Display next page in message (
mh-page-msg).
- <BS>
- Display previous page in message (
mh-previous-page).
- >
- Append message to end of file (
mh-write-msg-to-file).
- |
- Pipe message through shell command (
mh-pipe-msg).
- C-d
- Delete range, don't move to next message
(
mh-delete-msg-no-motion).
- d
- Delete range (
mh-delete-msg).
- D ?
- Display cheat sheet for the commands of the current prefix in
minibuffer (
mh-prefix-help).
- D <SPC>
- Display next message in digest (
mh-page-digest).
- D <BS>
- Display previous message in digest (
mh-page-digest-backwards).
- D b
- Break up digest into separate messages (
mh-burst-digest).
- g
- Go to a message (
mh-goto-msg).
- k
- Delete messages with same subject or thread
(
mh-delete-subject-or-thread).
- K ?
- Display cheat sheet for the commands of the current prefix in
minibuffer (
mh-prefix-help).
- K <TAB>
- Go to the next button (
mh-next-button).
- K S-<TAB>
- Go to the previous button (
mh-prev-button).
- K a
- Save attachments (
mh-mime-save-parts).
- K e
- View attachment externally (
mh-display-with-external-viewer).
- K i
- Show attachment verbatim (
mh-folder-inline-mime-part).
- K o
- Save (output) attachment (
mh-folder-save-mime-part).
- K t
- Toggle option
mh-display-buttons-for-inline-parts-flag
(mh-toggle-mime-buttons).
- K v
- View attachment (
mh-folder-toggle-mime-part).
- M
- Edit message (
mh-modify).
- M-<
- Display first message (
mh-first-msg).
- M->
- Display last message (
mh-last-msg).
- M-n
- Display next unread message (
mh-next-unread-msg).
- M-p
- Display previous unread message (
mh-previous-unread-msg).
- n
- Display next message (
mh-next-undeleted-msg).
- p
- Display previous message (
mh-previous-undeleted-msg).
- P ?
- Display cheat sheet for the commands of the current prefix in
minibuffer (
mh-prefix-help).
- P C
- Toggle whether color is used in printing messages
(
mh-ps-print-toggle-color).
- P F
- Toggle whether printing is done with faces or not
(
mh-ps-print-toggle-faces).
- P f
- Print range to file (
mh-ps-print-msg-file).
- P l
- Print range the old fashioned way
(
mh-print-msg).
- P p
- Print range (
mh-ps-print-msg).
- X ?
- Display cheat sheet for the commands of the current prefix in
minibuffer (
mh-prefix-help).
- X s
- X u
- Unpack message created with uudecode or shar
(
mh-store-msg).
- Mouse-2
- Move point to mouse event and show message (
mh-show-mouse).
Within the MH-Show buffer, the following command is defined.
- <RET>
- Mouse-1
- Mouse-2
- View contents of button (
mh-press-button).
The following table lists options in the `mh-show' customization
group that are used while reading mail.
mh-bury-show-buffer-flag- On means show buffer is buried (default: `on').
mh-clean-message-header-flag- On means remove extraneous header fields (default: `on').
mh-decode-mime-flag- On means attachments are handled (default: `on' if the Gnus
`mm-decode' package is present).
mh-display-buttons-for-alternatives-flag- On means display buttons for all alternative attachments (default:
`off').
mh-display-buttons-for-inline-parts-flag- On means display buttons for all inline attachments (default:
`off').
mh-do-not-confirm-flag- On means non-reversible commands do not prompt for confirmation
(default: `off').
mh-fetch-x-image-url- Control fetching of `X-Image-URL:' header field image (default:
`Never Fetch').
mh-graphical-smileys-flag- On means graphical smileys are displayed (default: `on').
mh-graphical-emphasis-flag- On means graphical emphasis is displayed (default: `on').
mh-highlight-citation-style- Style for highlighting citations (default: `Multicolor').
mh-invisible-header-fields-default- List of hidden header fields (default: a checklist too long to list
here).
mh-invisible-header-fields- Additional header fields to hide (default:
nil).
mh-lpr-command-format- Command used to print (default:
"lpr -J '%s'").
mh-max-inline-image-height- Maximum inline image height if `Content-Disposition:' is not
present (default: 0).
mh-max-inline-image-width- Maximum inline image width if `Content-Disposition:' is not
present(default: 0).
mh-mhl-format-file- Specifies the format file to pass to the mhl program
(default: `Use Default mhl Format (Printing Only)').
mh-mime-save-parts-default-directory- Default directory to use for K a.
mh-print-background-flag- On means messages should be printed in the background (default:
`off').
mh-show-buffer-mode-line-buffer-id- Format string to produce
mode-line-buffer-identification for
show buffers (default: " {show-%s} %d").
mh-show-maximum-size- Maximum size of message (in bytes) to display automatically (default:
0).
mh-show-use-xface-flag- On means display face images in MH-Show buffers (default: `on').
mh-store-default-directory- Default directory for X s (default: `Current').
mh-summary-height- Number of lines in MH-Folder buffer (including the mode line)
(default: depends on size of frame).
The following hooks are available.
mh-delete-msg-hook- Hook run after marking each message for deletion (default:
nil).
mh-show-hook- Hook run after <RET> shows a message (default:
nil).
mh-show-mode-hook- Hook run upon entry to
mh-show-mode (default: nil).
The following faces are available.
mh-show-cc- Face used to highlight `cc:' header fields.
mh-show-date- Face used to highlight `Date:' header fields.
mh-show-from- Face used to highlight `From:' header fields.
mh-show-header- Face used to deemphasize less interesting header fields.
mh-show-pgg-bad- Bad PGG signature face.
mh-show-pgg-good- Good PGG signature face.
mh-show-pgg-unknown- Unknown or untrusted PGG signature face.
mh-show-signature- Signature face.
mh-show-subject- Face used to highlight `Subject:' header fields.
mh-show-to- Face used to highlight `To:' header fields.
mh-show-xface- X-Face image face.
The functions and variables introduced here are explained in more
detail in the following sections.