X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=INSTALL;h=179d11d7a3ed310e1670d2689844331040e0e614;hb=7030d7edb099bff36ded7548bb5380f7acab4f9b;hp=e93a1b42795e42a757e7a807e821c699b4b0fb66;hpb=4a6d6b0b6d7c306c3d73e39a6a76f016ff60a6b1;p=mmh diff --git a/INSTALL b/INSTALL index e93a1b4..179d11d 100644 --- a/INSTALL +++ b/INSTALL @@ -1,8 +1,6 @@ # # INSTALL -- installation instructions # -# $Id$ -# -------------- Installing nmh @@ -22,6 +20,10 @@ need an ANSI C compiler such as gcc. ./autogen.sh + (Note that if you're doing nmh development, you should look at + docs/README.developers, since there is other developer-friendly + advice there as well.) + 1) From the top-level source directory, run the command ./configure [options] @@ -59,44 +61,19 @@ need an ANSI C compiler such as gcc. The default `mts.conf' file assumes you retrieve new mail from a local (or NFS mounted) maildrop, and send outgoing mail by injecting the message to a mail transfer agent (such as sendmail) - on the local machine via SMTP. - - 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": - - 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. - - b) "pophost" defines the server that runs the POP daemon, and to - which `inc' and `msgchk' will always query for new mail. - - c) "servers" defines the server to which you send outgoing SMTP - traffic. - - 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'. + on the local machine. Check the `mh-tailor' man page for a list of all the available options for this file ("masquerade" may be of particular interest). -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. - -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 - handle various content types (for example, xv to display images). - You can re-run this script and give it a more tailored path. You may - want to re-run this script later if you install new programs to - display content. An example of this is: +6) Edit the file `mhn.defaults' (installed in the nmh `etc' directory). + This file contains the default profile entries for the nmh commands + mhlist/mhstore/mhshow and is created by the script `mhn.defaults.sh'. + This script will search a generic path (essentially your $PATH) for + programs to handle various content types (for example, xv to display + images). You can re-run this script and give it a more tailored + path. You may 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 @@ -106,11 +83,11 @@ need an ANSI C compiler such as gcc. The `mhn.defaults.sh' script only searches for a simple set of programs. 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, - on the Internet at . + described in section 9.4 of the book "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 +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. @@ -167,7 +144,7 @@ Options for configure nmh's binaries (show, inc, comp, ...) are installed here. --libdir=DIR (DEFAULT is ${prefix}/lib) - nmh's support binaries (post, slocal, mhl, ...) are installed here. + nmh's support binaries (spost, slocal, mhl, ...) are installed here. --sysconfdir=DIR (DEFAULT is ${prefix}/etc) nmh's config files (mts.conf, mhn.defaults, ...) are installed here. @@ -194,30 +171,6 @@ Options for configure --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-locking=LOCKTYPE (DEFAULT is dot) Specify the locking mechanism when attempting to "inc" or "msgchk" a local mail spool. Valid options are "dot", @@ -233,28 +186,6 @@ Options for configure is not world- or user-writeable, and thus a lock file cannot be created. ---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 - "sendmail". This value will be put into the mts.conf file. 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. - - If you use "smtp", this will enable a direct SMTP (simple mail - transport protocol) interface in nmh. When sending mail, instead - of passing the message to the mail transport agent, `post' will - open a socket connection to the mail port on the machine specified - in the `mts.conf' file (default is localhost), and speak SMTP - directly. - - If you use "sendmail", then `post' will send messages by forking a - local copy of sendmail. Currently it will still speak SMTP with - this local copy of sendmail. - - If you wish to use a transport agent other than sendmail, you will - need to use a `sendmail wrapper'. - --with-ndbm=LIB (DEFAULT is to autodetect) --with-ndbmheader=HEADER (DEFAULT is to autodetect) Specify the header file (eg ndbm.h) and library (eg ndbm) to use @@ -266,20 +197,6 @@ Options for configure If either of these options is given then the other must also be specified. ---with-pager=PAGER (DEFAULT is more) - 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. - ---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. - - See the mh-tailor(5) man page for full documentation of "servers:". - -- The nmh team nmh-workers@nongnu.org