+Meillo's Mail Handler (mmh)
+===========================
+
+Mmh is a modified version of the electronic mail handling system nmh.
+Nmh (new MH) itself was originally based on the package MH-6.8.3, and
+was intended to be a (mostly) compatible drop-in replacement for MH.
+In contrast, mmh is not inteded to be a drop-in replacement for nmh,
+rather mmh breaks compatibility to nmh in order to modernize and
+simplify it.
+
+Mmh is young and small; nmh is established and matured; MH is ancient.
+
+This distribution uses the term ``nmh'' to describe something common
+to nmh and mmh, in order to give credit. Where mmh differs much from
+nmh, the term ``mmh'' is used to avoid confusing the user.
+Unfortunately, the terms are not used fully consistent.
+
+
Installing
----------
Please read the INSTALL file.
+
Copying
-------
-nmh uses a BSD-style license, which should be in the top-level of the
+Mmh uses a BSD-style license, which should be in the top-level of the
distribution in a file named COPYRIGHT.
+
+Users
+-----
+Start with reading the man page mmh-intro(7). It explains the first
+steps. For convenience in the shell, have a look at the files
+docs/COMPLETION-*. They give cookbook examples of how to set up mmh-
+specific tab completion in your shell.
+
+
Developers
----------
-Information of interest to nmh developers can be found in the
+Information of interest to mmh developers can be found in the
README.developers file in the docs subdirectory of this distribution.
-If you're hacking on the code, you should also definitely subscribe to
-the nmh-workers mailing list. To do so, please visit the nmh-workers
-info page at <http://lists.nongnu.org/mailman/listinfo/nmh-workers>.
-If you're interested in working on nmh, but aren't sure what to do, see
-the TODO file in the docs subdirectory. There's plenty of work there.
-
-Working with your shell
------------------------
-The files COMPLETION-BASH, COMPLETION-TCSH and COMPLETION-ZSH in the
-docs subdirectory give cookbook examples of how to use the enhanced
-features of these shells with nmh. There is also a section in Jerry
-Peek's book covering nmh/MH and working with the shell. The section is
-available online at <http://rand-mh.sourceforge.net/book/mh/mhanthsh.html>.
-
-For More information
+Markus Schnalke's master's thesis explains the existence, shape, and
+focus of mmh. You should read it before working on mmh. If you're
+hacking on the code, you should subscribe to the nmh-workers mailing
+list. To do so, please visit the nmh-workers info page at
+<http://lists.nongnu.org/mailman/listinfo/nmh-workers>. Up to now,
+mmh has no separate mailing list.
+
+
+Bug reports
+-----------
+Please send bug reports and suggestions to either Markus Schnalke
+<meillo@marmaro.de> or to the <nmh-workers@nongnu.org> mailing list.
+
+
+Acknowledgments
+---------------
+The MH system was originally developed in 1979 by the RAND
+Corporation. It was written primarily by Bruce S. Borden after ideas
+in a memo by R. Stockton Gaines and Norman Z. Shapiro. In 1982,
+the University of California, Irvine took up maintenance of the
+software, under the direction of Marshall T. Rose and John L. Romine.
+
+nmh was started by Richard Coleman (coleman@math.gatech.edu) after
+development on MH mostly stopped. He did the original autoconfiscation
+and most of the other work up until version 1.0. nmh is currently being
+developed and maintained by a loosely organized group of volunteers.
+
+
+For more information
--------------------
-There is more information, including a FAQ and a bit of historical
-information in the docs subdirectory. There are also links to further
-documentation on the nmh website located at <http://nmh.nongnu.org/>.
+There is more information in the docs subdirectory. Please note that
+several documents are historic.
+
+The mmh website is located at <http://marmaro.de/prog/mmh/>.
+Feel free to contact Markus Schnalke <meillo@marmaro.de>.
+
+(The nmh website is located at <http://nmh.nongnu.org/>.)
projects / mmh / blobdiff