MH-E Files

MH-E is the Emacs interface to the MH mail system. In 2010, the
version control system (VCS) of Emacs was upgraded from CVS to Bazaar.
In 2011, the MH-E team followed suit and upgraded the MH-E repository
at SourceForge from CVS to Bazaar as well. The result is version 8.3
of MH-E, which includes needed changes to the build scripts.

Otherwise, this is a small release that includes mostly internal
changes from the Emacs team. The MH-E manual for MH-E 8.3 contains
updates for the mairix and namazu examples.

2011-09-21  Bill Wohler  <wohler@newt.com>

	Release MH-E manual version 8.3.

	* mh-e.texi: (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for
	release 8.3.
	(Preface): Updated support information.
	(From Bill Wohler): Reset text to original version. As a
	historical quote, the tense should be correct in the time that it
	was written.

2011-07-02  Bill Wohler  <wohler@newt.com>

	* README: Replace references to CVS with Bazaar.

	* Makefile (CVSROOT, CVSLOGIN, CVSMETHOD): Remove.
	(MH_E_DOC, MH_E_ETC_EMACS) Define and use EMACS_SRC and DOC_DIR
	for ../src/emacs/trunk/doc/misc.
	(MAKEINFOINFOFLAGS): Define input and output options.
	(emacs): Remove.
	($(MH_E_DOC)): Simply link to $(EMACS_SRC)/doc.
	(info/mh-e): Run from current directory. Use updated
	MAKEINFOINFOFLAGS for input and output directories.
	(tag, dist): Update for bzr.
	(backup): Remove. Obsolete.

2011-02-23  Glenn Morris  <rgm@gnu.org>

	* mh-e.texi: Standardize some Emacs/XEmacs terminology.

2011-02-19  Eli Zaretskii  <eliz@gnu.org>

	* mh-e.texi: Sync @dircategory with ../../info/dir.

2010-10-31  Glenn Morris  <rgm@gnu.org>

	* mh-e.texi (Preface, From Bill Wohler): Change 23 to past tense.

2010-06-23  Glenn Morris  <rgm@gnu.org>

	* mh-e.texi: Untabify.

2009-12-01  Bill Wohler  <wohler@newt.com>

	* mh-e.texi (Searching): Use mh vfolder_format and fix typo in database
	path for mairix example.  Specify -q in namazu example since namazu is
	excessively garrulous.



* INTRODUCTION

This is the documentation for MH-E, a GNU Emacs interface to the MH
mail system.

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 "C-h i m mh-e RET" within Emacs. This should
bring you to the top of the MH-E documentation which shows the version
of the documentation which is the same as the version of the software
for which it was written. Use the command "M-x mh-version" within
Emacs to see which version of the software you are running. If this
package contains a more recent version of the MH-E documentation which
is compatible with the version of the software that you're running,
read on.

The Bazaar MH-E manual is built into Bazaar Emacs, so if you use
Bazaar Emacs, then you have no need of this release. You are already
have the latest version of the manual.

This version of the MH-E documentation will appear in GNU Emacs 24.1.



* 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-doc-8.3.tgz

** Build the desired documentation.

The Texinfo source can produce documentation in Emacs' info format,
HTML format for viewing via a browser, and PDF formats for printing.

First, go into the mh-e-doc-8.3 directory and then follow the
appropriate directions below.

*** info

Run `make info'. This creates a sub-directory called `info', builds
the info version of the documentation, and deposits it in that
directory. You need the program `makeinfo' to do this.

To view the Info node `mh-e', Find out where your existing info files
are located. Assuming your existing info files are in
`/usr/share/info', set the INFOPATH environment variable to:

	/path/to/mh-e-doc-8.3/info:/usr/share/info

Then run "C-h i g (mh-e) RET" (in Emacs).

*** HTML

Run `make html'. This creates a sub-directory called `html', builds
the HTML version of the documentation, and deposits it in that
directory. You need the programs `makeinfo' to do this.

Use a browser and point it at "/path/to/mh-e-doc-8.3/html/index.html"
to view the documentation.

*** PDF

Run `make pdf'. This builds the PDF version of the documentation, and
names it `mh-e.pdf'. You need the program `texi2pdf', `makeinfo', and
`pdftex' or `pdfetex' to do this.

You can then either view the documentation with a tool such as `gv',
`gpdf', `ggv', `xpdf', or print it. The file is
"/path/to/mh-e-doc-8.3/pdf/mh-e.pdf".

*** Everything

Run `make all' or just `make'.



* BAZAAR MH-E MANUAL INSTALL

After checking out the doc module, follow any of the steps that apply
to you in INSTALL above. In each case, running `make' will try to
create a symbolic link from `doc' to the Emacs source in your MH-E
source tree, specifically `../src/emacs/trunk'. If your Emacs source
is located in another directory, add `EMACS_SRC=/path/to/emacs/trunk'
to your make command line.



* ADDITIONAL INFORMATION

** This documentation is also available in the following forms:

*** HTML & PDF

An online version of the documentation is available here:

	http://mh-e.sourceforge.net/manual/

*** 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 see http://mh-e.sourceforge.net/.

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

$Id: README,v 1.12 2009-06-13 16:46:45 wohler Exp $