2 How to install Wanderlust
11 Before installing Wanderlust, please install either of the following
12 MIME modules. SEMI is recommended because it's more functional.
14 SEMI (1.14.1 or later)
17 SEMI requires APEL and FLIM packages. For each Emacsen, Recommended
18 combination of MIME module package following.
20 (a) XEmacs 21.1 or later
22 APEL 10.3, FLIM 1.14.3, SEMI 1.14.3
24 Installation as a XEmacs package, If possible.
26 (b) Emacs 20.4 or later
28 APEL 10.3, FLIM 1.14.3, SEMI 1.14.3
30 (c) Emacs 20.1 through 20.3
32 APEL 10.3, CLIME 1.14.3, SEMI 1.14.3
34 Use CLIME instead of FLIM. FLIM does not support Emacs 20.3 or
37 (d) Emacs 19.34 (Mule 2.3)
39 APEL 10.3, CLIME 1.14.3, SEMI 1.14.3
41 Mule based on Emacs 19.34 can also run SEMI. See the following web
42 page to get more information (in Japanese).
44 http://www.jpl.org/elips/INSTALL-SEMI-ja.html
46 (e) Emacs 19.28 or earlier (Mule 2.3, Nemacs)
48 APEL 10.3, CLIME 1.14.3, tm 8.8
50 If you use Mule based on Emacs 19.28 or earlier, please install tm.
51 SEMI does not support Emacs 19.28 or earlier. You need upgrade APEL
58 You can download these packages from following URLs.
60 APEL: ftp://ftp.m17n.org/pub/mule/apel/
61 FLIM: ftp://ftp.m17n.org/pub/mule/flim/
62 CLIME: ftp://ftp.jpl.org/pub/m17n/
63 SEMI: ftp://ftp.m17n.org/pub/mule/semi/
64 tm: http://cvs.m17n.org/tomo/comp/emacsen/tm/tm-8/
68 Please install APEL, FLIM(CLIME), and SEMI, in that order. Generally,
69 'make install' will do the job. To get full information, please refer
70 to the README.en within each package.
72 You can also use many other FLIM/SEMI variants. Combination of the
73 latest versions should work. For example, the following combinations
74 are confirmed to work:
76 APEL 10.2, Chao 1.14.1, REMI 1.14.2
77 APEL 10.2, SLIM 1.14.3, EMY 1.13.9
81 The tm, whose version is 8.7 or later, is recommended. To get full
82 information, please refer README.en within package.
84 tm-8.8 or earlier makes following error while compiling Wanderlust.
86 Use tm-8.x with APEL 10.2 or later.
88 In this case, please install APEL 10.2 or later.
96 Edit EMACS, LISPDIR, and so on in Makefile.
98 EMACS Emacs command name.
99 LISPDIR site-lisp directory.
101 If LISPDIR is not specified (or NONE by default), it is automatically
104 (b) Bytecompile and Install
111 If you use Emacs without subdirs.el (e.g. Mule 2.3 based on Emacs
112 19.28), the following error message ocasinally appears.
114 Cannot open load file: mime-setup
116 In this case, add directories of custom, APEL, FLIM, SEMI to
117 EMACSLOADPATH (environment variable), or add those directories to
121 Install as a XEmacs package
122 ===========================
124 Wanderlust is able to be installed as one of XEmacs (21.0 or later)
125 packages. After installation as a XEmacs package, you do not need
126 configurations of autoload, icon path in your own .emacs file.
130 Edit XEMACS, PACKAGEDIR, and so on in Makefile.
132 XEMACS XEmacs command name.
133 PACKAGEDIR package directory.
135 If PACKAGEDIR is not specified (NONE by default) and the SEMI
136 modules have been installed, it is automatically detected.
138 (b) Bytecompile and Install
143 % make install-package
145 Install with Info file.
151 If you are using Emacs 20.3 or later, or XEmacs, there is no need
154 If you are using Emacs 20.2 or earlier, please add the directory of
155 Wanderlust to load-path.
157 If you install by default setting, with Emacs 19.29 or later, Emacs
158 20.1, or Emacs 20.2, you can write subdirs.el for example:
160 --------------------------------------------------------------------
161 (normal-top-level-add-to-load-path
162 '("apel" "flim" "semi" "wl"))
163 --------------------------------------------------------------------
165 If you are using Emacs 19.28 or earlier, you can't use subdirs.el.
166 Please write setting about load-path in site configuration file.
172 Manual is described in Info format. Please do following.
177 If you install Wanderlust as a XEmacs package, Info file is already
178 installed too, so there are no need of these commands.
180 Manual directory is automatically detected. Of course, it can be
181 configured by INFODIR in Makefile.
183 And you can view manual on following URL:
185 http://www.gohome.org/wl/doc/wl_toc.html
188 Sample configuration file
189 =========================
191 Wanderlust requires the following three configuration files:
193 ~/.addresses Address Book
194 ~/.folders Folder Book
195 ~/.wl Wanderlust Configuration (loaded at startup)
197 Each sample file (dot.addresses, dot.folders, dot.wl) exists on
198 samples/en/ directory. Please refer to them.
200 To get full information, please read Info file.