2009-07-04 [paul] 3.7.2cvs1
[claws.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 1434f30470cdb96c04113166ef140f47b2eec8f1..f8786a804b73de0d7730a43f40d81ccf77645877 100644 (file)
--- a/INSTALL
+++ b/INSTALL
 Installation
 ============
 
-This program requires GTK+ 1.2.6 or higher to be compiled.
-
-This program is developed on Debian GNU/Linux (woody/sid)
-(Linux 2.4.x + glibc 2.2), so it is possible not to work correctly
-on the other environment.
-
-It is confirmed to work on the following environments:
-
-Linux
-
-o Debian GNU/Linux unstable (sid) (glibc 2.2.x)
-o Debian GNU/Linux testing (woody) (glibc 2.2.x)
-o Debian GNU/Linux 2.2 (potato) (glibc 2.1.3)
-o Kondara MNU/Linux (glibc 2.1.x)
-o Kondara MNU/Linux 1.2
-o Kondara MNU/Linux 2.0
-o Vine Linux 1.1 (glibc 2.0.x + libwcsmbs)
-o Vine Linux 2.0 (glibc 2.1.x) (Intel, PPC)
-o Vine Linux 2.1
-o Vine Linux 2.1.5
-o Laser5 Linux 6.0 (glibc 2.1.x)
-o Laser5 Linux 6.2 (glibc 2.1.x)
-o Laser5 Linux 6.4 (glibc 2.1.x)
-o TurboLinux 4.0 (glibc 2.0.7 + libwcsmbs)
-o TurboLinux 6.0 (glibc 2.1.2)
-o TurboLinux 7.0 (glibc 2.2.x)
-o Miracle Linux Standard Edition Version1.0
-o Miracle Linux for PostgreSQL Version1.0
-o Miracle Linux for Samba Version1.0
-o RedHat Linux 5.2 (glibc 2.0.7)
-o RedHat Linux 6.0
-o RedHat Linux 6.1 + Helix GNOME (glibc 2.1.x)
-o RedHat Linux 6.2 / 6.2J (glibc 2.1.x)
-o RedHat Linux 7.0 / 7.0J
-o RedHat Linux 7.1
-o RedHat Linux 7.2
-o LinuxPPC2000 + Yukikaze(Japanization kit)
-o Linux2000G (Intel / PPC)
-o HOLON Linux 2.0 (Intel / PPC)
-o Linux for PPC Japanese Edition 2.0 (glibc 2.1.x)
-o Linux for PPC Japanese Edition 3.0 (glibc 2.1.x)
-o LinuxPPC Q4 2000 (glibc 2.1.x)
-o Linux MLD4
-o Linux MLD5
-o Plamo Linux 2.0
-o Plamo Linux 2.1
-o Slackware 7.0
-o Slackware 7.1
-o Slackware 8.0
-o Linux Mandrake 7.0
-o Linux Mandrake 7.1
-o Linux Mandrake 7.2
-o Linux Mandrake 8.0
-o Linux Mandrake 8.1
-o SuSE Linux 6.3 (glibc 2.1.2)
-o SuSE Linux 6.4
-o SuSE Linux 7.0
-o SuSE Linux 7.1
-o SuSE Linux 7.2
-o SuSE Linux 7.3
-o OpenLinux 2.3 (glibc 2.1.1 -> 2.1.3)
-o Caldera OpenDesktop 2.4
-o Caldera Workstation 3.1
-o Conectiva Linux 4.0
-o Conectiva Linux 5.0
-o Vector Linux 1.5
-o Yellow Dog Linux 2.0 (glibc 2.2.1)
-o Yellow Dog Linux 2.1 (PowerPC)
-o ASP Linux 7.2 (glibc 2.2.4)
-
-BSD
-
-o FreeBSD 3.2-RELEASE
-o FreeBSD 3.4-RELEASE
-o FreeBSD 4.0-RELEASE
-o FreeBSD 4.1-RELEASE
-o FreeBSD 4.2-RELEASE
-o FreeBSD 4.3-RELEASE
-o FreeBSD 4.4-RELEASE
-o FreeBSD 5.0-CURRENT
-o NetBSD 1.4.2
-o NetBSD 1.5 + XPG4DL
-o NetBSD 1.5.1
-o NetBSD 1.5.2
-o OpenBSD 2.7
-o OpenBSD 2.8 (i386)
-o OpenBSD 2.9
-o OpenBSD 3.0
-o BSD/OS 4.0.1
-
-Other commercial Unix
-
-o Solaris 2.5
-o Solaris 2.5.1
-o Solaris 2.6
-o Solaris 7
-o Solaris 8
-o IRIX 6.3
-o IRIX 6.4
-o IRIX 6.5 6.5.8m
-o HP-UX 10.20
-o HP-UX 11.0
-o HP-UX 11i
-o Tru64 Unix 5.0 (OSF1 V5.0)
-o SCO UnixWare 7
-o Mac OS X 10.1.2 (Darwin 5.2) + XDarwin (has locale problem)
-
-Others
-
-o Windows (cygwin + GTK+ for win32) (unstable)
+This program requires GTK+ 2.6.0 or higher to be compiled.
 
 Build it
 ========
 
-For installation, just type:
+Please make sure that gtk-devel and glib-devel (or similar) packages are
+installed before the compilation (you may also require flex (lex) and bison
+(yacc)).
+
+To compile and install, just type:
 
 % ./configure
 % make
@@ -123,45 +18,84 @@ For installation, just type:
 Password: [Enter password]
 # make install
 
-Additional libraries
-====================
+To run, just type:
 
-I recommend you to install gdk-pixbuf or gdk_imlib library before installing
-for built-in image view support, and compface library for X-Face support.
+% claws-mail
 
-You can get compface utilities and library from the following location:
-
-  http://freshmeat.net/projects/compface/
-
-Sylpheed supports US-ASCII, ISO-8859-1, and EUC-JP by default.
-If you want other character set / encoding (such as UTF-8, KOI8-R, and GB2312)
-to be supported, you have to install libjconv, which is a wrapper for
-iconv(). You can obtain it from the following location:
-
-  http://www.kondara.org/libjconv/index.html
-
-If you want to enable SSL support, append the option
---enable-ssl after ./configure (you need OpenSSL).
-
-If you want to enable IPv6 support, append the option
---enable-ipv6 after ./configure.
-
-If you want to enable GnuPG support, you need GPGME 0.2.3 or later, and
-GnuPG 1.0.6 or later. You can get them from the following location:
-
-  ftp://ftp.gnupg.org/pub/gcrypt/alpha/gpgme/
-  ftp://ftp.gnupg.org/pub/gcrypt/gnupg/
-
-and append the option --enable-gpgme after ./configure.
-
-WARNING: the GnuPG support is still in the development stage, and it
-         may not work correctly. I suggest never to use a real key.
-         Please use sample keys.
+Additional libraries
+====================
+only needed if you require the additional functionality
+
+Bogofilter
+    for Bogofilter plugin support
+    http://bogofilter.sourceforge.net/
+compface
+    for X-Face support
+    http://freshmeat.net/projects/compface/
+D-Bus
+    for interprocess communication support
+    http://www.freedesktop.org/wiki/Software/dbus
+Dillo (>= 0.7.0)
+    for Dillo HTML viewer plugin support
+    http://www.dillo.org/
+Enchant (and dictionaries)
+    for spell-checker support
+    http://www.abisource.com/enchant/
+GnuPG (>= 1.2.1) and GPGME (>=  0.4.5)
+    for GnuPG and S/MIME plugin support
+    http://www.gnupg.org/
+    ftp://ftp.gnupg.org/gcrypt/gpgme/
+J-Pilot
+    for J-Pilot support
+    http://www.jpilot.org/
+libEtPan! (>= 0.57)
+    for IMAP4 and NNTP support
+    http://www.etpan.org
+GTK+ >= 2.10 or libgnomeprint (>= 2.2)
+    for extended printing support
+    http://www.gnome.org
+Network Manager
+    for support for detection of network connection changes
+    http://www.gnome.org/projects/NetworkManager/
+OpenLDAP (>= 2.0.7)
+    for LDAP support
+    http://www.openldap.org/
+GnuTLS (>= 0.4.2)
+    for SSL support
+    http://www.gnu.org/software/gnutls/
+SpamAssassin
+    for SpamAssassin plugin support
+    http://spamassassin.apache.org/
+
+Options for configure script
+============================
+Most options are automatically enabled if the dependencies
+are matched.
+
+  --with-config-dir=RCDIR                  local config dir (default: ~/.claws-mail)
+  --disable-compface               disable compface (X-Face) support
+  --disable-ipv6                   disable IPv6 support
+  --disable-gnutls                 disable GnuTLS support
+  --disable-libetpan               disable IMAP4 and NNTP support
+  --disable-gnomeprint             disable libgnomeprint support
+  --disable-enchant                disable Enchant support
+  --disable-ldap                           disable LDAP support
+  --disable-jpilot                         disable JPilot support
+  --disable-startup-notification    disable startup notification support
+  --disable-valgrind                disable valgrind support for debugging
+ --enable-crash-dialog             enable crash dialog
+  --disable-startup-notification    disable startup notification support
+  --disable-trayicon-plugin         do not build System Tray Icon plugin
+  --disable-spamassassin-plugin     do not build SpamAssassin plugin
+  --disable-pgpcore-plugin         do not build PGP/Core plugin
+  --disable-pgpmime-plugin          do not build PGP/MIME plugin
+  --disable-pgpinline-plugin        do not build PGP/Inline plugin
+  --disable-smime-plugin            do not build S/Mime plugin
+  --disable-dillo-viewer-plugin     do not build Dillo plugin
+  --disable-bogofilter-plugin       do not build bogofilter plugin
+  --disable-manual                 do not build user manuals
+  --disable-nls                    do not use Native Language Support
 
 For other options, refer to ./configure --help .
 
 
-If the installation of Sylpheed failed, check all needed libraries are
-correctly installed. If it still failed, please send bug report to:
-
-  Hiroyuki Yamamoto <hiro-y@kcn.ne.jp>