X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=README;h=8400d5e2f196f1a75ed2f0de5097857a7fdfce73;hp=a4e21cdd2ded6dffadd9fc47ddc656b6795bda46;hb=5cb46b33551f28e4168989e752e09bd927e993f9;hpb=c9f5db670ffbc6e761fb0512e621f2aee71509ee diff --git a/README b/README index a4e21cd..8400d5e 100644 --- a/README +++ b/README @@ -1,52 +1,85 @@ -# -# README -- I love README files. -# -# $Id$ -# +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 intended to be a drop-in replacement for nmh, +but rather aims for the modernization and simplification of nmh, +accepting reduced compatiblity if it, at the same time, allows to +achieve greater goals from mmh's point of view. + +Mmh is small and simple; nmh is established and matured; MH is ancient. + +Unfortunately, the usage of the terms `mmh' and `nmh' is not fully +consistent within the distribution. + + +Installing +---------- +See the INSTALL file. + + +Copying +------- +Mmh uses a BSD-style license, which can be found in the COPYRIGHT +file. + + +Users +----- +Start by 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 mmh developers can be found in the +README.developers file in the docs subdirectory of this distribution. +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 mmh's mailing list. To +do so, send a message to with the subject +``subscribe''. + + +Changes +------- +See the NEWS file for a summary of changes between releases. See +the ChangeLog file (which is included in releases as a static copy +of the VCS log) for a more detailed list of changes. + + +Bug reports ----------- -what is it? ------------ -nmh (new MH) is an electronic mail handling system. It was -originally based on the package MH-6.8.3, and is intended to be -a (mostly) compatible drop-in replacement for MH. - -Although development of nmh is ongoing, it appears to be generally -stable and is in current use. But it is possible that we may -break things as changes are made. - --------------- -installing nmh --------------- -To install nmh, check the INSTALL and MACHINES files. If you have -previously used MH, check the file DIFFERENCES for a list of the -differences between nmh and MH. - --------------------------------- -ftp and web sites, mailing lists --------------------------------- -To find out about the mailing lists, ftp sites, and web page -for nmh, check the FAQ included in this distribution. +Please send bug reports and suggestions to the mailing list: +. ---------------- -nmh maintenance ---------------- -nmh is currently being developed and maintained by a loosely organized -group of volunteers. Please send bug reports and suggestions to the -nmh development mailing list at nmh-workers@mhost.com. ----------------- -acknowledgments ----------------- -The original MH system was developed by the RAND Corporation and the -University of California. +Acknowledgments +--------------- +The MH system was originally developed by the RAND Corporation, +starting in 1979. It was written mainly 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 +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. +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. + + +More information +---------------- +There is more information in the docs subdirectory. Some of the +documents are historic, however. -nmh uses (v)snprintf code from the Apache web server, so we need to -make the following acknowlegement: +The mmh website is located at . +Feel free to write to mmh's mailing list at +or contact Markus Schnalke directly. -This product includes software developed by the Apache Group -for use in the Apache HTTP server project (http://www.apache.org/). +(The nmh website is located at .)