File: INSTALL

package info (click to toggle)
wl-beta 2.15.9+0.20190205-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 6,260 kB
  • sloc: lisp: 51,446; sh: 191; makefile: 141
file content (212 lines) | stat: -rw-r--r-- 5,145 bytes parent folder | download | duplicates (5)
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
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212

	How to install Wanderlust

					Kaoru Takahashi,
					Yuuichi Teranishi,
					Tsunehiko Baba

System Requirements
===================

  Wanderlust supports following Emacsen:

	Mule 2.3 based on Emacs 19.34
	Emacs 20.1 or later
	XEmacs 20.4 or later

  Before installing Wanderlust, please install the following MIME
  modules.

	SEMI	(1.14.6 or later)
	FLIM	(1.14.9 or later)

  Wanderlust and MIME modules require APEL.  Before installing MIME
  modules, please install the APEL.

	APEL	(10.6 or later)


Select MIME Module
==================

  For each Emacsen, recommended combination of MIME module package
  follows.

  (a) XEmacs 21.1 or later

	APEL 10.8, FLIM 1.14.9, SEMI 1.14.6

    Installation as a XEmacs package, if possible.

  (b) Emacs 20.4 or later

	APEL 10.8, FLIM 1.14.9, SEMI 1.14.6

  (c) Emacs 20.1 to 20.3

	APEL 10.8, CLIME 1.14.6, SEMI 1.14.6

    Use CLIME instead of FLIM.  FLIM does not support Emacs 20.3 or
    earlier.

  (d) Emacs 19.34 (Mule 2.3)

	APEL 10.8, CLIME 1.14.6, SEMI 1.14.6

    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.

	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/

  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.

  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.6, SLIM 1.14.9, SEMI 1.14.5
	APEL 10.6, CLIME 1.14.5, EMIKO 1.14.1

  You have to re-install Wanderlust if you upgraded APEL, FLIM, or SEMI.


Check Environment
=================

  Before going to the next step, we recommend you to run tests by

	% make check
  or
	% make EMACS=xemacs check

  to check running environment including the version of APEL, FLIM, and
  SEMI.  Note that even if you have installed new APEL/FLIM/SEMI, old
  ones in load-path may cause trouble.  To find duplicated files in the
  load-path, M-x list-load-path-shadows will help you.


Installation
============

(a) Edit Makefile, WL-CFG

  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.

  Edit WL-CFG if you need. You can specify language for INFO, etc.

(b) Bytecompile and Install

  Please do following.

	% make
	% make install

  If you use Emacs without subdirs.el, the following error message
  occasionally 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, WL-CFG

  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.

  Edit WL-CFG if you need. You can specify language for INFO, etc.

(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 is no need
  to set load-path.

  If you are using Emacs 20.2 or earlier, please add the 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"))
  --------------------------------------------------------------------


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 the following three configuration files:

	~/.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: