Ignore zero length address petname
[wanderlust.git] / INSTALL.ja
blobd045ff23f72626e3c029b02021a04a1caa568a6c
2         Wanderlust のインストール方法
4                                         Kaoru Takahashi   高橋郁,
5                                         Yuuichi Teranishi 寺西裕一,
6                                         Tsunehiko Baba    馬場恒彦
8 必要条件
9 ========
11   Wanderlust がサポートする Emacsen を以下に示します。
13         Emacs 24.5 以降
15   Wanderlust を使うためには、以下に示すMIME用モジュールをインストールし
16   ておく必要があります。
18         SEMI-EPG
19         FLIM-LB
21   Wanderlust および MIME用モジュールを使うためには APEL-LB をインストールし
22   ておく必要があります。
25 MIME用モジュールのインストール
26 ==============================
28   パッケージはそれぞれ以下の URL で入手可能です。
30         APEL-LB:        https://github.com/wanderlust/apel
31         FLIM-LB:        https://github.com/wanderlust/flim
32         SEMI-EPG:       https://github.com/wanderlust/semi
34   APEL-LB, FLIM-LB, SEMI-EPG の順にインストールしてください。基本的にすべて
35   make install の実行で済むはずです。
37   詳しいインストールの方法は各パッケージに添付されているドキュメント 
38   (README.ja, README.en) を参照してください。
40   APEL-LB, FLIM-LB, SEMI-EPG のバージョンアップを行った場合は、
41   Wanderlust をインストールし直してください。
44 環境の確認
45 ==========
47   Wanderlust のインストールの前に環境の確認をすることを推奨します。
49         % make check
50   または
51         % make EMACS=xemacs check
53   で APEL, FLIM, SEMI のチェックを含んだ環境テストが行えます。
55   新しい APEL, FLIM, SEMI がインストールされていても、load-path 上に古い
56   ものが残っている場合にはトラブルの原因となります。load-path 上で重複し
57   たファイルを探すには M-x list-load-path-shadows が便利です。
60 通常のインストール
61 ==================
63 (a)Makefile, WL-CFG の編集
65   Makefile は、EMACS, LISPDIR の部分を編集してください。
67         EMACS     使用している Emacs のコマンド名を指定
68         LISPDIR   インストール先を指定
70   LISPDIR は特に指定しなくても (NONE のままでも) 自動的にインストール
71   先を検出します。
73   必要なら WL-CFG を編集してください。 INFO の言語の指定などができます。
75 (b)バイトコンパイル・インストール
77   以下を実行してください。
79         % make
80         % make install
82   このとき、subdirs.el のない Emacs では、
84         Cannot open load file: mime-setup
86   というエラーが出ることがあります。
88   この場合は、custom, APEL, FLIM, SEMI のインストール先を環境変数
89   EMACSLOADPATH に加えるか、展開ディレクトリの WL-CFG というファイル中
90   で load-path を通しておくとよいでしょう。
93 XEmacs のパッケージとしてインストール
94 =====================================
96   Wanderlust は XEmacs (21.0 以降) のパッケージのひとつとしてインストー
97   ルすることも可能です。パッケージとしてインストールすると、autoload 
98   の設定、アイコンのパス設定を個人の .emacs に記述しなくても 
99   Wanderlust を正常に起動できるようになります。
101 (a)Makefile, WL-CFG の編集
103   Makefile は、XEMACS, PACKAGEDIR の部分を編集してください。
105         XEMACS      使用している XEmacs のコマンド名を指定
106         PACKAGEDIR  package のディレクトリを指定
108   PACKAGEDIR は特に指定しなくても (NONE のままでも)、SEMI がインストー
109   ルされていれば自動的に検出されます。
111   必要なら WL-CFG を編集してください。 INFO の言語の指定などができます。
113 (b)バイトコンパイル・インストール
115   以下を実行してください。
117         % make package
118         % make install-package
120   Info ファイルも同時にインストールされます。
123 load-path の設定
124 ================
126   Emacs 20.3 以降もしくは XEmacs を使って普通にインストールした場合は、
127   load-path を設定する必要はありません。
129   Emacs 20.2 以前をお使いなら、Wanderlust を install した場所を
130   load-path に設定してください。
132   もし Emacs 19.29 以降または Emacs 20.1, Emacs 20.2 を使って初期設定
133   でインストールしたのなら、次のように subdirs.el を書くことができます。
135   --------------------------------------------------------------------
136     (normal-top-level-add-to-load-path
137      '("apel" "flim" "semi" "wl"))
138   --------------------------------------------------------------------
141 マニュアルのインストール
142 ========================
144   マニュアルは Info 形式です。インストールするには以下のことを実行して
145   ください。
147         % make info
148         % make install-info
150   XEmacs の package としてインストールした場合は自動的に Info ファイル
151   もインストールされるのでこれらの操作は必要ありません。
153   マニュアルのインストール先は自動検出されます。(Makefile 中の INFODIR 
154   でも設定可能です)
157 サンプル設定
158 ============
160   Wanderlust の設定ファイルには、
162     ~/.wl         Wanderlust の設定 (起動時に読み込まれる)
163     ~/.folders    フォルダ設定
164     ~/.addresses  アドレス帳 (無くても起動できる)
166   の三つがあります。
168   それぞれ、samples/ja/ ディレクトリの下にサンプル設定
169   (dot.addresses, dot.folders, dot.wl) がありますので、
170   各自でホームディレクトリにコピーして編集するなどしてください。
172   詳しい設定は Info を御覧ください。
175 Local Variables: 
176 fill-column: 72
177 End: