File: mh-e.el.html
MH-E is an Emacs interface to the MH mail system.
To learn about MH-E, read The MH-E Manual at info node (mh-e).
MH-E is compatible with MH versions 6.8.4 and higher, all versions of nmh, and GNU mailutils 1.0 and higher.
MH (Message Handler) is a powerful mail reader. See https://rand-mh.sourceforge.io/.
N.B. MH must have been compiled with the MHE compiler flag or several features necessary for MH-E will be missing from MH commands, specifically the -build switch to repl and forw.
How to use:
M-x mh-rmail to read mail. Type C-h m there for a list of commands.
C-u M-x mh-rmail to visit any folder.
M-x mh-smail to send mail. From within the mail reader, "s" works, too.
Your .emacs might benefit from these bindings:
(keymap-global-set "C-c r" #'mh-rmail)
(keymap-global-set "C-x m" #'mh-smail)
(keymap-global-set "C-x 4 m" #'mh-smail-other-window)
Mailing Lists:
mh-e-users@lists.sourceforge.net
mh-e-announce@lists.sourceforge.net
mh-e-devel@lists.sourceforge.net
Subscribe by sending a "subscribe" message to
<list>-request@lists.sourceforge.net, or by using the web interface at
https://sourceforge.net/mail/?group_id=13357
Bug Reports:
https://sourceforge.net/tracker/?group_id=13357&atid=113357
Include the output of M-x mh-version in the bug report unless
you're 110% sure we won't ask for it.
Feature Requests:
https://sourceforge.net/tracker/?group_id=13357&atid=363357
Support:
https://sourceforge.net/tracker/?group_id=13357&atid=213357
Defined variables (166)
mh-adaptive-cmd-note-flag | Non-nil means that the message number width is determined dynamically. |
mh-after-commands-processed-hook | Hook run by x after performing outstanding refile and delete requests. |
mh-alias-completion-ignore-case-flag | Non-nil means don’t consider case significant in MH alias completion. |
mh-alias-expand-aliases-flag | Non-nil means to expand aliases entered in the minibuffer. |
mh-alias-flash-on-comma | Specify whether to flash address or warn on translation. |
mh-alias-insert-file | Filename used to store a new MH-E alias. |
mh-alias-insertion-location | Specifies where new aliases are entered in alias files. |
mh-alias-local-users | Non-nil means local users are added to alias completion. |
mh-alias-local-users-prefix | String prefixed to the real names of users from the password file. |
mh-alias-passwd-gecos-comma-separator-flag | Non-nil means the gecos field in the password file uses a comma separator. |
mh-alias-reloaded-hook | Hook run by ‘mh-alias-reload’ after loading aliases. |
mh-allowlist | List of messages to use to train the junk filter. |
mh-allowlist-msg-hook | Hook run by M-x mh-junk-allowlist after marking each message for allowlisting. |
mh-allowlist-preserves-sequences-flag | Non-nil means that sequences are preserved when messages are allowlisted. |
mh-annotate-msg-hook | Hook run when a message is sent and after annotating the scan lines and message. |
mh-arrow-marker | Marker for arrow display in fringe. |
mh-auto-fields-list | List of recipients for which header lines are automatically inserted. |
mh-auto-fields-prompt-flag | Non-nil means to prompt before sending if fields inserted. |
mh-before-commands-processed-hook | Hook run by x before performing outstanding refile and delete requests. |
mh-before-quit-hook | Hook run by q before quitting MH-E. |
mh-before-send-letter-hook | Hook run at the beginning of the C-c C-c command. |
mh-blocklist | List of messages to use to train the junk filter. |
mh-blocklist-msg-hook | Hook run by M-x mh-junk-blocklist after marking each message for blocklisting. |
mh-bury-show-buffer-flag | Non-nil means show buffer is buried. |
mh-clean-message-header-flag | Non-nil means remove extraneous header fields. |
mh-colors-available-flag | Non-nil means colors are available. |
mh-compose-forward-as-mime-flag | Non-nil means that messages are forwarded as attachments. |
mh-compose-insertion | Type of tags used when composing MIME messages. |
mh-compose-letter-function | Invoked when starting a new draft. |
mh-compose-prompt-flag | Non-nil means prompt for header fields when composing a new draft. |
mh-compose-skipped-header-fields | List of header fields to skip over when navigating in draft. |
mh-compose-space-does-completion-flag | Non-nil means SPC does completion in message header. |
mh-current-folder | Name of current folder, a string. |
mh-decode-mime-flag | Non-nil means attachments are handled. |
mh-default-directory | Default directory for MH-E folder buffers. |
mh-default-folder-for-message-function | Function to select a default folder for refiling or "Fcc:". |
mh-default-folder-list | List of addresses and folders. |
mh-default-folder-must-exist-flag | Non-nil means guessed folder name must exist to be used. |
mh-default-folder-prefix | Prefix used for folder names generated from aliases. |
mh-delete-list | List of message numbers to delete. |
mh-delete-msg-hook | Hook run by M-x mh-delete-msg after marking each message for deletion. |
mh-delete-yanked-msg-window-flag | Non-nil means delete any window displaying the message. |
mh-display-buttons-for-alternatives-flag | Non-nil means display buttons for all alternative attachments. |
mh-display-buttons-for-inline-parts-flag | Non-nil means display buttons for all inline attachments. |
mh-do-not-confirm-flag | Non-nil means non-reversible commands do not prompt for confirmation. |
mh-draft-folder | Cached value of the "Draft-Folder:" MH profile component. |
mh-extract-from-attribution-verb | Verb to use for attribution when a message is yanked by C-c C-y. |
mh-face-data | MH-E face data. |
mh-fetch-x-image-url | Control fetching of "X-Image-URL:" header field image. |
mh-find-path-hook | Hook run by ‘mh-find-path’ after reading the user’s MH profile. |
mh-flists-present-flag | Non-nil means that we have "flists". |
mh-folder-seq-tool-bar-map | Keymap for MH-Folder tool bar. |
mh-folder-tool-bar-map | Keymap for MH-Folder tool bar. |
mh-folder-view-stack | Stack of previous folder views. |
mh-folders-changed | Lists which folders were affected by deletes and refiles. |
mh-forward-hook | Hook run by ‘mh-forward’ on a forwarded letter. |
mh-forward-subject-format | Format string for forwarded message subject. |
mh-globals-hash | Keeps track of MIME data on a per buffer basis. |
mh-graphical-emphasis-flag | Non-nil means graphical emphasis is displayed. |
mh-graphical-smileys-flag | Non-nil means graphical smileys are displayed. |
mh-highlight-citation-style | Style for highlighting citations. |
mh-identity-default | Default identity to use when ‘mh-letter-mode’ is called. |
mh-identity-handlers | Handler functions for fields in ‘mh-identity-list’. |
mh-identity-list | List of identities. |
mh-inbox | Cached value of the "Inbox:" MH profile component. |
mh-inc-folder-hook | Hook run by i after incorporating mail into a folder. |
mh-inc-prog | Program to incorporate new mail into a folder. |
mh-inc-spool-list | Alternate spool files. |
mh-inc-spool-map | Keymap for MH-E’s mh-inc-spool commands. |
mh-index-data | Info about index search results. |
mh-index-data-file | MH-E specific file where index search info is stored. |
mh-index-max-cmdline-args | Maximum number of command line args. |
mh-inherit-face-flag | Non-nil means that the ‘defface’ :inherit keyword is available. |
mh-ins-buf-prefix | String to put before each line of a yanked or inserted message. |
mh-insert-signature-hook | Hook run by C-c C-s after signature has been inserted. |
mh-insert-x-mailer-flag | Non-nil means append an "X-Mailer:" header field to the header. |
mh-interpret-number-as-range-flag | Non-nil means interpret a number as a range. |
mh-invisible-header-fields | Additional header fields to hide. |
mh-invisible-header-fields-compiled | Regexp matching lines in a message header that are not to be shown. |
mh-invisible-header-fields-default | List of hidden header fields. |
mh-invisible-header-fields-internal | List of default header fields that are not to be shown. |
mh-junk-background | If on, spam programs are run in background. |
mh-junk-choice | Chosen spam fighting program. |
mh-junk-disposition | Disposition of junk mail. |
mh-junk-function-alist | Available choices of spam programs to use. |
mh-junk-program | Spam program that MH-E should use. |
mh-kill-folder-suppress-prompt-functions | Abnormal hook run at the beginning of F k. |
mh-large-folder | The number of messages that indicates a large folder. |
mh-letter-complete-function | Function to call when completing outside of address or folder fields. |
mh-letter-fill-column | Fill column to use in MH Letter mode. |
mh-letter-tool-bar-map | Keymap for MH-Letter tool bar. |
mh-lib | Directory containing the MH library. |
mh-lib-progs | Directory containing MH helper programs. |
mh-lpr-command-format | Command used to print. |
mh-mail-header-separator | Line used by MH to separate headers from text in messages being composed. |
mh-max-inline-image-height | Maximum inline image height if "Content-Disposition:" is not present. |
mh-max-inline-image-width | Maximum inline image width if "Content-Disposition:" is not present. |
mh-mh-to-mime-hook | Hook run on the formatted letter by C-c C-e. |
mh-mhl-format-file | Specifies the format file to pass to the "mhl" program. |
mh-mime-save-parts-default-directory | Default directory to use for K a. |
mh-min-colors-defined-flag | Non-nil means ‘defface’ supports min-colors display requirement. |
mh-mml-method-default | Default method to use in security tags. |
mh-mode-line-annotation | Message range displayed in buffer. |
mh-new-messages-folders | Folders searched for the "unseen" sequence. |
mh-next-direction | Direction to move to next message. |
mh-pack-folder-hook | Hook run by F p after renumbering the messages. |
mh-page-to-next-msg-flag | Non-nil means next SPC or whatever goes to next undeleted message. |
mh-path | Additional list of directories to search for MH. |
mh-pgp-support-flag | Non-nil means PGP support is available. |
mh-previous-seq | Cached value of the "Previous-Sequence:" MH profile component. |
mh-previous-window-config | Window configuration before MH-E command. |
mh-print-background-flag | Non-nil means messages should be printed in the background. |
mh-progs | Directory containing MH commands, such as inc, repl, and rmm. |
mh-quit-hook | Hook run by q after quitting MH-E. |
mh-recenter-summary-flag | Non-nil means to recenter the summary window. |
mh-recursive-folders-flag | Non-nil means that commands which operate on folders do so recursively. |
mh-redist-full-contents-flag | Non-nil means the "dist" command needs entire letter for redistribution. |
mh-refile-list | List of folder names in ‘mh-seq-list’. |
mh-refile-msg-hook | Hook run by o after marking each message for refiling. |
mh-refile-preserves-sequences-flag | Non-nil means that sequences are preserved when messages are refiled. |
mh-reply-default-reply-to | Sets the person or persons to whom a reply will be sent. |
mh-reply-show-message-flag | Non-nil means the MH-Show buffer is displayed when replying. |
mh-scan-format-file | Specifies the format file to pass to the scan program. |
mh-scan-prog | Program used to scan messages. |
mh-search-program | Search program that MH-E shall use. |
mh-seen-list | List of displayed messages to be removed from the "Unseen" sequence. |
mh-sent-from-folder | Folder of msg assoc with this letter. |
mh-sent-from-msg | Number of msg assoc with this letter. |
mh-seq-list | Alist of this folder’s sequences. |
mh-sequence-notation-history | Remember original notation that is overwritten by ‘mh-note-seq’. |
mh-show-buffer | Buffer that displays message for this folder. |
mh-show-folder-buffer | Keeps track of folder whose message is being displayed. |
mh-show-hook | Hook run after RET shows a message. |
mh-show-maximum-size | Maximum size of message (in bytes) to display automatically. |
mh-show-seq-tool-bar-map | Keymap for MH-Show tool bar. |
mh-show-threads-flag | Non-nil means new folders start in threaded mode. |
mh-show-tool-bar-map | Keymap for MH-Show tool bar. |
mh-show-use-xface-flag | Non-nil means display face images in MH-show buffers. |
mh-showing-mode | Non-nil if Mh-Showing mode is enabled. |
mh-showing-mode-hook | Hook run after entering or leaving ‘mh-showing-mode’. |
mh-signature-file-name | Source of user’s signature. |
mh-signature-separator | Text of a signature separator. |
mh-signature-separator-flag | Non-nil means a signature separator should be inserted. |
mh-signature-separator-regexp | This regular expression matches the signature separator. |
mh-sortm-args | Additional arguments for "sortm". |
mh-speed-update-interval | Time between speedbar updates in seconds. |
mh-store-default-directory | Default directory for X u. |
mh-summary-height | Number of lines in MH-Folder buffer (including the mode line). |
mh-sys-path | List of directories to search for variants of the MH variant. |
mh-thread-scan-line-map | Map of message index to various parts of the scan line. |
mh-thread-scan-line-map-stack | Old map of message index to various parts of the scan line. |
mh-tick-seq | The name of the MH sequence for ticked messages. |
mh-ticked-messages-folders | Folders searched for ‘mh-tick-seq’. |
mh-tool-bar-search-function | Function called by the tool bar search button. |
mh-unseen-seq | Cached value of the "Unseen-Sequence:" MH profile component. |
mh-unseen-updated-hook | Hook run after the unseen sequence has been updated. |
mh-update-sequences-after-mh-show-flag | Non-nil means flush MH sequences to disk after message is shown. |
mh-user-path | Cached value of the "Path:" MH profile component. |
mh-variant | Specifies the variant used by MH-E. |
mh-variant-in-use | The MH variant currently in use; a string with variant and version number. |
mh-variants | List describing known MH variants. |
mh-version | Version number of MH-E. |
mh-view-ops | Stack of operations that change the folder view. |
mh-x-face-file | File containing face header field to insert in outgoing mail. |
mh-x-mailer-string | String containing the contents of the X-Mailer header field. |
mh-yank-behavior | Controls which part of a message is yanked by C-c C-y. |
Defined functions (40)
Defined faces (31)
mh-folder-address | Recipient face. |
mh-folder-allowlisted | Allowlisted message face. |
mh-folder-blocklisted | Blocklisted message face. |
mh-folder-body | Body text face. |
mh-folder-cur-msg-number | Current message number face. |
mh-folder-date | Date face. |
mh-folder-deleted | Deleted message face. |
mh-folder-followup | "Re:" face. |
mh-folder-msg-number | Message number face. |
mh-folder-refiled | Refiled message face. |
mh-folder-sent-to-me-hint | Fontification hint face in messages sent directly to us. The detection of messages sent to us is governed by the scan format ‘mh-scan-format-nmh’ and the regular expression ‘mh-scan-sent-to-me-sender-regexp’. |
mh-folder-sent-to-me-sender | Sender face in messages sent directly to us. The detection of messages sent to us is governed by the scan format ‘mh-scan-format-nmh’ and the regular expression ‘mh-scan-sent-to-me-sender-regexp’. |
mh-folder-subject | Subject face. |
mh-folder-tick | Ticked message face. |
mh-folder-to | "To:" face. |
mh-letter-header-field | Editable header field value face in draft buffers. |
mh-search-folder | Folder heading face in MH-Folder buffers created by searches. |
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-speedbar-folder | Basic folder face. |
mh-speedbar-folder-with-unseen-messages | Folder face when folder contains unread messages. |
mh-speedbar-selected-folder | Selected folder face. |
mh-speedbar-selected-folder-with-unseen-messages | Selected folder face when folder contains unread messages. |