forked from wanderlust/wanderlust
-
Notifications
You must be signed in to change notification settings - Fork 1
/
INSTALL
174 lines (107 loc) · 4.48 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
How to install Wanderlust
Kaoru Takahashi,
Yuuichi Teranishi,
Tsunehiko Baba
Required environment
====================
Before installing Wanderlust, please install either of the following
MIME modules. SEMI is recommended because it's more functional.
SEMI (1.13.7 or later)
tm (8.7 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.
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 (written by Japanese).
http://www.jpl.org/elips/INSTALL-SEMI-ja.html
(a) SEMI
SEMI requires APEL and FLIM packages.
Recommended combination of APEL, FLIM and SEMI are:
APEL 10.2, FLIM 1.13.2 and SEMI 1.13.7
You can download these packages from following URLs.
APEL: ftp://ftp.m17n.org/mule/apel/
FLIM: ftp://ftp.m17n.org/mule/flim/
SEMI: ftp://ftp.m17n.org/mule/semi/
Please install APEL, FLIM, SEMI in order.
Generally 'make install' will do the job.
To get full information, please refer README.en within each package.
You can also use many other FLIM/SEMI variants.
Combination of the latest versions should work.
For example, following combination is confirmed to work.
APEL 10.2, Chao 1.14.1, REMI 1.14.2
APEL 10.2, SLIM 1.14.3, EMY 1.13.9
(b) tm
The tm, whose version is 8.7 or later, is recommended. Please
obtain from the following web site.
http://cvs.m17n.org/tomo/comp/emacsen/tm/tm-8/
To get full information, please refer README.en within package.
tm-8.8 or earlier makes following error while compiling Wanderlust.
Use tm-8.x with APEL 10.2 or later.
In this case, please install APEL 10.2 or later.
APEL: ftp://ftp.m17n.org/mule/apel/
Installation
============
(a) Edit Makefile
Edit EMACS, LISPDIR, and so on in Makefile.
EMACS Emacs command name.
LISPDIR site-lisp directory.
If LISPDIR is not specified (or NONE by default), it is automatically
detected.
(b) Bytecompile and Install
Please do following.
% 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.
Cannot open load file: mime-setup
In this case, add directories of custom, APEL, FLIM, SEMI to
EMACSLOADPATH (environment variable), or add those directories to
load-path in WL-CFG.
Install as a XEmacs package
===========================
Wanderlust is able to be installed as one of XEmacs (21.0 or later)
packages. After installation as a XEmacs package, you do not need
configurations of autoload, icon path in your own .emacs file.
(a) Edit Makefile
Edit XEMACS, PACKAGEDIR, and so on in Makefile.
XEMACS XEmacs command name.
PACKAGEDIR package directory.
If PACKAGEDIR is not specified (NONE by default) and the SEMI
modules have been installed, it is automatically detected.
(b) Bytecompile and Install
Please do following.
% make package
% make install-package
Install with Info file.
load-path
=========
If you are using Emacs 20.3 or later, or XEmacs, there are no need
of setting about load-path.
If you are using Emacs 20.2 or earlier, please add directory of
Wanderlust to load-path.
If you install by default setting, with Emacs 19.29 or later, Emacs
20.1, or Emacs 20.2, you can write subdirs.el for example:
--------------------------------------------------------------------
(normal-top-level-add-to-load-path
'("apel" "flim" "semi" "wl"))
--------------------------------------------------------------------
If you are using Emacs 19.28 or earlier, you can't use subdirs.el.
Please you write setting about load-path in site configuration file.
Manual
======
Manual is described in Info format. Please do following.
% make info
% make install-info
If you install Wanderlust as a XEmacs package, Info file is already
installed too, so there are no need of these commands.
Manual directory is automatically detected. Of course, it can be
configured by INFODIR in Makefile.
Sample configuration file
=========================
Wanderlust requires following three configuration files.
~/.addresses Address Book
~/.folders Folder Book
~/.wl Wanderlust Configuration (loaded at startup)
Each sample file (dot.addresses, dot.folders, dot.wl) exists on
samples/en/ directory. Please refer them.
To get full information, please read Info file.