INSTALL

   1 Supported platforms
   2 ===================
   3
   4 Mutt-ng has been reported to compile and run under the following Unix operating
   5 systems:
   6
   7         AIX
   8         BSDI
   9         Convex
  10         Data General Unix (DG/UX)
  11         Digital Unix (OSF/1)
  12         DYNIX/ptx
  13         FreeBSD
  14         HP-UX
  15         IRIX
  16         Linux
  17         Atari MiNT
  18         MkLinux
  19         NetBSD
  20         OpenBSD
  21         QNX
  22         SCO Unix 3.2v4/5
  23         Solaris
  24         SunOS
  25         Ultrix
  26         UnixWare
  27
  28 - An ANSI C compiler (such as gcc) is required.
  29
  30 - You must also have a SysV compatible curses library, or you must
  31   install either
  32
  33         GNU ncurses, ftp://prep.ai.mit.edu/pub/gnu/
  34
  35   or
  36
  37         S-Lang, ftp://space.mit.edu/pub/davis/slang/
  38
  39 - Mutt-ng needs an implementation of the iconv API for character set
  40   conversions.  A free one can be found under the following URL:
  41
  42         http://www.gnu.org/software/libiconv/
  43
  44
  45
  46 Installation
  47 ============
  48
  49 Installing Mutt-ng is rather painless through the use of the GNU
  50 autoconf package.  Simply untar the Mutt-ng distribution, and run the
  51 ``configure'' script.  If you have obtained the distribution from
  52 the CVS repository, run the ``prepare'' script with the same command
  53 line parameters you would pass to configure.  It will set up Mutt-ng's
  54 build environment and add the files which are present in the tar
  55 balls, but not in the CVS repository.
  56
  57 In most cases, configure will automatically determine everything it
  58 needs to know in order to compile.  However, there are a few options
  59 to ``configure'' to help it out, or change the default behavior:
  60
  61 --prefix=DIR
  62         install Mutt-ng in DIR instead of /usr/local
  63
  64 --with-curses=DIR
  65         use the curses lib in DIR/lib.  If you have ncurses, ``configure''
  66         will automatically look in /usr/include/ncurses for the include
  67         files.
  68
  69 --with-slang[=DIR]
  70         use the S-Lang library instead of ncurses.  This library seems to
  71         work better for some people because it is less picky about proper
  72         termcap entries than ncurses.  It is recommended that you use at
  73         *least* version 0.99-38 with Mutt-ng.
  74
  75 --with-mailpath=DIR
  76         specify where the spool mailboxes are located on your system
  77
  78 --with-homespool[=FILE]
  79         treat file in the user's home directory as the spool mailbox.  Note
  80         that this is *not* the full pathname, but relative to the user's
  81         home directory.  Defaults to "mailbox" if FILE is not specified.
  82
  83 --enable-pop
  84         enable POP3 support
  85
  86 --enable-imap
  87         enable IMAP support
  88
  89 --with-gss[=PFX]
  90         Enable GSSAPI authentication to IMAP servers. This should work with
  91         both MIT and Heimdal GSSAPI implementations - others haven't been
  92         tested. Note that the Cyrus SASL library also supports GSSAPI,
  93         and may be able to encrypt your session with it - you should use
  94         SASL instead if you can.
  95
  96 --with-ssl[=PFX]
  97         enable SSL support with IMAP and POP. SSL support requires you to
  98         have OpenSSL headers and libraries properly installed before
  99         compiling.  If the OpenSSL headers and libraries are not in the
 100         default system pats you can use the optional PFX argument to
 101         define the root directory of your installation.  The libraries
 102         are then expected to be found in PFX/lib and headers in
 103         PFX/include/openssl.
 104
 105 --with-sasl[=PFX]
 106         Use the Cyrus SASL library for IMAP or POP authentication. This
 107         library provides generic support for several authentication methods,
 108         and more may be added by the system administrator without recompiling
 109         Mutt-ng. SASL may also be able to encrypt your mail session even if
 110         SSL is not available.
 111
 112 --disable-nls
 113         This switch disables Mutt-ng's native language support.
 114
 115 --with-included-gettext
 116         Mutt-ng will be built using the GNU gettext library included in
 117         the intl/ sub-directory.  You may need to use this switch if
 118         your machine has something which looks like gettext to the
 119         configure script, but isn't able to cope with Mutt-ng's catalog
 120         files.
 121
 122 --with-regex
 123         use GNU regex instead of local regexp routines.  Many systems
 124         don't have the POSIX compliant regcomp/regexec/regfree
 125         routines, so this provides a way to support them.
 126
 127 --enable-flock
 128         use flock() to lock files.
 129
 130 --disable-fcntl
 131         by default, Mutt-ng uses fcntl() to lock files.  Over NFS this can
 132         result in poor performance on read/write.  Note that using this
 133         option could be dangerous if dotlocking is also disabled.
 134
 135 --enable-nfs-fix
 136         some implementations of NFS do not always write the
 137         atime/mtime of small files.  This means that Mutt-ng's ``mailboxes''
 138         feature does not always work properly, as it uses these
 139         attributes to work out whether the file has new mail.  This
 140         option enables a workaround to this bug.
 141
 142 --enable-locales-fix
 143         on some systems, the result of isprint() can't be used reliably
 144         to decide which characters are printable, even if you set the
 145         LANG environment variable.  If you set this option, Mutt-ng will
 146         assume all characters in the ISO-8859-* range are printable.  If
 147         you leave it unset, Mutt-ng will attempt to use isprint() if either
 148         of the environment variables LANG, LC_ALL or LC_CTYPE is set,
 149         and will revert to the ISO-8859-* range if they aren't.
 150         If you need --enable-locales-fix then you will probably need
 151         --without-wc-funcs too. However, on a correctly configured
 152         modern system you shouldn't need either (try setting LANG,
 153         LC_ALL or LC_CTYPE instead).
 154
 155 --without-wc-funcs
 156         by default Mutt-ng uses the functions mbrtowc(), wctomb() and
 157         wcwidth() provided by the system, when they are available.
 158         With this option Mutt-ng will use its own version of those
 159         functions, which should work with 8-bit display charsets, UTF-8,
 160         euc-jp or shift_jis, even if the system doesn't normally support
 161         those multibyte charsets.
 162
 163         If you find Mutt-ng is displaying non-ascii characters as octal
 164         escape sequences (e.g. \243), even though you have set LANG and
 165         LC_CTYPE correctly, then you might find you can solve the problem
 166         with either or both of --enable-locales-fix and --without-wc-funcs.
 167
 168 --with-exec-shell=SHELL
 169         on some versions of unix, /bin/sh has a bug that makes using emacs
 170         with Mutt-ng very difficult.  If you have the problem that whenever
 171         you press control-G in emacs, Mutt-ng and emacs become very confused,
 172         you may want to try using a Bourne-derived shell other than
 173         /bin/sh here.  Some shells that may work are bash, zsh, and ksh.
 174         C shells such as csh and tcsh will amost certainly not work right.
 175         Note that this option is unrelated to what shell Mutt-ng gives you
 176         when you press '!'.  Only use this option to solve the above problem,
 177         and only specify one of the above shells as its argument.
 178
 179         (If you encounter this problem with your platform's native
 180         Bourne shell, please send a short report to mutt-ng-devel@lists.berlios.de,
 181         so a short note on this topic can be added to the Platform notes
 182         section below.)
 183
 184 Once ``configure'' has completed, simply type ``make install.''
 185
 186 Mutt-ng should compile cleanly (without errors) and you should end up with a
 187 binary called ``muttng.''  If you get errors about undefined symbols like
 188 A_NORMAL or KEY_MIN, then you probably don't have a SysV compliant curses
 189 library.  You should install either ncurses or S-Lang (see above), and then
 190 run the ``configure'' script again.
 191
 192 Please note that "VPATH" builds currently do _not_ work.
 193
 194
 195
 196 Character set support
 197 =====================
 198
 199 Mutt-ng no longer contains functions for doing character set conversion.
 200 Instead, it expects the iconv functions (iconv_open, iconv,
 201 iconv_close) to be provided. Most up-to-date systems provide these
 202 functions, often as part of the C library. If you are installing Mutt-ng
 203 on a system which does not have them, it is recommended that you
 204 install Bruno Haible's portable libiconv library, which you can obtain
 205 from:
 206
 207                ftp://ftp.ilog.fr/pub/Users/haible/gnu/
 208
 209 Even if your system does provide the iconv functions, you might want
 210 to install libiconv, as some systems provide only a very limited
 211 version of iconv.
 212
 213
 214 If you decide to use your system's iconv implementation, you may
 215 need to tell Mutt-ng about implementation-defined names for some
 216 character sets.  Sample configuration files for various systems can
 217 be found in the directory contrib/iconv/ in this source
 218 distribution, and will be installed in the samples/iconv directory
 219 as part of Mutt-ng's documentation.
 220
 221 In order to use these sample configuration files, just put a line
 222 like
 223
 224      source /usr/local/doc/muttng/samples/iconv/iconv.osf1-4.0d.rc
 225
 226 into your system's global Muttrc, which normally resides in /etc or
 227 /usr/local/etc.
 228
 229
 230 If you really want to, you can configure Mutt-ng --disable-iconv, but
 231 there will then be no character set conversion.
 232
 233
 234 Platform Notes
 235 ==============
 236
 237 All platforms
 238
 239         There is a bug in most (if not all) S-Lang versions which
 240         prevents the Meta key from working with Mutt-ng.  A patch can
 241         be found in the file contrib/patch.slang-1.2.2.keypad.1 in
 242         this Mutt-ng distribution.
 243
 244
 245 Solaris 2.4
 246
 247         The system regcomp() and regexec() routines are very badly
 248         broken.  This should be automatically detected by the
 249         configure script.  If not, use the --with-regex switch when
 250         configuring Mutt-ng.
 251
 252         We are also hearing reports that Solaris 2.4's NLS libraries
 253         dump core with Mutt-ng when using a locale different from "C".
 254         Use the --with-included-gettext configuration switch if you
 255         experience this problem.
 256
 257         Color does not work right with Solaris curses.  You will
 258         have to compile with either ncurses or slang to get working
 259         color support.
 260
 261 Solaris 2.6
 262
 263         There are reports that Mutt-ng behaves strangely when linked with
 264         the system regexp library.  Please use the --with-regex switch
 265         when configuring on this platform.
 266
 267         For the real fix, applying Sun patches # 105490-05 (linker
 268         patch) and # 105210-17 (libc and malloc patch) from
 269         sunsolve.sun.com has been reported to stop these problems
 270         from occuring.
 271
 272 Linux
 273
 274         On recent Linux systems, flock() and fcntl() locks don't mix.  If
 275         you use the --enable-flock switch on such systems, be sure to
 276         give the --disable-fcntl argument as well.
 277
 278 Sparc Linux
 279
 280         Redhat 4.2 Sparc users reported problems with some system
 281         include files when building Mutt-ng.  Configuring Mutt-ng with the
 282         --disable-warnings switch is said to help against this problem.
 283
 284
 285 Digital Unix (OSF/1)
 286
 287         The system curses library is said to be badly broken.  Use GNU
 288         ncurses or SLang instead.
 289
 290 $Id: INSTALL,v 3.1 2002/11/25 14:16:46 roessler Exp $