Add documentation for --with-locking option
[mmh] / docs / FAQ
1 #
2 # FAQ -- frequently asked questions
3 #
4 # $Id$
5 #
6
7 1) What is nmh?
8
9     nmh (new MH) is an electronic mail handling system.  It is based on
10     version 6.8.3 of the MH message system originally developed by the
11     RAND Corporation and the University of California.
12
13 2) Is it nmh, Nmh, nMH, NMH?
14
15    It's nmh.  Richard Coleman hates capital letters.
16
17 3) Who is developing nmh?
18
19    Richard Coleman (coleman@math.gatech.edu) started the nmh project.
20    After he grew too busy to continue maintaining it, it was handed off
21    to the net at large. Doug Morris (doug@mhost.com) is hosting the
22    mailing lists, web pages, and CVS repository for nmh now.
23
24 4) Why did Richard start the nmh project?
25
26    He reponds:
27
28        For several reasons.
29        a) It's an interesting project.
30        b) I like using MH/nmh.
31        c) I wanted to increase the portability of MH.
32        d) I wanted to make MH easier to install (convert to autoconf).
33        e) I wanted to remove all the unnecessary junk from the
34           MH distribution (pop daemon, bulletin board support, etc...).
35        f) UCI seems to have abandoned MH, so someone needed to pick up
36           the slack.
37
38 5) What is the copyright status of nmh?
39
40    nmh is distributed under a variant of the classical BSD copyright.
41    Check the COPYRIGHT file in the nmh distribution for the details.
42    There are some specific files which were contributed to the original
43    MH package that are copyrighted by their original author.  We have
44    retained the copyright notices of these authors in these files.
45
46    Essentially, you can do anything you want with the nmh package as long
47    as you don't blame us if it trashes all your mail.
48
49 6) What is the difference between nmh and MH?
50
51    Check the file DIFFERENCES in the nmh distribution for the
52    (ever growing) list of differences between nmh and MH.
53
54 7) Where do I get nmh?
55
56     The latest version of nmh is available at
57     ftp://ftp.mhost.com/pub/nmh/nmh.tar.gz
58
59 8) Where is the nmh web page?
60
61     The nmh home page is located at
62     http://www.mhost.com/nmh/
63
64 9) Where is the nmh mailing list?
65
66     There is a mailing list for nmh development at:
67     nmh-workers@mhost.com
68
69     To subscribe, send e-mail to the administrative address:
70     nmh-workers-request@mhost.com
71
72     with the subject "subscribe" (without the quotes).
73
74 10) Is there an archive of the nmh-workers mailing list?
75
76     There are, but they are only available if you are subscribed to
77     the mailing list as well. This is done to try to prevent
78     harvesting of email addresses for spam lists. For information on
79     how to use the archive, see the MAILING-LISTS file in the docs
80     subdirectory of the distribution.
81
82 11) Where do I report bugs in nmh?
83
84     Send bug reports and suggestions to
85     nmh-bugs@mhost.com
86
87 12) Which mail transfer agents (MTA's) are supported?
88
89     The default setup for nmh is to use SMTP, so nmh should work with
90     most MTA's that provide a standard SMTP connection on port 25.
91     Also you may configure nmh to use a sendmail interface (still
92     uses SMTP) by editing the mts.conf file.  There is also a configure
93     option (--enable-pop) to include client-side support for POP.
94
95 13) Why does `folder' and `flist' overlook some of my subfolders?
96
97     There was a bug in these commands which caused them to quit
98     searching a folder for subfolders too early, if the folder contained
99     subfolders which were symbolic links.  This has been improved in
100     nmh-0.25, but `folder' and `flist' will still not recurse into
101     folders that contain only symbolic links.
102
103 14) Why doesn't the (X)Emacs package `mh-e' work with
104     nmh?
105
106     In nmh, the default location of things have changed.  Also the MH
107     lib directory has been split into a `etc' directory (containing
108     configuration files and components), and a `lib' directory
109     (containing support binaries).  So sometimes mh-e has trouble
110     finding the components skeleton for composing new mail or replies.
111     Depending on the install location of nmh at your site, you will
112     need to add something similar to the following to your .emacs file.
113     The lines for `mh-comp-formfile' and `mh-repl-formfile' should point
114     to your personal copies of these files (if you have them) or else
115     point to the default nmh versions.
116
117     ;; set a few mh-e variables for nmh
118     (setq mh-progs "/usr/local/nmh/bin/")
119     (setq mh-lib "/usr/local/nmh/lib/")
120     (setq mh-comp-formfile "/usr/local/nmh/etc/components")
121     (setq mh-repl-formfile "/usr/local/nmh/etc/replcomps")
122