* COPYRIGHT

Copyright (C) 2003, 2004 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.

* INTRODUCTION

Thank you for using MH-E 7.82, 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
MH-E-NEWS.

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.

This version of MH-E will appear in GNU Emacs 21.4 (unless MH-E is
superseded by a newer version). It is supported in GNU Emacs 20.7 and
21, as well as XEmacs 21 (except for versions 21.5.9-21.5.16). It is
compatible with MH versions 6.8.4 and higher, all versions of nmh, and
GNU mailutils 0.4 and higher.


* INSTALL

** 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-7.82.tgz

** Compile.

It is suggested, but not required, to compile MH-E. To do so, run
`make' in the distribution directory:

	cd mh-e-7.82
	make

If you run Emacs by any name other than `emacs', use the following
instead:

	cd mh-e-7.82
	make EMACS=myemacs

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.

You may simply place the files in a directory that is already in your
load path, or you could add something like the following to your
.emacs:

	(add-to-list 'load-path (expand-file-name "~/mh-e-7.82"))

** Enable the entry points into MH-E as autoloads.

You may create the file `mh-e-autoloads.el' which contains the autoloads
for usual entry point commands into MH-E using `make' in the distribution
directory:

	cd mh-e-7.82
	make mh-e-autoloads.el

Ensure this file is in your load-path; if this MH-E directory is in
your load-path, it already is. Add the following to your .emacs:

	(require 'mh-e-autoloads)

** 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.


* ADDITIONAL INFORMATION

** Documentation

Documentation comes in the form of a manual which comes in the
following forms:

*** info

The info pages can be found by running the following command within
Emacs:

	C-h i m mh-e RET

*** HTML

An online version of the documentation is available here:

	http://www.ics.uci.edu/~mh/book/mh-e/

*** Source

The source for the documentation can be obtained here:

	https://sourceforge.net/project/showfiles.php?group_id=13357

** Mailing Lists, Bug Reports and other Support

Please read the commentary at the top of mh-e.el.


Local variables:
mode: outline
paragraph-separate: "[ 	]*$"
end:
