build instructions for your operating system. To build nmh, you will
need an ANSI C compiler such as gcc.
-1) Run the command
+1) From the top-level source directory, run the command
- sh configure [options]
+ ./configure [options]
- This will check the configuration of your OS, and create
- the include file config.h, as well as the various Makefiles.
+ This will check the configuration of your OS, and create the
+ include file config.h, as well as the various Makefiles.
- The configure script accepts various options. The options of
- most interest are listed below. To see the list of all available
- options, you can run
+ The configure script accepts various options. The options of
+ most interest are listed in a section below. To see the list
+ of all available options, you can run
- sh configure --help
+ ./configure --help
-2) (IMPORTANT) Edit the user configuration section at the beginning
- of the generated include file `config.h'. Currently, not everything
- is auto-configured, so some #defines must be set manually.
+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.
-3) Edit the user configuration section at the top of the main Makefile.
+3) make
-4) make
+4) make install
-5) make install
-
-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.
injecting the message to a mail transfer agent (such as sendmail)
on the local machine via SMTP.
- If you have enabled POP support and you want this to be the
- default method of accessing new mail, you will need to change
- the values of the variables "servers", "pophost", "localname",
- and possibly "mmailid".
-
- a) "servers" defines the server to which you send outgoing SMTP
- traffic.
-
- b) "pophost" defines the server that runs the POP daemon, and to
- which `inc' and `msgchk' will query for new mail.
+ If, instead, all your mail sending and receiving occurs on a
+ remote POP/SMTP server, you will need to look at the values of the
+ variables "localname", "pophost", and "servers":
- c) "localname" defines the hostname that nmh considers local.
- If not set, then nmh queries your OS for this value. You may
- want to change this if you wish your e-mail to appear as if it
- originated on the POP server.
+ a) "localname" defines the hostname that nmh considers local.
+ If not set, then nmh queries your OS for this value. You will
+ want to change this if you wish your e-mail to appear as if it
+ originated on the POP server.
- d) "mmailid" is checked to see if nmh should do username
- masquerading. If the value of this field is non-zero, then
- nmh will check if the pw_gecos field in the password file
- has the form
+ b) "pophost" defines the server that runs the POP daemon, and to
+ which `inc' and `msgchk' will always query for new mail.
- Full Name <fakeusername>
+ c) "servers" defines the server to which you send outgoing SMTP
+ traffic.
- If the pw_gecos field has this form, then the internal nmh
- routines that find the username and full name of a user will
- return "fakeusername" and "Full Name" respectively. This is
- useful if you wish messages that you send to appear to come
- from the username of your POP account, rather than your username
- on the local machine.
+ 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 compile with POP support, but only want to use it occasionally,
- then you can always use the `-host' and `-user' options to `inc'
- and `msgchk' instead of changing `mts.conf'.
+ Check the `mh-tailor' man page for a list of all the available options
+ for this file ("masquerade" may be of particular interest).
- Check the `mh-tailor' man page for a list of all the available
- options for this file.
-
-7) If you have enabled POP support, make sure that `pop3' (or more
+6) If you have enabled POP support, make sure that `pop3' (or more
precisely the value of the define POPSERVICE in config.h) is defined
in the /etc/services file (or its NIS/NIS+ equivalent) on the client
machine. It should be something equivalent to "110/tcp". This might
- have already been done when the pop daemon was installed.
+ have already been done when the POP daemon was installed.
-8) Edit the file `mhn.defaults' (installed in the nmh `etc' directory).
+7) 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
want to re-run this script later if you install new programs to
display content. An example of this is:
- cd support/general
- ./mhn.defaults.sh /usr/local/bin:/usr/X11/bin:/usr/ucb > mhn.defaults
+ % cd support/general
+ % ./mhn.defaults.sh /usr/local/bin:/usr/X11/bin:/usr/ucb > mhn.defaults
and then move `mhn.defaults' into the nmh `etc' directory.
If you have specialized programs to handle various types, you will need
to edit the `mhn.defaults' file manually. The syntax of this file is
described in the man page for `mhn', and in section 9.4 of the book
- "MH & xmh: Email for Users and Programmers", 3rd edition, by Jerry Peek.
+ "MH & xmh: Email for Users and Programmers", 3rd edition, by Jerry Peek,
+ on the Internet at <http://www.ics.uci.edu/~mh/book/mh/confmhn.htm>.
9) Add an optional global mh.profile, if desired. This profile should be
placed in the nmh `etc' directory with the name `mh.profile'. This
--mandir=DIR (DEFAULT is ${prefix}/man)
nmh's man pages are installed here.
+--enable-debug
+ Enable debugging support.
+
+--enable-masquerade[='draft_from mmailid username_extension']
+ If this option is not specified, 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.
+
+ The above usage shows all three masquerade options being specified, but any
+ subset of the three may be specified. If you do want to enable all three,
+ you can simply use `configure --enable-masquerade' as a shortcut.
+
+ See the mh-tailor(5) man page for full documentation of "masquerade:".
+
+--enable-mhe (DEFAULT)
+ Add support for the Emacs front-end `mhe'.
+
+--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
+ for the `vi' command and use it as the default. If you wish to
+ specify an interface which is compatible with MH, then use the
+ 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-mts=MTS (DEFAULT is smtp)
- specify the mail transport system you want to use. The two
+ Specify the mail transport system you want to use. The two
acceptable options are "smtp" (which is the default), and
"sendmail".
If you wish to use a transport agent other than sendmail, you will
need to use a `sendmail wrapper'.
---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
- for the `vi' command and use it as the default. If you wish to
- specify an interface which is compatible with MH, then use the
- nmh command `prompter'. If you specify `prompter', then you don't
- need to give the full pathname.
-
--with-pager=PAGER (DEFAULT is more)
- specify the default pager (file lister) to use. If this option
+ Specify the default pager (file lister) to use. If this option
is not given, then the configuration process will search for the
command `more' and use it as the default.
---enable-nmh-mhe (DEFAULT)
- Add support for the Emacs front-end `mhe'.
-
---enable-nmh-pop
- Enable client-side support for pop.
-
---with-krb4=PREFIX
- Specify the location of Kerberos V4 for KPOP support. You will
- also need to specify the option `--enable-nmh-pop'. After running
- configure, you will probably need to change the POPSERVICE define
- in config.h. See the comments inside config.h for details.
-
---with-hesiod=PREFIX
- Specify the location of Hesiod.
+--with-smtpservers='SMTPSERVER1[ SMTPSERVER2...]' (DEFAULT is localhost)
+ If this option is not specified, the mts.conf file will contain
+ the line "servers: localhost", 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.
---enable-nmh-debug
- Enable debugging support.
+ See the mh-tailor(5) man page for full documentation of "servers:".
--
-Richard Coleman
-coleman@math.gatech.edu
+The nmh team
+nmh-workers@mhost.com