2002-12-31 Ron Isaacson <Ron.Isaacson@morganstanley.com>
[elisp/wanderlust.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 4fa68e9..d19d9eb 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -5,66 +5,88 @@
                                        Yuuichi Teranishi,
                                        Tsunehiko Baba
 
-Required environment
-====================
+System Requirements
+===================
 
-  Before installing Wanderlust, please install either of the following
-  MIME modules. SEMI is recommended because it's more functional.
+  Wanderlust supports following Emacsen:
 
-       SEMI    (1.13.7 or later)
-       tm      (8.7 or later)
+       Mule 2.3 based on Emacs 19.34
+       Emacs 20.1 or later
+       XEmacs 20.4 or later
 
-  If you use Mule based on Emacs 19.28 or earlier, please install tm.
-  SEMI does not support Emacs 19.28 or earlier.
+  Before installing Wanderlust, please install the following MIME
+  modules.
 
-  SEMI only supports relatively new Emacsen like Emacs 20.xx, XEmacs, etc.
-  But Mule based on Emacs 19.34 can also run SEMI.
-  See the following web page to get more information (in Japanese).
+       SEMI    (1.14.3 or later)
+       FLIM    (1.14.3 or later)
 
-       http://www.jpl.org/elips/INSTALL-SEMI-ja.html
+  Wanderlust and MIME modules require APEL.  Before installing MIME
+  modules, please install the APEL.
 
+       APEL    (10.3 or later)
 
-(a) SEMI
 
-  SEMI requires APEL and FLIM packages.
-  Recommended combination of APEL, FLIM and SEMI are:
+Select MIME Module
+==================
 
-       APEL 10.3, FLIM 1.14.2 and SEMI 1.14.3
+  For each Emacsen, Recommended combination of MIME module package
+  follows.
 
-  You can download these packages from following URLs.
+  (a) XEmacs 21.1 or later
+
+       APEL 10.4, FLIM 1.14.5, SEMI 1.14.5
 
-       APEL:     ftp://ftp.m17n.org/pub/mule/apel/
-       FLIM:     ftp://ftp.m17n.org/pub/mule/flim/
-       SEMI:     ftp://ftp.m17n.org/pub/mule/semi/
+    Installation as a XEmacs package, If possible.
 
-  Please install APEL, FLIM, and SEMI, in that order.
-  Generally, 'make install' will do the job.
-  To get full information, please refer to the README.en within each package.
+  (b) Emacs 20.4 or later
 
-  You can also use many other FLIM/SEMI variants.
-  Combination of the latest versions should work.
-  For example, the following combinations are confirmed to work:
+       APEL 10.4, FLIM 1.14.5, SEMI 1.14.5
 
-       APEL 10.2, Chao 1.14.1, REMI 1.14.2
-       APEL 10.2, SLIM 1.14.3, EMY 1.13.9
+ (c) Emacs 20.1 to 20.3
 
-(b) tm
+       APEL 10.4, CLIME 1.14.5, SEMI 1.14.5
 
-  The tm, whose version is 8.7 or later, is recommended.  Please
-  obtain from the following web site.
+    Use CLIME instead of FLIM.  FLIM does not support Emacs 20.3 or
+    earlier.
 
-       http://cvs.m17n.org/tomo/comp/emacsen/tm/tm-8/
+  (d) Emacs 19.34 (Mule 2.3)
 
-  To get full information, please refer README.en within package.
+       APEL 10.4, CLIME 1.14.5, SEMI 1.14.5
 
-  tm-8.8 or earlier makes following error while compiling Wanderlust.
+    Mule based on Emacs 19.34 can also run SEMI.  See the following web
+    page to get more information (in Japanese).
+
+       http://www.jpl.org/elips/INSTALL-SEMI-ja.html
+
+
+Install MIME Module
+===================
+
+  You can download these packages from following URLs.
 
-       Use tm-8.x with APEL 10.2 or later.
+       APEL:   ftp://ftp.m17n.org/pub/mule/apel/
+       FLIM:   ftp://ftp.m17n.org/pub/mule/flim/
+       CLIME:  ftp://ftp.jpl.org/pub/m17n/
+       SEMI:   ftp://ftp.m17n.org/pub/mule/semi/
 
-  In this case, please install APEL 10.2 or later.
+  Please install APEL, FLIM(CLIME), and SEMI, in that order.  Generally,
+  'make install' will do the job.  To get full information, please refer
+  to the README.en within each package.
 
-       APEL:     ftp://ftp.m17n.org/pub/mule/apel/
+  You can also use many other FLIM/SEMI variants.  Combination of the
+  latest versions should work.  For example, the following combinations
+  are confirmed to work:
 
+       APEL 10.4, SLIM 1.14.9, SEMI 1.14.5
+       APEL 10.4, CLIME 1.14.5, EMIKO 1.14.1
+
+  You have to re-install Wanderlust if you upgraded APEL, FLIM, or SEMI.
+
+  Do following, running environment test included APEL, FLIM, and SEMI
+  version check.  You can specify the emacs command name.
+
+       % make check
+       % make EMACS=xemacs check
 
 Installation
 ============
@@ -86,8 +108,8 @@ Installation
        % make
        % make install
 
-  If you use Emacs without subdirs.el (e.g. Mule 2.3 based on Emacs
-  19.28), the following error message ocasinally appears.
+  If you use Emacs without subdirs.el, the following error message
+  occasionally appears.
 
        Cannot open load file: mime-setup
 
@@ -140,9 +162,6 @@ load-path
      '("apel" "flim" "semi" "wl"))
   --------------------------------------------------------------------
 
-  If you are using Emacs 19.28 or earlier, you can't use subdirs.el.
-  Please write setting about load-path in site configuration file.
-
 
 Manual
 ======
@@ -164,11 +183,16 @@ Sample configuration file
 
   Wanderlust requires the following three configuration files:
 
-       ~/.addresses    Address Book
-       ~/.folders      Folder Book
        ~/.wl           Wanderlust Configuration (loaded at startup)
+       ~/.folders      Folder Book
+       ~/.addresses    Address Book (optional)
 
   Each sample file (dot.addresses, dot.folders, dot.wl) exists on
   samples/en/ directory. Please refer to them.
 
   To get full information, please read Info file.
+
+
+Local Variables: 
+fill-column: 72
+End: