mh-e: Reading Mail
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 read(1).
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’).
‘: (colon)’
Display message with the default preferred alternative
(‘mh-show-preferred-alternative’).
‘; (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.
Menu
Info Catalog
mh-e: Incorporating Mail
mh-e: Top
mh-e: Folders