# 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
+3) (Optional) make check
+
+ This takes a bit of time, around one minute on a modern machine,
+ but is highly recommended.
+
+ 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
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 ("masquerade" may be of particular interest, though its
- default value allows the most flexibility. See the discussion of the
- --enable-masquerade configure option below).
+ for this file.
6) Edit the file `mhn.defaults' (installed in the nmh `etc' directory).
This file contains the default profile entries for the nmh command
"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>.
-7) make check
-
- This takes a bit of time, around one minute on a modern machine,
- but is highly recommended. If you're going to run it, it must be
- run after installation. If you want to run the nmh test suite
- prior to installation, use "make distcheck".
-
-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-masquerade[='draft_from mmailid username_extension']
- By default, all three masquerade options are enabled.
-
- If this option is disabled, the mts.conf file will contain the
- line "masquerade: " (with no value), which may be manually edited
- later. 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.
-
- See the mh-tailor(5) man page for full documentation of "masquerade:".
-
- This option will likely be removed in a future version of nmh.
-
---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