Copyright (C) 2003-2006, 2008, 2009, 2011, 2012 Free Software Foundation, Inc.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
* Changes in MH-E 8.4
Version 8.4 postpones junk processing and merges in your components
file when re-editing a draft. A few bugs were also fixed.
** New Features in MH-E 8.4
*** Postpone junk processing
The `J w' (`mh-junk-whitelist') and `J b' (`mh-junk-blacklist')
commands now mark the message. Like with other marks, this mark can be
removed with `u' (`mh-undo') and processed with `x'
(`mh-execute-commands'). Thanks to Ted Phelps (closes SF #2945712).
** New Variables in MH-E 8.4
Hook run by `J b' (`mh-junk-blacklist') after marking each message for blacklisting.
Hook run by `J w' (`mh-junk-whitelist') after marking each message for whitelisting.
Non-nil means that sequences are preserved when messages are
** New Faces in MH-E 8.4
Blacklisted message face.
Whitelisted message face.
** Bug Fixes in MH-E 8.4
*** mh-edit-again should add Fcc
More generally, `mh-edit-again' now merges the components file into
the draft (closes SF #1708292).
*** Loses changes when message column goes from 1 to 2 digits
Call `mh-process-or-undo-commands' before running inc to insure we do
not lose any pending changes (closes SF #2321115).
*** mh-yank-cur-msg fails in emacs 23
Replace usage of `set-buffer' with `with-current-buffer' (closes SF
*** Folder pack action (Fp) missing in show mode
Add missing key binding for `mh-show-pack-folder' (closes SF #3466086).
Thank you for using MH-E 8.4, the newest release of the GNU Emacs
front end for MH. This file contains installation directions; the
release notes contain important information regarding this release. We
encourage you to read these documents before using the software. The
release notes for all versions are packaged with MH-E in a file called
Emacs comes prepackaged with MH-E; the files in this package may be
more recent however. To ascertain the version of MH-E in your version
of Emacs and to determine whether it is necessary to install these
files, run the command `M-x mh-version' within Emacs. If this package
contains a more recent version of MH-E, read on.
MH-E is built into Emacs, so if you check out the Emacs source, then
you have no need of this release. You are already running the bleeding
This version of MH-E will appear in GNU Emacs 24.4 (unless MH-E is
superseded by a newer version before Emacs is released). It is
supported in GNU Emacs 23 and higher, as well as XEmacs 21.4.22
and 21.5.31. MH-E is known not to work with GNU Emacs versions 20 and
below, and XEmacs version 21.5.9 - 21.5.16. It is compatible with MH
versions 6.8.4 and higher, all versions of nmh, and GNU mailutils 1.0
and higher. Gnus is also required; version 5.10 or higher is
** Extract the tarball.
If you don't have GNU tar, use gzip to uncompress the tarball and drop
the `z' option.
tar xzf mh-e-8.4.tgz
It is suggested, but not required, to compile MH-E. To do so, run
`make' in the distribution directory:
If you run Emacs by any name other than `emacs', use the following
For example, Mac users might have to use something like:
If `M-x mh-version' shows that your compile- and run-time versions of
Gnus are different, then it is likely that you compiled with the wrong
version of Emacs.
Note that the Makefile assumes an XEmacs variant if `xemacs' appears
somewhere in the command name. Otherwise, it is assumed that GNU Emacs
is being used.
** Place these files in your load path.
Add something like the following to your .emacs:
(add-to-list 'load-path (expand-file-name "~/mh-e-8.4/emacs/trunk/lisp/mh-e"))
XEmacs users will also have to add this as well:
(add-to-list 'load-path (expand-file-name "~/mh-e-8.4"))
** Enable the entry points into MH-E as autoloads.
The MH-E entry points are predefined in Emacs 22 and higher. If you
are using Emacs 21, which contains old autoload definitions,
you *must* add the following to your .emacs to get the updated
If you want to customize MH-E before explicitly loading it, you may
optionally add the following to your .emacs as well:
** Read the commentary at the top of mh-e.el.
** Read the release notes in MH-E-NEWS.
This is particularly important if you're already using MH-E and the
major version number has changed. We don't bump major version numbers
in MH-E for marketing reasons; it always means incompatible
improvements were made.
* BAZAAR MH-E INSTALL
After checking out the src module, you must run `make emacs' or just
`make' to check out Emacs, which includes MH-E proper, from Savannah.
Then follow the steps that apply to you in INSTALL above.
Developers should run `make emacs-devel' which checks out Emacs using
the $USER environment variable as their Savannah login.
* ADDITIONAL INFORMATION
Documentation comes in the form of a manual which comes in the
The info pages can be found by running the following command within
C-h i m mh-e RET
If the version of the manual that you get doesn't match this version
of MH-E, download the latest version of the manual. See below.
*** HTML & PDF
An online version of the documentation is available here:
The source for the documentation can be obtained here:
With the source, you can build the Info pages, HTML, and PDF.
** Mailing Lists, Bug Reports and Other Support
Please read the commentary at the top of `mh-e.el'. Visit
paragraph-separate: "[ ]*$"