X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=INSTALL;h=b1e1d1095199880dfbf4b9397dd4b1cc473c2d58;hb=6e0e2e4490ebb9daf1f62ed7a2d30412551772ee;hp=92bffa21250410ef794fdb6d45e5a85bb9c1c29f;hpb=1691e80890e5d8ba258c51c214a3e91880e1db2b;p=mmh diff --git a/INSTALL b/INSTALL index 92bffa2..b1e1d10 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. @@ -62,34 +61,48 @@ need an ANSI C compiler such as gcc. 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 + d) "mmailid" allows two different types of email address masquerading + when it's set to be non-zero. The first type is GECOS-based + masquerading. nmh will check if the user's pw_gecos field in the passwd + is of the form: Full Name - 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 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. - -7) If you have enabled POP support, make sure that `pop3' (or more + If it is, the internal nmh routines that find the username and full + name of that user will return "fakeusername" and "Full Name" + respectively. This is useful if you want the messages you send to + always appear to come from the name of an MTA alias rather than your + actual account name. For instance, many organizations set up + "First.Last" sendmail aliases for all users. If this is the case, + the GECOS field for each user should look like: + + First [Middle] Last + + The other type of masquerading that mmailid turns on is envelope + "From:" masquerading based on draft contents. When a user explicitly + specifies a "From:" header in a message, nmh uses it rather than + constructing its own. However, the SMTP envelope "From:" and the + "Sender:" header are set to the user's real address. Turning on + mmailid prevents this latter behavior. This is useful when the user + wants to pretend to be sending mail "directly" from a remote POP3 + account, or when remote mail robots incorrectly use the envelope + "From:" in preference to the body "From:" (or refuse to take action + when the two don't match). + + 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 values in `mts.conf'. + + Check the `mh-tailor' man page for a list of all the available options + for this file. + +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. -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 @@ -107,7 +120,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 @@ -225,5 +239,5 @@ Options for configure Enable debugging support. -- -Richard Coleman -coleman@math.gatech.edu +The nmh team +nmh-workers@mhost.com