# INSTALL -- installation instructions
#
---------------
-Installing nmh
---------------
+--------------------------------
+Installing nmh, guided by script
+--------------------------------
+For routine installation on popular platforms, the shell script in
+docs/contrib/build_nmh can be used to guide you through configuration.
+It will then build and optionally (with -i) install in the configured
+location.
+
+
+------------------------
+Installing nmh, manually
+------------------------
Please read all of the following instructions before you begin
building nmh.
./configure --help
-2) Look through the user configuration section at the beginning
- of the generated include file `config.h'. You may
- want to customize some #defines for your environment, though
- that is usually unnecessary. Note the configure options below
- control some of the #defines.
+2) make
-3) make
-
-4) make check
+3) (Optional) make check
This takes a bit of time, around one minute on a modern machine,
but is highly recommended.
-5) make install
+ test/inc/test-deb359167 uses valgrind, which detects use of an
+ uninitialized variable on older Linux distributions such as
+ Mandriva 2007.0 and CentOS 5.4. That particular failure is
+ beyond the scope of nmh and can be ignored.
+
+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
make is processing that directory to see if you need to merge
changes from *.prev files into the new versions.
-6) Edit the file `mts.conf' (installed in the nmh `etc' directory)
+5) Edit the file `mts.conf' (installed in the nmh `etc' directory)
and make any necessary changes for the mail transport interface
you are using.
traffic. See the discussion of the --with-smtpserver configure
option below.
- If you compile with POP support, but don't want to use it exclusively,
- you can use the `-host' and `-user' options to `inc' and `msgchk'
- rather than hardcoding pophost in `mts.conf'.
+ If you don't want to hardcode pophost in `mts.conf', you can use
+ the `-host' and `-user' options to `inc' and `msgchk'.
Check the `mh-tailor' man page for a list of all the available options
for this file.
-7) Edit the file `mhn.defaults' (installed in the nmh `etc' directory).
+6) Edit the file `mhn.defaults' (installed in the nmh `etc' directory).
This file contains the default profile entries for the nmh command
`mhn' and is created by the script `mhn.defaults.sh'. This script
will search a generic path (essentially your $PATH) for programs to
"MH & xmh: Email for Users and Programmers", 3rd edition, by Jerry Peek,
on the Internet at <http://rand-mh.sourceforge.net/book/mh/confmhn.html>.
-8) Add an optional global mh.profile, if desired. This profile should be
+7) Add an optional global mh.profile, if desired. This profile should be
placed in the nmh `etc' directory with the name `mh.profile'. This
file will be used to construct the initial .mh_profile of a new nmh
user, but will not be consulted after that.
--enable-debug
Enable debugging support.
---enable-pop
- Enable client-side support for pop.
-
---enable-apop
- Enable client-side support for apop (Authenticated POP).
-
--with-editor=EDITOR (DEFAULT is vi)
specify the full path of the default editor to use. If this
option is not given, then the configuration process will search
nmh command `prompter'. If you specify `prompter', then you don't
need to give the full pathname.
---with-hesiod=PREFIX
- Specify the location of Hesiod.
-
---with-krb4=PREFIX
- Specify the location of Kerberos V4 for KPOP support. After
- running configure, you will need to change the POPSERVICE #define in
- config.h if you want to use KPOP exclusively (rather than being able
- 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",
is not world- or user-writeable, and thus a lock file cannot
be created.
+--enable-lockdir=DIR (DEFAULT is disabled)
+ If dot locking is being used, store all dot-lock files in "DIR".
+ The default is to store them in the directory of the file being
+ locked.
+
--with-mts=MTS (DEFAULT is smtp)
Specify the default mail transport system you want to use. The two
acceptable options are "smtp" (which is the default), and
See the mh-tailor(5) man page for full documentation of "servers:".
+--with-cyrus-sasl (DEFAULT is without)
+ Enable SASL support for SMTP and POP via the Cyrus SASL library.
+ This is used for the POP AUTH and SMTP AUTH protocols. This supports
+ a wide variety of security mechanisms, including Kerberos/GSSAPI.
+ Session encryption via SASL is supported for both POP and SMTP
+ (depending on server-side support and the security mechanism in use).
+
+--with-tls (DEFAULT is without)
+ Enable TLS session encryption support for SMTP via the STARTTLS command.
+
+--with-readline (DEFAULT is to autodetect)
+ Enable support for readline functionality (command history/editing) at
+ the WhatNow? prompt.
+
--
The nmh team
nmh-workers@nongnu.org