* INTRODUCTION

Use this package to browse the book MH & nmh: Email for Users &
Programmers (also known as the MH book) from your local hard disk. The
book also covers exmh, and xmh. It used to cover MH-E as well, but
MH-E now has its own book at http://mh-e.sourceforge.net/manual/.

This file contains installation directions; the release notes contain
important information regarding this release. The release notes for
all versions are packaged with the MH book in a file called NEWS.



* PREREQUISITES

Since the book uses PHP to render the header and footers, this book
requires a web server that supports PHP in order to take advantage of
these features. In a pinch, the files can be viewed directly in a
browser, although the experience will not be as rich.



* INSTALL

** Extract the tarball.

Choose a directory that is visible to your web server, such as
/var/www, /usr/local/lib/apache/htdocs, or ~$USER/public_html.

If you don't have GNU tar, use gzip to uncompress the tarball and drop
the `z' option.

    tar xzf mh-book-yyyymm.tgz

** Point your web browser at the top-level directory.

        http://localhost/path/to/MH-book-yyyynn/

** Note that the Google Search will not work unless you are connected
   to the Internet.

** Read the release notes in NEWS (text) or NEWS.html (HTML).

See what's new or changed.

** Read the terms for copying and distribution under the GNU General
   Public License in copying.html.



* SUBVERSION MH BOOK INSTALL

Check out the book with the following command:

  svn co https://svn.sourceforge.net/svnroot/rand-mh/book/trunk book

Then run `make' to build the indexes.

Periodically run `make' again to update your version of the book and
rebuild the indexes.



* ADDITIONAL INFORMATION

** Staying up to date

Go to http://sourceforge.net/project/showfiles.php?group_id=143658 and
click on the envelope icon next to the MH Book package in order to
receive email notification whenever there is a new release.

** Online version of the book

This manual is available online at

  http://rand-mh.sourceforge.net/book/

** Mailing Lists, Bug Reports and Other Support

*** Ask questions at

http://sourceforge.net/tracker/?atid=756144&group_id=143658&func=browse

*** Report bugs at

http://sourceforge.net/tracker/?atid=756143&group_id=143658&func=browse

*** Request features at

http://sourceforge.net/tracker/?atid=756146&group_id=143658&func=browse

*** Submit patches at

http://sourceforge.net/tracker/?atid=756145&group_id=143658&func=browse

*** Join the discussion with the rand-mh-devel@lists.sourceforge.net
    mailing list at

http://sourceforge.net/mail/?group_id=143658

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


