Added -nocontentid (and -contentid, for symmetry) switch to mhbuild. This allows...
[mmh] / INSTALL
diff --git a/INSTALL b/INSTALL
index ca45be7..37a38e5 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -35,12 +35,13 @@ need an ANSI C compiler such as gcc.
 
 4) make install
 
-   Note that if you have [n]mh files in your install directories with the same
-   names as the files being installed, the old ones will get overwritten without
-   any warning.  The only directory that isn't true for is the `etc' directory
-   -- in that directory, the previous copy of each <file> will be backed up as
-   <file>.prev if it differs from the newly-installed copy.  Watch for any diff
-   output while make is processing that directory to see if you need to merge
+   Note that if you have [n]mh files in your install directories with
+   the same names as the files being installed, the old ones will get
+   overwritten without any warning.  The only directory that isn't
+   true for is the `etc' directory -- in that directory, the previous
+   copy of each <file> will be backed up as <file>.prev if it differs
+   from the newly-installed copy.  Watch for any diff output while
+   make is processing that directory to see if you need to merge
    changes from *.prev files into the new versions.
 
 5) Edit the file `mts.conf' (installed in the nmh `etc' directory)
@@ -208,25 +209,54 @@ Options for configure
      to switch between KPOP and normal POP3).  See the comments inside
      config.h for details.
 
+--with-locking=LOCKTYPE    (DEFAULT is dot)
+     Specify the locking mechanism when attempting to "inc" or
+     "msgchk" a local mail spool. Valid options are "dot",
+     "fcntl", "flock", and "lockf". Of the four, dot-locking
+     requires no special kernel or filesystem support, and simply
+     creates a file called "FILE.lock" to indicate that "FILE" is
+     locked.
+
+     In order to be effective, you should contact the site
+     administrator to find out what locking mechanisms other
+     mail delivery and user programs respect. The most common
+     reason not to use dot-locking is if the mail spool directory
+     is not world- or user-writeable, and thus a lock file cannot
+     be created.
+
 --with-mts=MTS   (DEFAULT is smtp)
-     Specify the mail transport system you want to use.  The two
+     Specify the default mail transport system you want to use.  The two
      acceptable options are "smtp" (which is the default), and
-     "sendmail".
-
-     If you use "smtp", this will enable a direct SMTP (simple
-     mail transport protocol) interface in nmh.  When sending
-     mail, instead of passing the message to the mail transport
-     agent, `post' will open a socket connection to the mail
-     port on the machine specified in the `mts.conf' file
-     (default is localhost), and speak SMTP directly.
-
-     If you use "sendmail", then `post' will send messages by
-     passing forking a local copy of sendmail.  Currently it
-     will still speak SMTP with this local copy of sendmail.
+     "sendmail".  This value will be put into the mts.conf file.  You
+     may find it convenient to specify a value at configure-time,
+     however, so that each time nmh is reinstalled, the right value will
+     be there.
+
+     If you use "smtp", this will enable a direct SMTP (simple mail
+     transport protocol) interface in nmh.  When sending mail, instead
+     of passing the message to the mail transport agent, `post' will
+     open a socket connection to the mail port on the machine specified
+     in the `mts.conf' file (default is localhost), and speak SMTP
+     directly.
+
+     If you use "sendmail", then `post' will send messages by forking a
+     local copy of sendmail.  Currently it will still speak SMTP with
+     this local copy of sendmail.
 
      If you wish to use a transport agent other than sendmail, you will
      need to use a `sendmail wrapper'.
 
+--with-ndbm=LIB    (DEFAULT is to autodetect)
+--with-ndbmheader=HEADER     (DEFAULT is to autodetect)
+     Specify the header file (eg ndbm.h) and library (eg ndbm) to use
+     to compile against the ndbm database library. By default, configure
+     will try various possibilities until it finds one that works; this
+     option only needs to be specified if the autodetection fails or
+     makes the wrong choice.
+
+     If either of these options is given then the other must also be
+     specified.
+
 --with-pager=PAGER    (DEFAULT is more)
      Specify the default pager (file lister) to use.  If this option
      is not given, then the configuration process will search for the
@@ -243,4 +273,4 @@ Options for configure
 
 --
 The nmh team
-nmh-workers@mhost.com
+nmh-workers@nongnu.org