X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=legacy%2FINSTALL;fp=legacy%2FINSTALL;h=c3e11bc0f7c90b5f09b5dd0e82b657fec5fa4868;hp=0000000000000000000000000000000000000000;hb=3ad8157bbbc6b9fae1c3252aad1c07fcccd92004;hpb=2fea7732a573b94a4d5dcf7e641ef067472e9cab diff --git a/legacy/INSTALL b/legacy/INSTALL new file mode 100644 index 0000000..c3e11bc --- /dev/null +++ b/legacy/INSTALL @@ -0,0 +1,144 @@ +This document describes the steps which are necessary to +install and use Mutt-ng + + +Supported platforms: +==================== + +Mutt-ng should run under the following platforms: + +AIX, BSDI, Convex, Data General Unix (DG/UX), Digital Unix (OSF/1), +DYNIX/ptx, FreeBSD, HP-UX, IRIX, Linux, Atari MiNT, MkLinux, NetBSD, +OpenBSD, QNX, SCO Unix 3.2v4/5, Solaris, SunOS, Ultrix, UnixWare, +MacOSX + + +Requirements: +============= + +1. ANSI C compilter. The GNU c compiler would be a good choice + +2. A SysV compatible semigraphic library. + Mutt-ng supports: + - GNU ncurses , ftp://ftp.gnu.org/gnu/ncurses/ + - S-Lang, ftp://space.mit.edu/pub/davis/slang/ + +3. An implementation of the iconv API for character set + conversions. This one is recommend: + http://www.gnu.org/software/libiconv/ + + +Installation: +============= + +1. Installing Mutt-ng is very easy. Just use tar and gzip/bzip2. + For example type: `tar xvfz mutt-ng-20050515.tar.gz'. + If you have obtained the distribution from + the SVN (subversion) repository, run the `autogen.sh' script with the + same command line parameters like it is described in doc/devel-notes.txt + +2. The next step is to call `configure' to configure your installation + depending on your system. + In most cases, configure will automatically determine everything it + needs to know in order to compile. However, there are a few options + to `configure` to help it out, or change the default behavior: + + Configure options: + ================== + + --prefix=DIR + install Mutt-ng in DIR instead of /usr/local + + --with-curses=DIR + use the curses lib in DIR/lib. If you have ncurses, `configure' + will automatically look in /usr/include/ncurses for the include + files. + + --with-slang[=DIR] + use the S-Lang library instead of ncurses. This library seems to + work better for some people because it is less picky about proper + termcap entries than ncurses. + + This are just a few configure options to get a complete list type: + `configure --help' + +3. Once `configure' has completed, simply type `make install.' + +Mutt-ng should compile cleanly (without errors) and you should end up with a +binary called `muttng.' If you get errors about undefined symbols like +A_NORMAL or KEY_MIN, then you probably don't have a SysV compliant curses +library. You should install either ncurses or S-Lang (see above), and then +run the `configure' script again. +Depending on the features you included via configure you can get similliar +errors from other libraries that are missing. + + +Iconv character set support +===================== + +If you decide to use your system's iconv implementation, you may +need to tell Mutt-ng about implementation-defined names for some +character sets. Sample configuration files for various systems can +be found in the directory contrib/iconv/ in this source +distribution, and will be installed in the samples/iconv directory +as part of Mutt-ng's documentation. + +In order to use these sample configuration files, just put a line +like + + source /usr/local/doc/muttng/samples/iconv/iconv.osf1-4.0d.rc + +into your system's global Muttngrc, which normally resides in /etc or +/usr/local/etc. + +If you really want to, you can configure Mutt-ng --disable-iconv, but +there will then be no character set conversion. + + +Platform Notes +============== + +All platforms + +There is a bug in most (if not all) S-Lang versions which +prevents the Meta key from working with Mutt-ng. A patch can +be found in the file contrib/patch.slang-1.2.2.keypad.1 in +this Mutt-ng distribution. + +- Solaris 2.4 + +The system regcomp() and regexec() routines are very badly +broken. This should be automatically detected by the +configure script. If not, use the --with-regex switch when +configuring Mutt-ng. + +We are also hearing reports that Solaris 2.4's NLS libraries +dump core with Mutt-ng when using a locale different from "C". +Use the --with-included-gettext configuration switch if you +experience this problem. + +Color does not work right with Solaris curses. You will +have to compile with either ncurses or slang to get working +color support. + +- Solaris 2.6 + +There are reports that Mutt-ng behaves strangely when linked with +the system regexp library. Please use the --with-regex switch +when configuring on this platform. + +For the real fix, applying Sun patches # 105490-05 (linker +patch) and # 105210-17 (libc and malloc patch) from +sunsolve.sun.com has been reported to stop these problems +from occuring. + +- Linux + +On recent Linux systems, flock() and fcntl() locks don't mix. If +you use the --enable-flock switch on such systems, be sure to +give the --disable-fcntl argument as well. + + +Mo Mai 23 19:52:22 CEST 2005 Nico 'nion' Golde + + * updated/rewrote document