
	How to install Wanderlust

		                       Time-stamp: <99/12/08 09:12:29 teranisi>
				       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.6 or later)
    * tm    (8.7 or later)

If you use Mule based on Emacs 19.28 before, please install tm.
SEMI does not support.

SEMI can support Mule based on Emacs 19.34.
See the following web page (written by Japanese).

   http://www.jpl.org/elips/INSTALL-SEMI-ja.html


(a) SEMI

  SEMI requires APEL, FLIM packages.
  We recommend the latest version of APEL, FLIM, SEMI.
  The required version and each ftp site are below.

    * APEL 9.22 or later	ftp://ftp.m17n.org/mule/apel/
    * FLIM 1.13.2 or later	ftp://ftp.m17n.org/mule/flim/
    * SEMI 1.13.6 or later	ftp://ftp.m17n.org/mule/semi/

  Please install APEL, FLIM, SEMI in order.
  Basically, do only 'make install'.

  To get full information, please refer README.en within each package.

(b) tm

  The tm ,whose version is 8.7 or later, is recommended.
  Please obtain from the following web site.

    * tm    http://www.m17n.org/FLIM/tm-8

  To get full information, please refer documentations within package.


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

(a) Edit Makefile

Edit EMACS, ELISPDIR, and so on in Makefile.

    EMACS     Emacs command name.
    ELISPDIR  site-lisp directory.

If ELISPDIR 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), 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.

In addition, if you want to use BBDB, please add directory of BBDB to
load-path and then install required modules.


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.

	% make package
	% make install-package

If the SEMI modules have been installed, package directory is automatically
detected. Of course, it can be configured by PACKAGEDIR in Makefile.


load-path
=========

If you are using Emacs or Mule, please add directory of Wanderlust to
load-path. If you install by default setting, you can write subdirs.el,
for example:

    (normal-top-level-add-to-load-path
     '("apel" "flim" "semi" "wl"))

If you are using Emacs 20.3 or later, or XEmacs, there are no need of
setting about load-path.


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/
directory. Please refer them.
To get full information, please read info file.
