-
Notifications
You must be signed in to change notification settings - Fork 0
/
wl.html
12230 lines (11524 loc) · 835 KB
/
wl.html
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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.1, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Wanderlust – Yet Another Message Interface On Emacsen –</title>
<meta name="description" content="Wanderlust – Yet Another Message Interface On Emacsen –">
<meta name="keywords" content="Wanderlust – Yet Another Message Interface On Emacsen –">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="#Top" rel="start" title="Top">
<link href="#Index" rel="index" title="Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="dir.html#Top" rel="up" title="(dir)">
<link href="#Introduction" rel="next" title="Introduction">
<link href="dir.html#Top" rel="prev" title="(dir)">
<style type="text/css">
<!--
a.copiable-link {visibility: hidden; text-decoration: none; line-height: 0em}
a.summary-letter-printindex {text-decoration: none}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
kbd.kbd {font-style: oblique}
kbd.key {font-style: normal}
p.flushright-paragraph {text-align:right}
pre.display-preformatted {font-family: inherit}
span.r {font-family: initial; font-weight: normal; font-style: normal}
span:hover a.copiable-link {visibility: visible}
td.printindex-index-entry {vertical-align: top}
td.printindex-index-section {vertical-align: top; padding-left: 1em}
th.entries-header-printindex {text-align:left}
th.sections-header-printindex {text-align:left; padding-left: 1em}
ul.mark-bullet {list-style-type: disc}
ul.mark-minus {list-style-type: "\2212"}
ul.toc-numbered-mark {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="janix-texinfo.css">
</head>
<body lang="en">
<p>This file documents Wanderlust, Yet another message interface on
Emacsen.
</p>
<p>Copyright © 1998, 1999, 2000, 2001, 2002 Yuuichi Teranishi<!-- /@w -->,
Fujikazu Okunishi<!-- /@w -->, Masahiro Murata<!-- /@w -->, Kenichi Okada<!-- /@w -->,
Kaoru Takahashi<!-- /@w -->, Bun Mizuhara<!-- /@w --> and Masayuki Osada<!-- /@w -->,
Katsumi Yamaoka<!-- /@w -->, Hiroya Murata<!-- /@w --> and Yoichi Nakayama<!-- /@w -->.
</p>
<p>This edition is for Wanderlust version 2.15.9.
</p>
<p>Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
</p>
<p>Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
</p>
<p>Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions.
</p>
<div class="top-level-extent" id="Top">
<div class="nav-panel">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction of Wanderlust</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h1 class="top" id="Wanderlust-User_0027s-Manual"><span>Wanderlust User’s Manual<a class="copiable-link" href="#Wanderlust-User_0027s-Manual"> ¶</a></span></h1>
<div class="flushright"><p class="flushright-paragraph">Yuuichi Teranishi
Fujikazu Okunishi
Masahiro Murata
Kenichi Okada
Kaoru Takahashi
Bun Mizuhara
Masayuki Osada
Katsumi Yamaoka
Hiroya Murata
Yoichi Nakayama
</p></div>
<p>This manual is for Wanderlust 2.15.9.
</p>
<div class="element-shortcontents" id="SEC_Shortcontents">
<h2 class="shortcontents-heading">Short Table of Contents</h2>
<div class="shortcontents">
<ul class="toc-numbered-mark">
<li><a id="stoc-Introduction-of-Wanderlust" href="#toc-Introduction-of-Wanderlust">1 Introduction of Wanderlust</a></li>
<li><a id="stoc-Start-up-Wanderlust" href="#toc-Start-up-Wanderlust">2 Start up Wanderlust</a></li>
<li><a id="stoc-Wanderlust_0027s-folders" href="#toc-Wanderlust_0027s-folders">3 Wanderlust’s folders</a></li>
<li><a id="stoc-Folder-mode" href="#toc-Folder-mode">4 Folder mode</a></li>
<li><a id="stoc-Summary-Mode" href="#toc-Summary-Mode">5 Summary Mode</a></li>
<li><a id="stoc-Message-Buffer" href="#toc-Message-Buffer">6 Message Buffer</a></li>
<li><a id="stoc-Draft-Buffer" href="#toc-Draft-Buffer">7 Draft Buffer</a></li>
<li><a id="stoc-Off_002dline-Management" href="#toc-Off_002dline-Management">8 Off-line Management</a></li>
<li><a id="stoc-Automatic-Expiration-and-Archiving-of-Messages" href="#toc-Automatic-Expiration-and-Archiving-of-Messages">9 Automatic Expiration and Archiving of Messages</a></li>
<li><a id="stoc-Score-of-the-Messages" href="#toc-Score-of-the-Messages">10 Score of the Messages</a></li>
<li><a id="stoc-Address-Book-1" href="#toc-Address-Book-1">11 Address Book</a></li>
<li><a id="stoc-Quick-Search-1" href="#toc-Quick-Search-1">12 Quick Search</a></li>
<li><a id="stoc-Spam-Filter-1" href="#toc-Spam-Filter-1">13 Spam Filter</a></li>
<li><a id="stoc-Advanced-Issues-1" href="#toc-Advanced-Issues-1">14 Advanced Issues</a></li>
<li><a id="stoc-Switch-from-older-version-of-Wanderlust" href="#toc-Switch-from-older-version-of-Wanderlust">15 Switch from older version of Wanderlust</a></li>
<li><a id="stoc-Terminology-around-Wanderlust" href="#toc-Terminology-around-Wanderlust">16 Terminology around Wanderlust</a></li>
<li><a id="stoc-Wanderlust-Mailing-List" href="#toc-Wanderlust-Mailing-List">17 Wanderlust Mailing List</a></li>
<li><a id="stoc-Additional-Information" href="#toc-Additional-Information">18 Additional Information</a></li>
<li><a id="stoc-Index-1" href="#toc-Index-1">Index</a></li>
</ul>
</div>
</div>
<div class="element-contents" id="SEC_Contents">
<h2 class="contents-heading">Table of Contents</h2>
<div class="contents">
<ul class="toc-numbered-mark">
<li><a id="toc-Introduction-of-Wanderlust" href="#Introduction">1 Introduction of Wanderlust</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Environment" href="#Environment">1.1 Environment</a></li>
</ul></li>
<li><a id="toc-Start-up-Wanderlust" href="#Start-Me-Up">2 Start up Wanderlust</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Installing-MIME-modules" href="#MIME-Modules">2.1 Installing MIME modules</a></li>
<li><a id="toc-Download-and-Extract-the-Package" href="#Download">2.2 Download and Extract the Package</a>
<ul class="toc-numbered-mark">
<li><a id="toc-To-use-SSL-_0028Secure-Socket-Layer_0029" href="#To-use-SSL-_0028Secure-Socket-Layer_0029">2.2.1 To use SSL (Secure Socket Layer)</a></li>
</ul></li>
<li><a id="toc-Byte_002dcompile-and-install" href="#Install">2.3 Byte-compile and install</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Installation" href="#Installation">2.3.1 Installation</a></li>
<li><a id="toc-WL_002dCFG" href="#WL_002dCFG">2.3.2 <samp class="file">WL-CFG</samp></a></li>
<li><a id="toc-Run-in-place" href="#Run-in-place">2.3.3 Run in place</a></li>
<li><a id="toc-Manual" href="#Manual">2.3.4 Manual</a></li>
</ul></li>
<li><a id="toc-Set-up-_002eemacs" href="#Minimal-Settings">2.4 Set up .emacs</a>
<ul class="toc-numbered-mark">
<li><a id="toc-mail_002duser_002dagent" href="#mail_002duser_002dagent">2.4.1 <code class="code">mail-user-agent</code></a></li>
</ul></li>
<li><a id="toc-Folder-Definition-1" href="#Folder-Definition">2.5 Folder Definition</a></li>
<li><a id="toc-Start-Wanderlust-1" href="#Start-Wanderlust">2.6 Start Wanderlust</a></li>
<li><a id="toc-Overview-1" href="#Overview">2.7 Overview</a></li>
</ul></li>
<li><a id="toc-Wanderlust_0027s-folders" href="#Folders">3 Wanderlust’s folders</a>
<ul class="toc-numbered-mark">
<li><a id="toc-IMAP-Folder-1" href="#IMAP-Folder">3.1 IMAP Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-International-mailbox-names-_0028Modified-UTF7_0029" href="#International-mailbox-names-_0028Modified-UTF7_0029">3.1.1 International mailbox names (Modified UTF7)</a></li>
</ul></li>
<li><a id="toc-NNTP-Folder-1" href="#NNTP-Folder">3.2 NNTP Folder</a></li>
<li><a id="toc-MH-Folder-1" href="#MH-Folder">3.3 MH Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Variables-About-MH-Folder" href="#Localdir-Vars">3.3.1 Variables About MH Folder</a></li>
</ul></li>
<li><a id="toc-Maildir-Folder-1" href="#Maildir-Folder">3.4 Maildir Folder</a></li>
<li><a id="toc-News-Spool-Folder-1" href="#News-Spool-Folder">3.5 News Spool Folder</a></li>
<li><a id="toc-Archive-Folder-1" href="#Archive-Folder">3.6 Archive Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Supported-Archives" href="#Archiver">3.6.1 Supported Archives</a></li>
<li><a id="toc-OS-specific-information-about-archiver" href="#OS-specific-information-about-archiver">3.6.2 OS specific information about archiver</a></li>
<li><a id="toc-TIPS" href="#Archive-Tips">3.6.3 TIPS</a></li>
<li><a id="toc-Variables-About-Archive-Folder" href="#Archive-Vars">3.6.4 Variables About Archive Folder</a></li>
</ul></li>
<li><a id="toc-POP-Folder-1" href="#POP-Folder">3.7 POP Folder</a></li>
<li><a id="toc-Shimbun-Folder-1" href="#Shimbun-Folder">3.8 Shimbun Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Variables-About-Shimbun-Folder" href="#Variables-About-Shimbun-Folder">3.8.1 Variables About Shimbun Folder</a></li>
</ul></li>
<li><a id="toc-RSS-Folder-1" href="#RSS-Folder">3.9 RSS Folder</a></li>
<li><a id="toc-Search-Folder-1" href="#Search-Folder">3.10 Search Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Supported-search-engines" href="#Supported-search-engines">3.10.1 Supported search engines</a></li>
<li><a id="toc-namazu-1" href="#namazu">3.10.2 namazu</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Enter-space-to-separate-keywords" href="#Enter-space-to-separate-keywords">3.10.2.1 Enter space to separate keywords</a></li>
<li><a id="toc-Alias-name-for-index" href="#Alias-name-for-index">3.10.2.2 Alias name for index</a></li>
<li><a id="toc-Multiple-indices" href="#Multiple-indices">3.10.2.3 Multiple indices</a></li>
</ul></li>
<li><a id="toc-grep-1" href="#grep">3.10.3 grep</a></li>
<li><a id="toc-rgrep-1" href="#rgrep">3.10.4 rgrep</a></li>
<li><a id="toc-mu-1" href="#mu">3.10.5 mu</a></li>
<li><a id="toc-notmuch-1" href="#notmuch">3.10.6 notmuch</a></li>
</ul></li>
<li><a id="toc-Multi-Folder-1" href="#Multi-Folder">3.11 Multi Folder</a></li>
<li><a id="toc-Filter-Folder-1" href="#Filter-Folder">3.12 Filter Folder</a></li>
<li><a id="toc-Pipe-Folder-1" href="#Pipe-Folder">3.13 Pipe Folder</a></li>
<li><a id="toc-Internal-folder" href="#Internal-Folder">3.14 Internal folder</a></li>
<li><a id="toc-File-folder" href="#File-Folder">3.15 File folder</a></li>
<li><a id="toc-Access-folder" href="#Access-Folder">3.16 Access folder</a></li>
</ul></li>
<li><a id="toc-Folder-mode" href="#Folder">4 Folder mode</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Selecting-Folder-1" href="#Selecting-Folder">4.1 Selecting Folder</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Usage-_0028TIPS_0029" href="#Usage-_0028TIPS_0029">4.1.1 Usage (TIPS)</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Check-new_002c-unread-number" href="#Check-new_002c-unread-number">4.1.1.1 Check new, unread number</a></li>
<li><a id="toc-Select-Folder" href="#Select-Folder">4.1.1.2 Select Folder</a></li>
</ul></li>
<li><a id="toc-Key-bindings" href="#Key-bindings">4.1.2 Key bindings</a></li>
<li><a id="toc-Customize-variables" href="#Customize-variables">4.1.3 Customize variables</a></li>
</ul></li>
<li><a id="toc-Editing-Folders" href="#Folder-Manager">4.2 Editing Folders</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Usage-_0028Tips_0029" href="#Usage-_0028Tips_0029">4.2.1 Usage (Tips)</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Append-Folder" href="#Append-Folder">4.2.1.1 Append Folder</a></li>
<li><a id="toc-Edit-Folder" href="#Edit-Folder">4.2.1.2 Edit Folder</a></li>
<li><a id="toc-Create-Multi-Folder" href="#Create-Multi-Folder">4.2.1.3 Create Multi Folder</a></li>
<li><a id="toc-Delete-Nickname_002c-Filter" href="#Delete-Nickname_002c-Filter">4.2.1.4 Delete Nickname, Filter</a></li>
<li><a id="toc-Append-Folder-to-Empty-Group" href="#Append-Folder-to-Empty-Group">4.2.1.5 Append Folder to Empty Group</a></li>
<li><a id="toc-Charset-of-the-Folders-File" href="#Charset-of-the-Folders-File">4.2.1.6 Charset of the Folders File</a></li>
<li><a id="toc-Create-Filter" href="#Create-Filter">4.2.1.7 Create Filter</a></li>
<li><a id="toc-Sort-Folders" href="#Sort-Folders">4.2.1.8 Sort Folders</a></li>
<li><a id="toc-Hiding-Folders-in-the-Access-Group" href="#Hiding-Folders-in-the-Access-Group">4.2.1.9 Hiding Folders in the Access Group</a></li>
<li><a id="toc-Operations-in-the-Access-Group" href="#Operations-in-the-Access-Group">4.2.1.10 Operations in the Access Group</a></li>
</ul></li>
<li><a id="toc-Key-bindings-1" href="#Key-bindings-1">4.2.2 Key bindings</a></li>
<li><a id="toc-Customize-variables-1" href="#Customize-variables-1">4.2.3 Customize variables</a></li>
<li><a id="toc-Miscellanea" href="#Miscellanea">4.2.4 Miscellanea</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Summary-Mode" href="#Summary">5 Summary Mode</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Usage-_0028Tips_0029-1" href="#Usage-of-Summary-Mode">5.1 Usage (Tips)</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Summary-Content" href="#Summary-Content">5.1.1 Summary Content</a></li>
<li><a id="toc-Temporary-Marks" href="#Temporary-Marks">5.1.2 Temporary Marks</a></li>
<li><a id="toc-Persistent-Marks" href="#Persistent-Marks">5.1.3 Persistent Marks</a></li>
<li><a id="toc-How-To-Read" href="#How-To-Read">5.1.4 How To Read</a></li>
<li><a id="toc-Pack-the-Message-Numbers" href="#Pack-the-Message-Numbers">5.1.5 Pack the Message Numbers</a></li>
</ul></li>
<li><a id="toc-Thread-Operations-1" href="#Thread-Operations">5.2 Thread Operations</a>
<ul class="toc-numbered-mark">
<li><a id="toc-reconstruct-thread-by-hand" href="#reconstruct-thread-by-hand">5.2.1 reconstruct thread by hand</a></li>
</ul></li>
<li><a id="toc-Cache-1" href="#Cache">5.3 Cache</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Cache-File" href="#Cache-File">5.3.1 Cache File</a></li>
<li><a id="toc-Cache-Filename" href="#Cache-Filename">5.3.2 Cache Filename</a></li>
<li><a id="toc-Buffer-Cache-and-Prefetching" href="#Buffer-Cache-and-Prefetching">5.3.3 Buffer Cache and Prefetching</a></li>
</ul></li>
<li><a id="toc-Auto-Refile-1" href="#Auto-Refile">5.4 Auto Refile</a></li>
<li><a id="toc-Sticky-Summary-1" href="#Sticky-Summary">5.5 Sticky Summary</a></li>
<li><a id="toc-Format-of-summary-lines" href="#Summary-View">5.6 Format of summary lines</a>
<ul class="toc-numbered-mark">
<li><a id="toc-on-the-format-for-sender-name" href="#on-the-format-for-sender-name">5.6.1 on the format for sender name</a></li>
</ul></li>
<li><a id="toc-Temporary-marks-and-their-effect" href="#Mark-and-Action">5.7 Temporary marks and their effect</a></li>
<li><a id="toc-Key-bindings-2" href="#Key-Bindings-of-Summary">5.8 Key bindings</a></li>
<li><a id="toc-Customiziable-variables" href="#Variables-of-Summary">5.9 Customiziable variables</a></li>
</ul></li>
<li><a id="toc-Message-Buffer" href="#Message">6 Message Buffer</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Key-Bindings" href="#Key-Bindings">6.1 Key Bindings</a></li>
<li><a id="toc-Customizable-Variables-1" href="#Customizable-Variables-1">6.2 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Draft-Buffer" href="#Draft">7 Draft Buffer</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Tips" href="#Usage-of-Draft-Mode">7.1 Tips</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Parameters-for-Sending-1" href="#Parameters-for-Sending">7.1.1 Parameters for Sending</a></li>
<li><a id="toc-Editing-Message-Header" href="#Editing-Header">7.1.2 Editing Message Header</a></li>
<li><a id="toc-Editing-Messages-and-Sending" href="#Editing-Message-Body-and-Sending">7.1.3 Editing Messages and Sending</a></li>
<li><a id="toc-Dynamic-Modification-of-Messages" href="#Dynamical-Message-Re_002darrangement">7.1.4 Dynamic Modification of Messages</a></li>
<li><a id="toc-Inserting-Templates" href="#Template">7.1.5 Inserting Templates</a></li>
<li><a id="toc-Sending-mail-by-POP_002dbefore_002dSMTP" href="#POP_002dbefore_002dSMTP">7.1.6 Sending mail by POP-before-SMTP</a></li>
</ul></li>
<li><a id="toc-Key-Bindings-1" href="#Key-Bindings-of-Draft">7.2 Key Bindings</a></li>
<li><a id="toc-Customizable-Variables-2" href="#Variables-of-Draft-Mode">7.3 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Off_002dline-Management" href="#Disconnected-Operations">8 Off-line Management</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Off_002dline-State-1" href="#Off_002dline-State">8.1 Off-line State</a></li>
<li><a id="toc-Enable-Disconeected-Operations" href="#Enable-Operations">8.2 Enable Disconeected Operations</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Transmission-of-Messages" href="#Send-Messages-off_002dline">8.2.1 Transmission of Messages</a></li>
<li><a id="toc-Re_002dfile-and-Copy-_0028IMAP4_0029" href="#Re_002dfile-and-Copy-queue">8.2.2 Re-file and Copy (IMAP4)</a></li>
<li><a id="toc-Creation-of-Folders-_0028IMAP4_0029" href="#Creation-of-Folders">8.2.3 Creation of Folders (IMAP4)</a></li>
<li><a id="toc-Marking-_0028IMAP4_0029" href="#Marking">8.2.4 Marking (IMAP4)</a></li>
<li><a id="toc-Pre_002dfetching" href="#Pre_002dfetching-Reservations">8.2.5 Pre-fetching</a></li>
</ul></li>
<li><a id="toc-Switching-On_002dline_002fOff_002dline-per-Server_002fPort" href="#Plugged-Mode">8.3 Switching On-line/Off-line per Server/Port</a></li>
<li><a id="toc-Invoking-Wanderlust-in-the-Off_002dline-State" href="#Off_002dline-State-settings">8.4 Invoking Wanderlust in the Off-line State</a></li>
<li><a id="toc-Customizable-Variables-3" href="#Variables-of-Plugged-Mode">8.5 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Automatic-Expiration-and-Archiving-of-Messages" href="#Expire-and-Archive">9 Automatic Expiration and Archiving of Messages</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Expiration" href="#Expire">9.1 Expiration</a></li>
<li><a id="toc-How-to-Use" href="#How-to-Use">9.2 How to Use</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Configuring-wl_002dexpire_002dalist" href="#Configuring-wl_002dexpire_002dalist">9.2.1 Configuring <code class="code">wl-expire-alist</code></a></li>
<li><a id="toc-Treatment-for-Important-or-Unread-Messages" href="#Treatment-for-Important-or-Unread-Messages">9.2.2 Treatment for Important or Unread Messages</a></li>
<li><a id="toc-Auto-Expiration" href="#Auto-Expiration">9.2.3 Auto Expiration</a></li>
</ul></li>
<li><a id="toc-Tips-1" href="#Tips-1">9.3 Tips</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Treating-archive-folders" href="#Treating-archive-folders">9.3.1 Treating archive folders</a></li>
<li><a id="toc-Confirming" href="#Confirming">9.3.2 Confirming</a></li>
<li><a id="toc-Re_002dfiling-Reserved-Messages" href="#Re_002dfiling-Reserved-Messages">9.3.3 Re-filing Reserved Messages</a></li>
</ul></li>
<li><a id="toc-Customizable-Variables-4" href="#Customizable-Variables-4">9.4 Customizable Variables</a></li>
<li><a id="toc-Archiving-Messages" href="#Archive">9.5 Archiving Messages</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Archiving-Messages-1" href="#Archiving-Messages-1">9.5.1 Archiving Messages</a></li>
<li><a id="toc-Customizable-Variables-5" href="#Customizable-Variables-5">9.5.2 Customizable Variables</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Score-of-the-Messages" href="#Scoring">10 Score of the Messages</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Score-Commands-1" href="#Score-Commands">10.1 Score Commands</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Score-File-Specification" href="#Score-File-Specification">10.1.1 Score File Specification</a></li>
<li><a id="toc-Scored-Messages" href="#Scored-Messages">10.1.2 Scored Messages</a></li>
<li><a id="toc-Creation-of-Score-Files" href="#Creation-of-Score-Files">10.1.3 Creation of Score Files</a></li>
<li><a id="toc-Tips-2" href="#Tips-2">10.1.4 Tips</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Selecting-Score-Files" href="#Selecting-Score-Files">10.1.4.1 Selecting Score Files</a></li>
<li><a id="toc-Summing-Up-the-Score" href="#Summing-Up-the-Score">10.1.4.2 Summing Up the Score</a></li>
<li><a id="toc-Creating-Thread-Key" href="#Creating-Thread-Key">10.1.4.3 Creating Thread Key</a></li>
<li><a id="toc-Creating-Followup-Key" href="#Creating-Followup-Key">10.1.4.4 Creating Followup Key</a></li>
</ul></li>
<li><a id="toc-Key-Bindings-2" href="#Key-Bindings-2">10.1.5 Key Bindings</a></li>
<li><a id="toc-Key-Bindings-in-the-Score-Editing-Buffer" href="#Key-Bindings-in-the-Score-Editing-Buffer">10.1.6 Key Bindings in the Score Editing Buffer</a></li>
<li><a id="toc-Customizable-Variables-6" href="#Customizable-Variables-6">10.1.7 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Score-File-Format-1" href="#Score-File-Format">10.2 Score File Format</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Caveats" href="#Caveats">10.2.1 Caveats</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Address-Book-1" href="#Address-Book">11 Address Book</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Address-book" href="#Mail-Addresses">11.1 Address book</a></li>
<li><a id="toc-Address-Manager-1" href="#Address-Manager">11.2 Address Manager</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Key-Bindings-3" href="#Key-Bindings-3">11.2.1 Key Bindings</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Quick-Search-1" href="#Quick-Search">12 Quick Search</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Setup-of-wl_002dqs" href="#Setup-of-Quick-Search">12.1 Setup of <code class="code">wl-qs</code></a></li>
<li><a id="toc-Searching" href="#Usage-of-Quick-Search">12.2 Searching</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Search-folder" href="#Search-folder">12.2.1 Search folder</a></li>
<li><a id="toc-Gmail" href="#Gmail">12.2.2 Gmail</a></li>
<li><a id="toc-Filter-folder" href="#Filter-folder">12.2.3 Filter folder</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Spam-Filter-1" href="#Spam-Filter">13 Spam Filter</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Usage-of-Spam-Filter-1" href="#Usage-of-Spam-Filter">13.1 Usage of Spam Filter</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Initial-Setting" href="#Initial-Setting">13.1.1 Initial Setting</a></li>
<li><a id="toc-spam-mark" href="#spam-mark">13.1.2 spam mark</a></li>
<li><a id="toc-spam-judgment" href="#spam-judgment">13.1.3 spam judgment</a></li>
<li><a id="toc-spam-learning" href="#spam-learning">13.1.4 spam learning</a></li>
<li><a id="toc-Key-Bindings-4" href="#Key-Bindings-4">13.1.5 Key Bindings</a></li>
<li><a id="toc-Customizable-Variables-7" href="#Customizable-Variables-7">13.1.6 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Supported-Spam-Filters" href="#Spam-Filter-Processors">13.2 Supported Spam Filters</a>
<ul class="toc-numbered-mark">
<li><a id="toc-bogofilter-1" href="#bogofilter">13.2.1 bogofilter</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-8" href="#Customizable-Variables-8">13.2.1.1 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-spamfilter_002eel" href="#spamfilter">13.2.2 spamfilter.el</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-9" href="#Customizable-Variables-9">13.2.2.1 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-bsfilter-1" href="#bsfilter">13.2.3 bsfilter</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-10" href="#Customizable-Variables-10">13.2.3.1 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-SpamAssassin-1" href="#SpamAssassin">13.2.4 SpamAssassin</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customize-Variables" href="#Customize-Variables">13.2.4.1 Customize Variables</a></li>
</ul></li>
<li><a id="toc-SpamOracle-1" href="#SpamOracle">13.2.5 SpamOracle</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-11" href="#Customizable-Variables-11">13.2.5.1 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Regular-Expressions-Header-Matching-1" href="#Regular-Expressions-Header-Matching">13.2.6 Regular Expressions Header Matching</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customize-Variables-1" href="#Customize-Variables-1">13.2.6.1 Customize Variables</a></li>
</ul></li>
</ul></li>
</ul></li>
<li><a id="toc-Advanced-Issues-1" href="#Advanced-Issues">14 Advanced Issues</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Living-with-other-packages-1" href="#Living-with-other-packages">14.1 Living with other packages</a>
<ul class="toc-numbered-mark">
<li><a id="toc-imput-1" href="#imput">14.1.1 imput</a></li>
<li><a id="toc-bbdb_002eel" href="#BBDB">14.1.2 bbdb.el</a></li>
<li><a id="toc-lsdb_002eel" href="#LSDB">14.1.3 lsdb.el</a></li>
<li><a id="toc-sc_002eel_0028supercite_0029_002c-sc_002dregister_002eel" href="#supercite">14.1.4 sc.el(supercite), sc-register.el</a></li>
<li><a id="toc-mu_002dcite_002eel" href="#mu_002dcite">14.1.5 mu-cite.el</a></li>
<li><a id="toc-x_002dface" href="#X_002dFace">14.1.6 x-face</a>
<ul class="toc-numbered-mark">
<li><a id="toc-x_002dface_002dmule-1" href="#x_002dface_002dmule">14.1.6.1 x-face-mule</a></li>
<li><a id="toc-x_002dface_002de21" href="#x_002dface_002de21">14.1.6.2 x-face-e21</a></li>
</ul></li>
<li><a id="toc-dired_002ddd_0028Dired_002dDragDrop_0029" href="#dired_002ddd">14.1.7 dired-dd(Dired-DragDrop)</a></li>
<li><a id="toc-mhc_002eel" href="#MHC">14.1.8 mhc.el</a></li>
<li><a id="toc-wl_002daddrbook_002eel" href="#Addrbook">14.1.9 wl-addrbook.el</a></li>
<li><a id="toc-mime_002dw3m_002eel" href="#mime_002dw3m">14.1.10 mime-w3m.el</a></li>
<li><a id="toc-oauth2_002eel" href="#oauth2">14.1.11 oauth2.el</a></li>
</ul></li>
<li><a id="toc-Highlights-1" href="#Highlights">14.2 Highlights</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-12" href="#Customizable-Variables-12">14.2.1 Customizable Variables</a></li>
<li><a id="toc-Setting-Colors-and-Fonts-of-the-Characters" href="#Setting-Colors-and-Fonts-of-the-Characters">14.2.2 Setting Colors and Fonts of the Characters</a></li>
</ul></li>
<li><a id="toc-Notify-Mail-arrival" href="#Biff">14.3 Notify Mail arrival</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customizable-Variables-13" href="#Customizable-Variables-13">14.3.1 Customizable Variables</a></li>
</ul></li>
<li><a id="toc-Manage-Passwords" href="#Password-Management">14.4 Manage Passwords</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Using-auth_002dsource-for-password-managament" href="#Auth_002dsource">14.4.1 Using auth-source for password managament</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Limitations-of-using-auth_002dsource" href="#Limitations-of-using-auth_002dsource">14.4.1.1 Limitations of using auth-source</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Message-splitting" href="#Split-messages">14.5 Message splitting</a></li>
<li><a id="toc-Batch-Processing-1" href="#Batch-Processing">14.6 Batch Processing</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Customize-Variables-2" href="#Customize-Variables-2">14.6.1 Customize Variables</a></li>
</ul></li>
<li><a id="toc-Advanced-Settings-1" href="#Advanced-Settings">14.7 Advanced Settings</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Draft-for-Replay" href="#Draft-for-Reply">14.7.1 Draft for Replay</a></li>
<li><a id="toc-Appearance-of-Threads" href="#Thread-Format">14.7.2 Appearance of Threads</a></li>
<li><a id="toc-User_002dAgent-Field-1" href="#User_002dAgent-Field">14.7.3 User-Agent Field</a></li>
</ul></li>
<li><a id="toc-Customizable-Variables-14" href="#Customizable-Variables">14.8 Customizable Variables</a></li>
<li><a id="toc-Hooks-1" href="#Hooks">14.9 Hooks</a></li>
</ul></li>
<li><a id="toc-Switch-from-older-version-of-Wanderlust" href="#Migration">15 Switch from older version of Wanderlust</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Migration-from-prior-to-the-version-2_002e12_002e0" href="#Before-2_002e12_002e0">15.1 Migration from prior to the version 2.12.0</a>
<ul class="toc-numbered-mark">
<li><a id="toc-The-conversion-of-msgdb" href="#The-conversion-of-msgdb">15.1.1 The conversion of msgdb</a></li>
<li><a id="toc-Changes-from-_0027mark-folder-to-_0027flag" href="#Changes-from-_0027mark-folder-to-_0027flag">15.1.2 Changes from ‘<samp class="samp">'mark</samp>’ folder to ‘<samp class="samp">'flag</samp>’</a></li>
</ul></li>
</ul></li>
<li><a id="toc-Terminology-around-Wanderlust" href="#Terminology">16 Terminology around Wanderlust</a></li>
<li><a id="toc-Wanderlust-Mailing-List" href="#Mailing-List">17 Wanderlust Mailing List</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Archive-1" href="#Archive-1">17.1 Archive</a></li>
</ul></li>
<li><a id="toc-Additional-Information" href="#Addition">18 Additional Information</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Brief-History" href="#Brief-History">18.1 Brief History</a></li>
<li><a id="toc-The-Name" href="#The-Name">18.2 The Name</a></li>
<li><a id="toc-Code-Names" href="#Code-Names">18.3 Code Names</a></li>
</ul></li>
<li><a id="toc-Index-1" href="#Index">Index</a>
<ul class="toc-numbered-mark">
<li><a id="toc-Concept-Index-1" href="#Concept-Index" rel="index">Concept Index</a></li>
<li><a id="toc-Key-Index-1" href="#Key-Index" rel="index">Key Index</a></li>
<li><a id="toc-Variable-Index-1" href="#Variable-Index" rel="index">Variable Index</a></li>
<li><a id="toc-Function-Index-1" href="#Function-Index" rel="index">Function Index</a></li>
</ul></li>
</ul>
</div>
</div>
<hr>
<div class="chapter-level-extent" id="Introduction">
<div class="nav-panel">
<p>
Next: <a href="#Start-Me-Up" accesskey="n" rel="next">Start up Wanderlust</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Wanderlust User’s Manual</a>, Up: <a href="#Top" accesskey="u" rel="up">Wanderlust User’s Manual</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Introduction-of-Wanderlust"><span>1 Introduction of Wanderlust<a class="copiable-link" href="#Introduction-of-Wanderlust"> ¶</a></span></h2>
<a class="index-entry-id" id="index-Introduction"></a>
<p>Wanderlust is an mail/news management system on Emacsen.
It supports IMAP4rev1(RFC2060), NNTP, POP and local message files.
</p>
<p>The main features of Wanderlust:
</p>
<ul class="itemize mark-minus">
<li>Pure elisp implementation.
</li><li>Supports IMAP4rev1, NNTP, POP(POP3/APOP), MH and Maildir format.
</li><li>Unified access method to messages based on Mew-like Folder Specification.
</li><li>Mew-like Key-bind and mark handling.
</li><li>Manages unread messages.
</li><li>Interactive thread display.
</li><li>Folder Mode shows the list of subscribed folders.
</li><li>Message Cache, Disconnected Operation.
</li><li>MH-like FCC. (Fcc: %Backup and Fcc: $Backup is allowed).
</li><li>MIME compliant (by SEMI).
</li><li>Transmission of news and mail are unified by Message transmitting draft.
</li><li>Graphical list of folders.
</li><li>View a part of message without retrieving the whole message (IMAP4).
</li><li>Server-side message look up (IMAP4). Multi-byte characters are allowed.
</li><li>Virtual Folders.
</li><li>Supports compressed folder using common archiving utilities.
</li><li>Old articles in folders are automatically removed/archived (Expiration).
</li><li>Automatic re-file.
</li><li>Template function makes it convenient to send fixed form messages.
</li></ul>
<ul class="mini-toc">
<li><a href="#Environment" accesskey="1">Environment</a></li>
</ul>
<div class="section-level-extent" id="Environment">
<h3 class="section"><span>1.1 Environment<a class="copiable-link" href="#Environment"> ¶</a></span></h3>
<p>It expected that Wanderlust works on Emacs 24.5 and later.
Furthermore, Wide int feature is required on 32-bit machines.
</p>
<p>IMAP4 connectivity with following imapd are confirmed to work with
Wanderlust:
</p>
<ul class="itemize mark-bullet">
<li>UW imapd 4.1–4.7, 4.7a, 4.7b, 4.7c, 2000 or later
</li><li>Cyrus imapd 1.4, 1.5.19, 1.6.22–1.6.24, 2.0.5 or later
</li><li>Courier-IMAP 1.3.2 or later
</li><li>AIR MAIL (AIRC imapd release 2.00)
</li><li>Express Mail
</li><li>Microsoft Exchange Server 5.5
</li><li>Sun Internet Mail Server 3.5, 3.5.alpha, 4.0
</li></ul>
<p>LDAP connectivity with following LDAPd are confirmed to work with
Wanderlust:
</p>
<ul class="itemize mark-bullet">
<li>OpenLDAP 2.0.6 or later
</li></ul>
<hr>
</div>
</div>
<div class="chapter-level-extent" id="Start-Me-Up">
<div class="nav-panel">
<p>
Next: <a href="#Folders" accesskey="n" rel="next">Wanderlust’s folders</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction of Wanderlust</a>, Up: <a href="#Top" accesskey="u" rel="up">Wanderlust User’s Manual</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h2 class="chapter" id="Start-up-Wanderlust"><span>2 Start up Wanderlust<a class="copiable-link" href="#Start-up-Wanderlust"> ¶</a></span></h2>
<a class="index-entry-id" id="index-Start-up"></a>
<p>The necessary procedure for starting Wanderlust is explained in steps
here.
</p>
<p>(Of course, you need a mail/news readable environment in advance)
</p>
<ul class="mini-toc">
<li><a href="#MIME-Modules" accesskey="1">Installing MIME modules</a></li>
<li><a href="#Download" accesskey="2">Download and Extract the Package</a></li>
<li><a href="#Install" accesskey="3">Byte-compile and install</a></li>
<li><a href="#Minimal-Settings" accesskey="4">Set up .emacs</a></li>
<li><a href="#Folder-Definition" accesskey="5">Folder Definition</a></li>
<li><a href="#Start-Wanderlust" accesskey="6">Start Wanderlust</a></li>
<li><a href="#Overview" accesskey="7">Overview</a></li>
</ul>
<hr>
<div class="section-level-extent" id="MIME-Modules">
<div class="nav-panel">
<p>
Next: <a href="#Download" accesskey="n" rel="next">Download and Extract the Package</a>, Previous: <a href="#Start-Me-Up" accesskey="p" rel="prev">Start up Wanderlust</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Installing-MIME-modules"><span>2.1 Installing MIME modules<a class="copiable-link" href="#Installing-MIME-modules"> ¶</a></span></h3>
<a class="index-entry-id" id="index-MIME-modules"></a>
<a class="index-entry-id" id="index-APEL"></a>
<a class="index-entry-id" id="index-FLIM"></a>
<a class="index-entry-id" id="index-SEMI"></a>
<p>You must install packages named APEL-LB, FLIM-LB and SEMI-EPG, which are
variants of APEL, FLIM and SEMI, beforehand to use Wanderlust.
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">APEL-LB: <a class="uref" href="https://github.com/wanderlust/apel">https://github.com/wanderlust/apel</a>
FLIM-LB: <a class="uref" href="https://github.com/wanderlust/flim">https://github.com/wanderlust/flim</a>
SEMI-EPG: <a class="uref" href="https://github.com/wanderlust/semi">https://github.com/wanderlust/semi</a>
</pre></div></div>
<p>You can download original APEL, FLIM and SEMI from following URLs:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">APEL: <a class="uref" href="http://git.chise.org/elisp/dist/semi/">http://git.chise.org/elisp/dist/semi/</a>
FLIM: <a class="uref" href="http://git.chise.org/elisp/dist/apel/">http://git.chise.org/elisp/dist/apel/</a>
SEMI: <a class="uref" href="http://git.chise.org/elisp/dist/semi/">http://git.chise.org/elisp/dist/semi/</a>
</pre></div></div>
<p>You have to install APEL-LB, FLIM-LB and SEMI-EPG in this order.
Generally, ‘<samp class="samp">make install</samp>’ will do the job.
</p>
<p>Refer to the documents of each package for detailed installation
procedure.
</p>
<p>You have to re-install Wanderlust if you upgraded APEL-LB, FLIM-LB or
SEMI-EPG.
</p>
<hr>
</div>
<div class="section-level-extent" id="Download">
<div class="nav-panel">
<p>
Next: <a href="#Install" accesskey="n" rel="next">Byte-compile and install</a>, Previous: <a href="#MIME-Modules" accesskey="p" rel="prev">Installing MIME modules</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Download-and-Extract-the-Package"><span>2.2 Download and Extract the Package<a class="copiable-link" href="#Download-and-Extract-the-Package"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Download"></a>
<p>You can download Wanderlust package from following sites:
</p>
<p>Original site:
</p><div class="example">
<pre class="example-preformatted"><a class="uref" href="https://github.com/wanderlust/wanderlust">https://github.com/wanderlust/wanderlust</a>
</pre></div>
<p>Mirrored ftp/http sites:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted"><a class="uref" href="http://www.jpl.org/ftp/pub/github-snapshots/">http://www.jpl.org/ftp/pub/github-snapshots/</a>
</pre></div></div>
<p>Extract the obtained package to your working directory:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">% cd ~/work
% tar zxvf wl-<var class="var">version</var>.tar.gz
% cd wl-<var class="var">version</var>
</pre></div></div>
<ul class="mini-toc">
<li><a href="#To-use-SSL-_0028Secure-Socket-Layer_0029" accesskey="1">To use SSL (Secure Socket Layer)</a></li>
</ul>
<div class="subsection-level-extent" id="To-use-SSL-_0028Secure-Socket-Layer_0029">
<h4 class="subsection"><span>2.2.1 To use SSL (Secure Socket Layer)<a class="copiable-link" href="#To-use-SSL-_0028Secure-Socket-Layer_0029"> ¶</a></span></h4>
<a class="index-entry-id" id="index-SSL"></a>
<a class="index-entry-id" id="index-OpenSSL"></a>
<a class="index-entry-id" id="index-starttls"></a>
<p>SSL (Secure Socket Layer) can be used for
SMTP, IMAP, NNTP and POP connections in Wanderlust.
Emacs 24 and later uses built-in GnuTLS if available.
</p>
<p>There are two ways to use SSL. One is to start SSL negotiation just
after the connection establishment (generic way). The other one is to
start SSL negotiation by invoking STARTTLS command in the each session.
</p>
<p>If built-in GnuTLS is not available, Emacs try to use <samp class="file">tls.el</samp> for
the formal SSL (generic SSL). In this case, GnuTLS’s
<code class="command">gnutls-cli</code> is needed. if neither avialable, <samp class="file">ssl.el</samp> of
<samp class="file">utils</samp> directory and OpenSSL’s <code class="command">openssl</code>.
</p>
<p>For the latter SSL (STARTTLS), you need <samp class="file">starttls.el</samp> if built-in
GnuTLS is not available. Moreover, GnuTLS or starttls package is needed
according to <code class="code">starttls-use-gnutls</code> variable’s value. If your Emacs
doesn’t have <samp class="file">starttls.el</samp> or <samp class="file">starttls.el</samp> doesn’t have the
defninition of <code class="code">starttls-use-gnutls</code>, you need starttls package.
</p>
<p>You can download starttls package from the following site.
</p>
<div class="example">
<pre class="example-preformatted"><a class="uref" href="ftp://opaopa.org/pub/elisp/">ftp://opaopa.org/pub/elisp/</a>
</pre></div>
<hr>
</div>
</div>
<div class="section-level-extent" id="Install">
<div class="nav-panel">
<p>
Next: <a href="#Minimal-Settings" accesskey="n" rel="next">Set up .emacs</a>, Previous: <a href="#Download" accesskey="p" rel="prev">Download and Extract the Package</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Byte_002dcompile-and-install"><span>2.3 Byte-compile and install<a class="copiable-link" href="#Byte_002dcompile-and-install"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Byte_002dcompile"></a>
<a class="index-entry-id" id="index-Compile"></a>
<a class="index-entry-id" id="index-Install"></a>
<a class="index-entry-id" id="index-Makefile"></a>
<a class="index-entry-id" id="index-Make"></a>
<ul class="mini-toc">
<li><a href="#Installation" accesskey="1">Installation</a></li>
<li><a href="#WL_002dCFG" accesskey="2"><samp class="file">WL-CFG</samp></a></li>
<li><a href="#Run-in-place" accesskey="3">Run in place</a></li>
<li><a href="#Manual" accesskey="4">Manual</a></li>
</ul>
<div class="subsection-level-extent" id="Installation">
<h4 class="subsection"><span>2.3.1 Installation<a class="copiable-link" href="#Installation"> ¶</a></span></h4>
<p>Edit <code class="code">LISPDIR</code> and <code class="code">EMACS</code> in <samp class="file">Makefile</samp>.
Set the Emacs’s command name to <code class="code">EMACS</code>.
Set package installation directory to <code class="code">LISPDIR</code>.
Then, please execute following commands.
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">% make
% make install
</pre></div></div>
<p>Destination directory is auto-probed if you leave <code class="code">LISPDIR</code>
in <samp class="file">Makefile</samp> as is. (That is, leave it as ‘<samp class="samp">NONE</samp>’)
</p>
<p>If you want to handle shimbun folders, add directory where emacs-w3m is
installed to <code class="code">load-path</code>. Then necessary modules will be
byte-compiled and installed.
See <a class="xref" href="#Shimbun-Folder">Shimbun Folder</a>.
</p>
</div>
<div class="subsection-level-extent" id="WL_002dCFG">
<h4 class="subsection"><span>2.3.2 <samp class="file">WL-CFG</samp><a class="copiable-link" href="#WL_002dCFG"> ¶</a></span></h4>
<p>Contents of the file <samp class="file">WL-CFG</samp> is loaded under installation if a file
with that name exists in extracted directory. You can use <samp class="file">WL-CFG</samp> to
configure <code class="code">load-path</code> to extra packages such as SEMI if needed.
</p>
<p>If you want to specify the install directory of Wanderlust related
files, then set following variables in <samp class="file">WL-CFG</samp>
</p>
<dl class="table">
<dt><code class="code">WL_PREFIX</code></dt>
<dd><p>A directory to install WL modules.
This directory is relative directory from <code class="code">LISPDIR</code>.
WL modules include <samp class="file">wl*.el</samp>, <samp class="file">wl*.elc</samp> files.
</p>
</dd>
<dt><code class="code">ELMO_PREFIX</code></dt>
<dd><p>A directory to install ELMO modules.
This directory is relative directory from <code class="code">LISPDIR</code>.
ELMO modules include <samp class="file">elmo*.el</samp>, <samp class="file">elmo*.elc</samp> files.
</p></dd>
</dl>
<p>Default value of <code class="code">WL_PREFIX</code> and <code class="code">ELMO_PREFIX</code> are <samp class="file">wl</samp>.
</p>
<p>If you want to install ELMO related files under a sub-directory
such as "elmo" then add following to <samp class="file">WL-CFG</samp>:
</p>
<div class="example lisp">
<pre class="lisp-preformatted">(setq ELMO_PREFIX "elmo")
</pre></div>
</div>
<div class="subsection-level-extent" id="Run-in-place">
<h4 class="subsection"><span>2.3.3 Run in place<a class="copiable-link" href="#Run-in-place"> ¶</a></span></h4>
<p>If wl and elmo directories are defined in <code class="code">load-path</code>, then
byte-compilation and installation are not necessary to start Wanderlust.
For example, if package is extracted in <samp class="file">~/work</samp>, Wanderlust can be
invoked with following setting in <samp class="file">~/.emacs</samp>.
</p>
<div class="example lisp">
<div class="group"><pre class="lisp-preformatted">(add-to-list 'load-path "~/work/wl-<var class="var">version</var>/wl")
(add-to-list 'load-path "~/work/wl-<var class="var">version</var>/elmo")
</pre></div></div>
</div>
<div class="subsection-level-extent" id="Manual">
<h4 class="subsection"><span>2.3.4 Manual<a class="copiable-link" href="#Manual"> ¶</a></span></h4>
<p>Manual is described in Info format. Please do following.
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">% make info
% make install-info
</pre></div></div>
<p>Manual directory is automatically detected. Of course, it can be
configured by <code class="code">INFODIR</code> in <samp class="file">Makefile</samp>.
</p>
<p>You can read manual at the following URL:
</p>
<div class="example">
<pre class="example-preformatted"><a class="uref" href="http://wanderlust.github.io/wl-docs/wl.html">http://wanderlust.github.io/wl-docs/wl.html</a>
</pre></div>
<hr>
</div>
</div>
<div class="section-level-extent" id="Minimal-Settings">
<div class="nav-panel">
<p>
Next: <a href="#Folder-Definition" accesskey="n" rel="next">Folder Definition</a>, Previous: <a href="#Install" accesskey="p" rel="prev">Byte-compile and install</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Set-up-_002eemacs"><span>2.4 Set up .emacs<a class="copiable-link" href="#Set-up-_002eemacs"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Minimal-Settings"></a>
<a class="index-entry-id" id="index-Settings"></a>
<a class="index-entry-id" id="index-Configuration"></a>
<a class="index-entry-id" id="index-_002eemacs"></a>
<a class="index-entry-id" id="index-_002ewl"></a>
<p>The Wanderlust package contains two module groups.
</p>
<dl class="table">
<dt>‘<samp class="samp">ELMO (elmo-*.el)</samp>’</dt>
<dd><p>These modules show everything as folders. This is the back-end for WL.
</p></dd>
<dt>‘<samp class="samp">WL (wl-*.el)</samp>’</dt>
<dd><p>These modules controls the behavior of main body of Wanderlust.
They are also the front-end for ELMO.
</p></dd>
</dl>
<p>You can customize the behavior of Wanderlust by changing the value
of environmental variables which begins with <code class="code">elmo-</code> and <code class="code">wl-</code>.
</p>
<p>The minimal requirement for settings is as the following.
</p>
<div class="example lisp">
<div class="group"><pre class="lisp-preformatted">;; <span class="r">autoload configuration</span>
(autoload 'wl "wl" "Wanderlust" t)
(autoload 'wl-other-frame "wl" "Wanderlust on new frame." t)
(autoload 'wl-draft "wl-draft" "Write draft with Wanderlust." t)
;; <span class="r">Directory where icons are placed.</span>
;; <span class="r">Default: the peculiar value to the running version of Emacs.</span>
;; <span class="r">(Not required if the default value points properly)</span>
(setq wl-icon-directory "~/work/wl/etc")
;; <span class="r">SMTP server for mail posting. Default: <code class="code">nil</code></span>
(setq wl-smtp-posting-server "your.smtp.example.com")
;; <span class="r">NNTP server for news posting. Default: <code class="code">nil</code></span>
(setq wl-nntp-posting-server "your.nntp.example.com")
</pre></div></div>
<p><samp class="file">~/.wl</samp> is automatically loaded when Wanderlust starts up (if such a
file exists). So it is convenient to gather Wanderlust specific settings
in <samp class="file">~/.wl</samp>. Settings for "face" must be written in <samp class="file">~/.wl</samp>,
because you can’t write them in <samp class="file">.emacs</samp>
(if you write it to <samp class="file">.emacs</samp>, you’ll get an error).
See <a class="xref" href="#Highlights">Highlights</a>.
</p>
<p>All above described settings except autoload configuration can be written
in <samp class="file">~/.wl</samp>).
</p>
<ul class="mini-toc">
<li><a href="#mail_002duser_002dagent" accesskey="1"><code class="code">mail-user-agent</code></a></li>
</ul>
<div class="subsection-level-extent" id="mail_002duser_002dagent">
<h4 class="subsection"><span>2.4.1 <code class="code">mail-user-agent</code><a class="copiable-link" href="#mail_002duser_002dagent"> ¶</a></span></h4>
<a class="index-entry-id" id="index-Default-Mailer"></a>
<a class="index-entry-id" id="index-Mailer_002c-Default"></a>
<a class="index-entry-id" id="index-mail_002duser_002dagent"></a>
<a class="index-entry-id" id="index-compose_002dmail"></a>
<p>If you write following setting in your <samp class="file">~/.emacs</samp>, you can
start Wanderlust draft mode by typing <kbd class="kbd">C-x m</kbd> (<code class="code">compose-mail</code>).
This means it enables you to run Wanderlust as a default mail composer
of Emacsen.
</p>
<p>It is effective only when your Emacs can define <code class="code">mail-user-agent</code>.
See <a data-manual="emacs" href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Mail-Methods">Mail-Composition Methods</a> in <cite class="cite">GNU Emacs Manual</cite>.
</p>
<div class="example lisp">
<div class="group"><pre class="lisp-preformatted">(autoload 'wl-user-agent-compose "wl-draft" nil t)
(if (boundp 'mail-user-agent)
(setq mail-user-agent 'wl-user-agent))
(if (fboundp 'define-mail-user-agent)
(define-mail-user-agent
'wl-user-agent
'wl-user-agent-compose
'wl-draft-send
'wl-draft-kill
'mail-send-hook))
</pre></div></div>
<hr>
</div>
</div>
<div class="section-level-extent" id="Folder-Definition">
<div class="nav-panel">
<p>
Next: <a href="#Start-Wanderlust" accesskey="n" rel="next">Start Wanderlust</a>, Previous: <a href="#Minimal-Settings" accesskey="p" rel="prev">Set up .emacs</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Folder-Definition-1"><span>2.5 Folder Definition<a class="copiable-link" href="#Folder-Definition-1"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Folder-Definition"></a>
<a class="index-entry-id" id="index-_002efolders"></a>
<p>You can skip this section because it is possible to add/edit the
subscribe folders from the buffer for list of folders.
See <a class="xref" href="#Folder-Manager">Editing Folders</a>.
</p>
<p>Define the folders you want to subscribe in file <samp class="file">~/.folders</samp>. The
contents written in <samp class="file">~/.folders</samp> become the folders which you
subscribe to as it is.
</p>
<p>Format for <samp class="file">~/.folders</samp> is very simple. Here is an example:
</p>
<div class="example">
<div class="group"><pre class="example-preformatted">#
# <span class="r">Lines begin with ‘<samp class="samp">#</samp>’ are comment.</span>
# <span class="r">Empty lines are ignored</span>
#
# <var class="var">folder name</var> "<var class="var">folder nickname</var>"
# <span class="r">(nicknames are not necessary)</span>
#
%inbox "Inbox"
+trash "Trash"
+draft "Drafts"
%#mh/[email protected]
# <span class="r">Nickname can be defined in another line</span>
= %#mh/[email protected] "Sent"
# Folder Group
Emacsen{
%#mh/spool/wl "Wanderlust ML"
%#mh/spool/elips "ELIPS ML"
%#mh/spool/apel-ja "APEL Japanese ML"
%#mh/spool/xemacs-beta "XEmacs beta"
[email protected] "Gnus Net news"
*-fj.editor.xemacs,-fj.editor.mule,-fj.editor.emacs "fj's Emacsen"
}
#
# <span class="r">If folder name ends with ‘<samp class="samp">/</samp>’, that means an ‘access group’,</span>
# <span class="r">all subfolders automatically included in one folder group.</span>
#
%#mh/expire@localhost /
# <span class="r">All MH folders are included in one folder group.</span>
+ /
# <span class="r">Define nickname for access group</span>
= + "Mails"
</pre></div></div>
<p>Each line contains one folder you want to read. The definition of
folders will be explained in detail in the next section.
</p>
<p>The part surrounded by ‘<samp class="samp"><var class="var">group name</var>{</samp>’ and ‘<samp class="samp">}</samp>’ will
become one folder group. One folder group is treated as a directory
which can be opened and closed in folder mode. It is convenient for
collecting some folders and putting them in order.
</p>
<p>Please note that ‘<samp class="samp"><var class="var">group name</var>{</samp>’ and ‘<samp class="samp">}</samp>’ occupies one
line and you have to write it that way (It is because the parser sucks).
</p>
<p>There are two types of groups. One is like ‘<samp class="samp">Emacsen</samp>’ from above
example which the user chooses his favorite folders as a group.
</p>
<p>The other one is <em class="dfn">access group</em> like ‘<samp class="samp">+ /</samp>’ from above example.
It collects all sub-folders in the folder to make a group. (Its
behavior differs by the type of the folder. For example, ‘<samp class="samp">+</samp>’
followed by ‘<samp class="samp">/</samp>’ makes entire MH sub-directories to one group) If
you want nickname access group, you need define it in another line. You
can’t define in a line as normal folder.
</p>
<p>This behavior is better understood if you try it and confirmed the
function first. You can write and try a small folder definition, so you
will know the idea of the folder function before writing the real one.
</p>
<hr>
</div>
<div class="section-level-extent" id="Start-Wanderlust">
<div class="nav-panel">
<p>
Next: <a href="#Overview" accesskey="n" rel="next">Overview</a>, Previous: <a href="#Folder-Definition" accesskey="p" rel="prev">Folder Definition</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Start-Wanderlust-1"><span>2.6 Start Wanderlust<a class="copiable-link" href="#Start-Wanderlust-1"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Start-Wanderlust"></a>
<p>If installation and configuration worked well, you can invoke Wanderlust by
typing following command in Emacs.
</p>
<div class="example">
<pre class="example-preformatted">M-x wl
</pre></div>
<p>After initialization, Folder Mode which shows the list of folders will
appear. That means the folders you defined in the <samp class="file">~/.folders</samp> are
listed.
</p>
<p>If you start Wanderlust with prefix argument like <kbd class="kbd">C-u M-x wl</kbd>, you
can skip folder checking.
</p>
<hr>
</div>
<div class="section-level-extent" id="Overview">
<div class="nav-panel">
<p>
Previous: <a href="#Start-Wanderlust" accesskey="p" rel="prev">Start Wanderlust</a>, Up: <a href="#Start-Me-Up" accesskey="u" rel="up">Start up Wanderlust</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<h3 class="section" id="Overview-1"><span>2.7 Overview<a class="copiable-link" href="#Overview-1"> ¶</a></span></h3>
<a class="index-entry-id" id="index-Overview"></a>
<p>Basically, you will handle messages in wanderlust while you come and go
from/to each of the following buffers. Details of each ones are
explained in following chapters.
</p>