X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=INSTALL;h=7eae1db9463096b56e725d222c55c7bc8ffea847;hb=34ec62af8fc74c3c9d143328f485c82ef7aad327;hp=92bffa21250410ef794fdb6d45e5a85bb9c1c29f;hpb=1691e80890e5d8ba258c51c214a3e91880e1db2b;p=mmh diff --git a/INSTALL b/INSTALL index 92bffa2..7eae1db 100644 --- a/INSTALL +++ b/INSTALL @@ -27,17 +27,16 @@ need an ANSI C compiler such as gcc. sh 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'. All system-specific + definitions should be sensed automatically now, but 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. @@ -46,50 +45,35 @@ need an ANSI C compiler such as gcc. 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. - - 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. + 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": - 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 + 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. - Full Name + b) "pophost" defines the server that runs the POP daemon, and to + which `inc' and `msgchk' will always query for new mail. - 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. + c) "servers" defines the server to which you send outgoing SMTP + traffic. - 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'. + 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'. - Check the `mh-tailor' man page for a list of all the available - options for this file. + Check the `mh-tailor' man page for a list of all the available options + for this file ("masquerade" may be of particular interest). -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 @@ -98,8 +82,8 @@ need an ANSI C compiler such as gcc. 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. @@ -107,7 +91,8 @@ need an ANSI C compiler such as gcc. 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 . 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 @@ -213,10 +198,11 @@ Options for configure 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. + 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 + 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-hesiod=PREFIX Specify the location of Hesiod. @@ -225,5 +211,5 @@ Options for configure Enable debugging support. -- -Richard Coleman -coleman@math.gatech.edu +The nmh team +nmh-workers@mhost.com