X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=INSTALL;h=79f8f6f086bae0caebdb4a22dd45f2e9c5c9c6ed;hb=a2469f5ecbca3a179251ac9b777b561bc5245d4c;hp=c1a91f0e61d2001d52f9012162b279c8755c117a;hpb=8979d70884315e7de858d4de2c0bb5287ad7bbbb;p=mmh diff --git a/INSTALL b/INSTALL index c1a91f0..79f8f6f 100644 --- a/INSTALL +++ b/INSTALL @@ -1,8 +1,6 @@ # # INSTALL -- installation instructions # -# $Id$ -# -------------- Installing nmh @@ -14,6 +12,23 @@ You should check the MACHINES file to see if there are any specific build instructions for your operating system. To build nmh, you will need an ANSI C compiler such as gcc. +0) If you have obtained nmh by checking it out of CVS, you will + need to run the GNU autotools to regenerate some files. + (If your directory already contains a file 'config.h.in' + then this has already been done and you do not need to do it.) + You can regenerate the files by running the command + + ./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.) + + If you have obtained nmh in the form of a tar archive and are + trying to unpack it with cpio: due to an apparent bug in cpio, it + might fail with "Malformed number" error messages. Try another + tool to unpack, such as tar or pax. + 1) From the top-level source directory, run the command ./configure [options] @@ -75,13 +90,7 @@ need an ANSI C compiler such as gcc. 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). +6) 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 @@ -102,7 +111,7 @@ need an ANSI C compiler such as gcc. "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. @@ -171,20 +180,18 @@ Options for configure 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. + 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. By default, it is enabled. - 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. + The above usage shows the default, with all three masquerade + options being specified. Any subset of the three may be + specified. 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. @@ -246,6 +253,17 @@ Options for configure 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 + to compile against the ndbm database library. By default, configure + will try various possibilities until it finds one that works; this + option only needs to be specified if the autodetection fails or + makes the wrong choice. + + 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