Fix example of pipe folders.
[elisp/wanderlust.git] / doc / wl.texi
index 146f53e..59eb27d 100644 (file)
@@ -5,7 +5,7 @@
 @c %**end of header
 @documentlanguage en
 @documentencoding us-ascii
-@set VERSION 2.5.8
+@include version.texi
 @synindex pg cp
 @finalout
 
@@ -152,7 +152,7 @@ The main features of Wanderlust:
 
 @section Environment
 
-Wanderlust is supposed to run on following Emacsen: 
+Wanderlust is supposed to run on following Emacsen:
 @c Wanderlust runs even on Nemacs 3.3.2 based on Emacs 18.55, 18.59 (with
 @c limited functionality).
 
@@ -173,15 +173,20 @@ Wanderlust:
 
 @itemize @bullet
 @item UW imapd 4.1--4.7, 4.7a, 4.7b, 4.7c, 2000 or later
-@item Cyrus imapd 1.4, 1.5.19, 1.6.22, 2.0.5 or later
+@item Cyrus imapd 1.4, 1.5.19, 1.6.22--1.6.24, 2.0.5 or later
+@item Courier-IMAP 1.3.2 or later
 @item AIR MAIL (AIRC imapd release 2.00)
 @item Express Mail
 @item Microsoft Exchange Server 5.5
-@item Sun Internet Mail Server 4.0
+@item Sun Internet Mail Server 3.5, 3.5.alpha, 4.0
 @end itemize
 
-@c LDAP connectivity with following LDAPd are confirmed to work with
-@c Wanderlust:
+LDAP connectivity with following LDAPd are confirmed to work with
+Wanderlust:
+
+@itemize @bullet
+@item OpenLDAP 2.0.6 or later
+@end itemize
 
 
 @node Start Me Up, Folders, Introduction, Top
@@ -209,58 +214,12 @@ here.
 @cindex MIME modules
 @pindex APEL
 @pindex FLIM
+@pindex CLIME
 @pindex SEMI
 @pindex tm
 
-SEMI or tm must be installed to make Wanderlust work correctly.
-
-SEMI does not run on Emacs 19.28 or earlier
-@footnote{SEMI runs on Emacs 19.34. @*
-@uref{http://www.jpl.org/elips/INSTALL-SEMI-ja.html} describes how to.},
-so you must install tm, the predecessor of SEMI. (tm version 8.7 or later
-is needed.)
-
-However, SEMI is recommended because of its wider functionality.
-
-Refer to the documents of each package for detailed installation procedure.
-
-SEMI and tm can be downloaded from these sites:
-
-@example
-@group
-SEMI:   ftp://ftp.m17n.org/pub/mule/semi/
-tm:     http://cvs.m17n.org/tomo/comp/emacsen/tm/tm-8/
-@end group
-@end example
-
-You need packages named APEL and FLIM to use SEMI.
-You can download APEL and FLIM from following URLs:
-
-@example
-@group
-APEL:   ftp://ftp.m17n.org/pub/mule/apel/
-FLIM:   ftp://ftp.m17n.org/pub/mule/flim/
-@end group
-@end example
-
-You have to install APEL, FLIM and SEMI in this order.  Generally
-@samp{make install} will do the job.  (In XEmacs 21, @samp{make
-install-package}.)
-
-Recommended combination of APEL, FLIM and SEMI are following:
-
-@itemize @minus
-@item APEL 10.3, FLIM 1.14.2 and SEMI 1.14.3
-@end itemize
-
-You can also use many other FLIM/SEMI variants. Combination of the
-latest versions should work.  For example, following combination is
-confirmed to work.
-
-@itemize @minus
-@item APEL 10.2, Chao 1.14.1, REMI 1.14.2
-@item APEL 10.2, SLIM 1.14.3, EMY 1.13.9
-@end itemize
+SEMI or tm must be installed to make Wanderlust work correctly.  Refer
+to the @file{INSTALL} for detailed installation procedure.
 
 You have to re-install Wanderlust if you upgraded APEL, FLIM, SEMI or
 tm.
@@ -305,8 +264,8 @@ Extract the obtained package to your working directory:
 @pindex OpenSSL
 @pindex starttls
 
-SSL (Secure Socket Layer) can be used for 
-SMTP, IMAP, NNTP and POP connections in Wanderlust.
+SSL (Secure Socket Layer) can be used for SMTP, IMAP, NNTP and POP
+connections in Wanderlust.
 
 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
@@ -318,7 +277,7 @@ required to use @file{ssl.el}. You must set @env{PATH} to the directory
 that OpenSSL commands are installed.
 
 To use the latter SSL(STARTTLS), you must install starttls package in
-addition to above. 
+addition to above.
 You can download starttls package from the following site.
 
 @example
@@ -350,9 +309,9 @@ Then, please execute following commands.
 Destination directory is auto-probed if you leave @code{LISPDIR}
 in @file{Makefile} as is. (That is, leave it as @samp{NONE})
 
-If you are using an Emacs variant which does not merge specified directory
-to @code{load-path} (e.g. Mule 2.3 based on Emacs 19.28), 
-then you will see the error message:
+If you are using an Emacs variant which does not merge specified
+directory to @code{load-path} (e.g. Mule 2.3 based on Emacs 19.28), then
+you will see the error message:
 
 @example
 Cannot open load file: mime-setup
@@ -381,7 +340,7 @@ files, then set following variables in @file{WL-CFG}
 A directory to install WL modules.
 This directory is relative directory from @code{LISPDIR}.
 WL modules include @file{wl*.el}, @file{wl*.elc} files.
-@c  Modules under the directory @file{util/} are also installed if 
+@c  Modules under the directory @file{util/} are also installed if
 @c it detected as necessary.
 
 @item ELMO_PREFIX
@@ -390,7 +349,7 @@ This directory is relative directory from @code{LISPDIR}.
 ELMO modules include @file{elmo*.el}, @file{elmo*.elc} files.
 @c  @file{utf7.el}, @file{utf7.elc} are also included in the ELMO.
 @end table
-  
+
 @noindent
 Default value of @code{WL_PREFIX} and @code{ELMO_PREFIX} are @file{wl}.
 
@@ -502,9 +461,9 @@ The minimal requirement for settings is as the following.
 (setq wl-icon-dir "~/work/wl/etc")
 
 ;; @r{SMTP server for mail posting. Default: @code{nil}}
-(setq wl-smtp-posting-server "your.smtp.server.com")
+(setq wl-smtp-posting-server "your.smtp.example.com")
 ;; @r{NNTP server for news posting. Default: @code{nil}}
-(setq wl-nntp-posting-server "your.nntp.server.com")
+(setq wl-nntp-posting-server "your.nntp.example.com")
 @end group
 @end lisp
 
@@ -526,7 +485,7 @@ configuration can be written in
 @findex compose-mail
 
 If you write following setting in you @file{.emacs}, you can
-start Wanderlust draft mode by typing @kbd{C-x m} (@code{compose-mail}). 
+start Wanderlust draft mode by typing @kbd{C-x m} (@code{compose-mail}).
 This means it enables you to run Wanderlust as a default mail composer
  of Emacsen.
 
@@ -576,9 +535,9 @@ The format is very simple. Like this. @refill
 # @r{Format of each line:}
 # @var{email-address}  "@var{nickname} "@var{realname}"
 #
-teranisi@@gohome.org            "Yuuichi"      "Yuuichi Teranishi"
-foo@@bar.gohome.org             "Mr. Foo"    "John Foo"
-bar@@foo.gohome.org             "Mr. Bar"    "Michael Bar"
+teranisi@@gohome.org            "YT"            "Yuuichi Teranishi"
+foo@@example.com                "Mr. Foo"       "John Foo"
+bar@@example.org                "Mr. Bar"       "Michael Bar"
 @end group
 @end example
 
@@ -630,14 +589,14 @@ Format for @file{~/.folders} is very simple. Here is an example:
 %inbox  "Inbox"
 +trash  "Trash"
 +draft  "Drafts"
-%#mh/Backup@@my.imap.server.com "Sent"
+%#mh/Backup@@my.imap.example.com "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"
-    -fj.news.reader.gnus@@other.nntp.server.com "Gnus Net news"
+    -fj.news.reader.gnus@@other.nntp.example.com "Gnus Net news"
     *-fj.editor.xemacs,-fj.editor.mule,-fj.editor.emacs "fj's Emacsen"
 @}
 #
@@ -655,7 +614,7 @@ folders will be explained in detail in the next section.
 
 The part surrounded by @samp{@var{group name}@{} and @samp{@}} will
 become one folder group.  One folder group is treated as a directory
-which can bed opened and closed in folder mode. It is convenient for
+which can be opened and closed in folder mode. It is convenient for
 collecting some folders and putting them in order.
 
 Please note that @samp{@var{group name}@{} and @samp{@}} occupies one
@@ -692,7 +651,7 @@ can skip folder checking.
 
 
 @node Folders, Folder, Start Me Up, Top
-@chapter Wanderlust's folders 
+@chapter Wanderlust's folders
 @cindex Folder Type
 
 This chapter describes the folder types which Wanderlust is able to handle.
@@ -700,9 +659,9 @@ This chapter describes the folder types which Wanderlust is able to handle.
 Wanderlust uses ELMO as it's interface, so every folder types supported
 by ELMO is usable in Wanderlust.
 
-As of version @value{VERSION}, 10 types of folders are predefined. These are
-IMAP, NNTP, LocalDir(MH), News Spool, POP, Archive, Multi, Filter, Pipe
-and Internal folder types.
+As of version @value{VERSION}, 11 types of folders are predefined. These are
+IMAP, NNTP, LocalDir(MH), Maildir, News Spool, Archive, POP, Multi, Filter,
+Pipe and Internal folder types.
 
 @menu
 * IMAP Folder::              @samp{%} -- IMAP folder
@@ -762,12 +721,22 @@ You can omit the @var{hostname} from folder names if you set
 For example, you can specify a folder as @samp{foo%imap@@gateway} even
 if you have to go through a firewall.
 
+@lisp
+;; Example: imap4.exaple.org as main IMAP server
+(setq elmo-default-imap4-server "imap4.example.org")
+@end lisp
+
 SSL (Secure Socket Layer) connection will be used if a folder name ends
 with @samp{!}. Or, if the value of @code{elmo-default-imap4-stream-type}
-is non-nil, SSL will be the default connection.  If a folder name ends
-with @samp{!!}, STARTTLS connection will be established.  If the value
-of @code{elmo-default-imap4-stream-type} is @code{starttls}, STARTTLS
-will be the default connection.
+is @code{ssl}, SSL will be the default connection.  If a folder name
+ends with @samp{!!}, STARTTLS connection will be established.  If the
+value of @code{elmo-default-imap4-stream-type} is @code{starttls},
+STARTTLS will be the default connection.
+
+@lisp
+;; Example: Use SSL connection
+(setq elmo-default-imap4-stream-type 'ssl)
+@end lisp
 
 If you specify @code{login}, @code{cram-md5} or @code{digest-md5} as
 authentication method, the password is sent in encoded form. But, if
@@ -777,6 +746,11 @@ after confirmation to user. If @code{elmo-imap4-force-login} is non-nil,
 authentication will fall back to @code{clear} without confirmation
 (default value is @code{nil}).
 
+@lisp
+;; Example: password in raw format
+(setq elmo-default-imap4-authenticate-type 'clear)
+@end lisp
+
 Example:
 
 @example
@@ -861,7 +835,7 @@ default:
 @example
 @var{hostname}  -> The value of @code{elmo-default-nntp-server}.
              Initial setting is @samp{localhost}.
-@var{username}  -> The value of @code{elmo-default-nntp-user}. 
+@var{username}  -> The value of @code{elmo-default-nntp-user}.
              Initial setting is @code{nil}.
 @var{port}      -> The value of @code{elmo-default-nntp-port}.
              Initial setting is 119.
@@ -1128,11 +1102,11 @@ in processing speed. For comfortable use, Emacs20 is recommended.
 (If re-search's performance is the problem, 19.3x or later may be okay.)
 
 If many files are included in one archive,
-it takes long time to access to the archive folder because 
+it takes long time to access to the archive folder because
 archiver starting overhead is increased (especially LHA).
 150-200 messages in one archive is recommended.
 
-Of course, following is possible @t{:-)} 
+Of course, following is possible @t{:-)}
 (meanings of these variables are described later.)
 
 @lisp
@@ -1150,7 +1124,7 @@ Of course, following is possible @t{:-)}
 @item elmo-archive-default-type
 @vindex elmo-archive-default-type
 The initial setting is @code{zip}.
-Set archiver type by symbol. 
+Set archiver type by symbol.
 
 @item elmo-archive-@var{type}-method-alist
 @vindex elmo-archive-TYPE-method-alist
@@ -1176,7 +1150,7 @@ Currently available actions are following.
 @end example
 
 @noindent
-In above actions, 
+In above actions,
 actions enclosed with braces are optional (They are used for better
 performance).
 
@@ -1263,7 +1237,7 @@ Example:
 @end group
 @end example
 
-To use apop as an @var{authenticate-type}, @file{md5.el} is needed
+To use APOP as an @var{authenticate-type}, @file{md5.el} is needed
 (XEmacs doesn't need @file{md5.el}).  @file{md5.el} is included in
 @file{utils/sasl/lisp/} or Emacs/W3 package
 (@uref{http://www.cs.indiana.edu/elisp/w3/docs.html}) or LCD archive
@@ -1320,7 +1294,7 @@ Example:
 @cindex Folder, Filtering
 @cindex Folder, Virtual
 
-A folder to access to a folder which collects all messages that 
+A folder to access to a folder which collects all messages that
 satisfy a condition virtually.
 
 Format:
@@ -1373,7 +1347,7 @@ Example:
 /since:3daysago/+inbox -> messages arrived since 3 days ago in +inbox
                           are picked.
 /before:yesterday/+inbox -> messages arrived before yesterday in +inbox
-                          are picked. 
+                          are picked.
 @end group
 @end example
 
@@ -1408,13 +1382,13 @@ Example:
 @example
 @group
 /from:teranisi&!to:teranisi/+inbox
-                      -> In +inbox, messages are picked if the message's 
-                         From: field includes "teranisi" and 
+                      -> In +inbox, messages are picked if the message's
+                         From: field includes "teranisi" and
                          To: field doesn't include "teranisi".
 
-/tocc:"Yuuichi Teranishi"/+inbox 
+/tocc:"Yuuichi Teranishi"/+inbox
                       -> In +inbox, messages are picked if the
-                         message's To: field or Cc: field includes 
+                         message's To: field or Cc: field includes
                          "Yuuichi Teranishi".
 
 /(from:yt|from:teranisi)&subject:report/+inbox
@@ -1486,8 +1460,8 @@ Example:
 
 @example
 @group
-%inbox|%myinbox   -> Download %inbox to %myinbox.
-*&user@@popserver1,&user@@popserver2|+inbox
+|%inbox|%myinbox   -> Download %inbox to %myinbox.
+|*&user@@popserver1,&user@@popserver2|+inbox
          -> Download from &user@@popserver1 and &user@@popserver2 to +inbox.
 @end group
 @end example
@@ -1597,7 +1571,7 @@ six children folders update its unread number status.
 
 To enter summary mode of the folder, type return (or space) key on
 the folder line.
-If the variable @code{wl-stay-folder-window} has non-nil value, 
+If the variable @code{wl-stay-folder-window} has non-nil value,
 summary window appears on the right of the folder mode window.
 
 @subsection Key bindings
@@ -1611,9 +1585,9 @@ Folder mode's key binding (related to selecting folders) is following.
 @kindex @key{RET} (Folder)
 @findex wl-folder-jump-to-current-entity
 Enter to the summary mode of the folder at the current cursor point.
-If the cursor is on the top of folder group line, 
+If the cursor is on the top of folder group line,
 the folder group is opened or closed.
-When the cursor is on the access group and this command is called 
+When the cursor is on the access group and this command is called
 with prefix argument, folder children list is updated to the newest one.
 (Children list is updated recursively if the access folder has hierarchical
 structure.)
@@ -1656,7 +1630,7 @@ folder's message to the draft buffer and jump to it.
 @item s
 @kindex s (Folder)
 @findex wl-folder-check-current-entity
-Update new and unread number information of the folder at the current 
+Update new and unread number information of the folder at the current
 cursor point.
 (@code{wl-folder-check-current-entity})
 
@@ -1811,6 +1785,11 @@ If non-nil, summary window is appeared on the right side of the folder buffer.
 The initial setting is 20.
 Folder mode's window width when @code{wl-stay-folder-window} is non-nil.
 
+@item wl-folder-use-frame
+@vindex wl-folder-use-frame
+The initial setting is @code{nil}.
+If non-nil, use new frame for the folder window.
+
 @item wl-folder-many-unsync-threshold
 @vindex wl-folder-many-unsync-threshold
 The initial setting is 70.
@@ -1967,7 +1946,7 @@ To append new folder to the empty folder group
 firstly open it, then execute append command in the next line.
 If it is closed, folder is appended on the same level with
 the above folder group. It is difficult to explain by words so try it.
-In other words, appended position depends on the 
+In other words, appended position depends on the
 above folder group's open/close status.
 
 @subsubsection Charset of the Folders File.
@@ -1984,11 +1963,11 @@ filter can be specified while appending filter.  If you put
 
 @subsubsection Sort Folders
 
-Sorting of the folders is executed by the function specified by 
-@code{wl-fldmgr-sort-func}. 
-The initial setting is @code{wl-fldmgr-sort-standard}, 
+Sorting of the folders is executed by the function specified by
+@code{wl-fldmgr-sort-func}.
+The initial setting is @code{wl-fldmgr-sort-standard},
 which sorts alphabetically.
-Sorting affects only on the current folder group. It does not 
+Sorting affects only on the current folder group. It does not
 affect on the child groups.
 
 @subsubsection Hiding Folders in the Access Group
@@ -2025,11 +2004,11 @@ group.  But insert and delete commands can be only available for the
 children folders of the access group and they only sets the subscribe
 status.  In other words, insertion of the folder means subscribing,
 deletion means unsubscribing.
-@footnote{In the current implementation, 
+@footnote{In the current implementation,
 it is faster to delete region than to unsubscribe region.}
 
 To update the access group when children folders are inserted or deleted
-by other way (other than Wanderlust), 
+by other way (other than Wanderlust),
 open the access group by typing @kbd{C-u @key{RET}}.
 @xref{Selecting Folder}.
 
@@ -2044,7 +2023,7 @@ newly created folders are inserted on the top of the access group.
 @cindex Keybind, Folder Buffer
 
 Key bindings on the folder mode related to folder editing are shown below.
-All bindings starts with @kbd{m}, and primary commands are binded to 
+All bindings starts with @kbd{m}, and primary commands are binded to
 one stroke key binding.
 
 @table @kbd
@@ -2065,7 +2044,7 @@ Create a folder group.
 @itemx m A
 @kindex m A (Folder)
 @findex wl-fldmgr-make-access-group
-Create an access group. 
+Create an access group.
 (@code{wl-fldmgr-make-access-group})
 
 @item m d
@@ -2184,7 +2163,7 @@ Set the visibility of folder (subscribe/unsubscribe).
 @kindex r u (Folder)
 @findex wl-fldmgr-unsubscribe-region
 Set the visibility of the folders (subscribe/unsubscribe) in the
-specified region. 
+specified region.
 (@code{wl-fldmgr-unsubscribe-region})
 
 @item l
@@ -2354,7 +2333,7 @@ message has empty subject field.
 @subsection Temporary Marks
 @cindex Mark, Temporary
 
-There are four temporary marks, 
+There are four temporary marks,
 @samp{*}, @samp{D}, @samp{o} and @samp{O}.
 Temporary marks indicates message operations.
 
@@ -2375,7 +2354,7 @@ Your answer is printed in the summary line.
 @item O
 The mark to refile.
 You can put this mark by typing @kbd{O} key.
-The difference between this mark and refile mark is, 
+The difference between this mark and refile mark is,
 this mark does not delete the message while latter does.
 @end table
 
@@ -2429,8 +2408,8 @@ To operate multipart, you have to enter to the message buffer.
 @xref{Message}.
 
 @subsection Pack the Message Numbers
-You can pack the message numbers in Summary by 
-@kbd{M-x wl-summary-pack-number}. Note that only MH Folder, 
+You can pack the message numbers in Summary by
+@kbd{M-x wl-summary-pack-number}. Note that only MH Folder,
 News Spool Folder and Maildir Folder are supported folder types.
 
 
@@ -2609,7 +2588,7 @@ Following is an example of @code{wl-refile-rule-alist}.
         (("To" "Cc")
          ("\\([a-z]+\\)@@gohome.org" . "+\\1"))
         ("From"
-         ("me@@gohome.org" . ("To" ("you@@gohome.org" . 
+         ("me@@gohome.org" . ("To" ("you@@gohome.org" .
                                     "+from-me-to-you"))))))
 @end group
 @end lisp
@@ -2618,7 +2597,7 @@ After these settings, refile marks are automatically put on the condition
 matched messages by typing @kbd{C-o} (@code{wl-summary-auto-refile}).
 
 Messages which have @code{wl-summary-auto-refile-skip-marks} is skipped
-auto refiling. 
+auto refiling.
 By default, @samp{N}, @samp{U} and @samp{!} is specified, so the messages
 with these persistent marks are not automatically refiled.
 It means Wanderlust does not execute auto refile on unread messages by
@@ -2635,7 +2614,7 @@ To execute auto refile on all messages, set following.
 @cindex Summary, Sticky
 @cindex Sticky Summary
 
-The buffer of the `sticky summary' does not killed by typing @kbd{q}. 
+The buffer of the `sticky summary' does not killed by typing @kbd{q}.
 
 Sticky buffer is created by entering the summary by typing @kbd{C-u g}
 or type @kbd{M-s} (@code{wl-summary-stick}) on the normal summary.
@@ -2669,9 +2648,9 @@ Proceed reading a message at the current cursor point.
 @kindex . (Summary)
 @findex wl-summary-redisplay
 Redisplay a message at the current cursor point.
-If this command is called with prefix argument, 
+If this command is called with prefix argument,
 Redisplay message regardless of the message cache (message is re-loaded
-from source). 
+from source).
 (@code{wl-summary-redisplay})
 
 @item <
@@ -2799,7 +2778,7 @@ Save the message at current cursor point.
 @kindex n (Summary)
 @findex wl-summary-next
 Move cursor to the next message.
-If message is marked with a temporal mark in 
+If message is marked with a temporal mark in
 @code{wl-summary-skip-mark-list}, cursor is not moved to it.
 In the offline mode, cursor is not moved to the messages which are not cached
 yet.
@@ -2809,7 +2788,7 @@ yet.
 @kindex p (Summary)
 @findex wl-summary-prev
 Move cursor to the previous message.
-If message is marked with a temporal mark in 
+If message is marked with a temporal mark in
 @code{wl-summary-skip-mark-list}, cursor is not moved to it.
 In the offline mode, cursor is not moved to the messages which are not cached
 yet.
@@ -2820,6 +2799,11 @@ yet.
 @findex wl-summary-down
 Move cursor to the downward message which is unread or marked
 as @samp{$}.
+In the offline mode, cursor is not moved to the messages which are not cached
+yet.
+If there are messages which have target mark @samp{*} in the summary,
+cursor is moved to the downward message which have a target mark.
+This behavior is changed according to the value of @code{wl-summary-move-order}.
 (@code{wl-summary-down})
 
 @item P
@@ -2827,6 +2811,11 @@ as @samp{$}.
 @findex wl-summary-up
 Move cursor to the upward message which is unread or marked
 as @samp{$}.
+In the offline mode, cursor is not moved to the messages which are not cached
+yet.
+If there are messages which have target mark @samp{*} in the summary,
+cursor is moved to the downward message which have a target mark.
+This behavior is changed according to the value of @code{wl-summary-move-order}.
 (@code{wl-summary-up})
 
 @item w
@@ -2859,7 +2848,7 @@ Redisplay the message at current cursor point without MIME analysis.
 @item B
 @kindex B (Summary)
 @findex wl-summary-burst
-If the message at current cursor point has 
+If the message at current cursor point has
 encapsulates multiple messages using MIME,
 de-capsulate and extract them on the current folder.
 (@code{wl-summary-burst})
@@ -2919,7 +2908,7 @@ Jump cursor to the other message.
 @item I
 @kindex I (Summary)
 Update summary status and
-prefetch all messages which have marks included in the 
+prefetch all messages which have marks included in the
 @code{wl-summary-incorporate-marks}.
 @findex wl-summary-incorporate
 (@code{wl-summary-incorporate})
@@ -2974,7 +2963,7 @@ You can sort by @samp{date}, @samp{from}, @samp{number} and @samp{subject}.
 @findex wl-summary-toggle-thread
 Toggle the threading.
 Threading status is displayed on the modeline.
-@samp{@{S@}} means threading is off (Sequence) and 
+@samp{@{S@}} means threading is off (Sequence) and
 @samp{@{T@}} means threading is on (Thread).
 (@code{wl-summary-toggle-thread})
 
@@ -3155,7 +3144,7 @@ With prefix argument, it affects on the all messages in the thread tree.
 @item t $
 @kindex t $ (Summary)
 @findex wl-thread-mark-as-important
-Put important mark @samp{$} on the messages which are the 
+Put important mark @samp{$} on the messages which are the
 descendant of the current thread.
 If @samp{$} mark exists, it is deleted.
 With prefix argument, it affects on the all messages in the thread tree.
@@ -3217,7 +3206,7 @@ With prefix argument, it affects on the all messages in the thread tree.
 @findex wl-thread-unmark
 Unmark temporal mark on the messages which are the descendant of the
 current thread. With prefix argument, it affects on the all messages in
-the thread tree. 
+the thread tree.
 (@code{wl-thread-unmark})
 
 @item t y
@@ -3321,7 +3310,7 @@ Uudecode the messages which have target mark @samp{*}.
 @item m ?
 @kindex m ? (Summary)
 @findex wl-summary-target-mark-pick
-Pick messages from the @samp{*} marked messages. 
+Pick messages from the @samp{*} marked messages.
 That is, @samp{*} marks on the messages are remained
 if the specified condition is satisfied.
 (@code{wl-summary-target-mark-pick})
@@ -3409,12 +3398,14 @@ folder is moved.
 @vindex  wl-summary-weekday-name-lang
 The initial setting is @samp{ja}.  Specify language of the weekday.
 @samp{en} displays English, @samp{fr} displays French, @samp{de}
-displays Deutsch.
+displays Deutsch. You should rescan summary view after changing this value.
 
 @item wl-summary-fix-timezone
 @vindex  wl-summary-fix-timezone
-The initial setting is @samp{JST}.  Timezone to adjust summary's
-timezone.  If @code{nil}, adjust to GMT.
+The initial setting is @samp{nil}.
+Time zone of the date string in summary mode is adjusted using this value.
+If @code{nil}, it is adjust to the default time zone information
+(system's default time zone or environment variable @samp{TZ}).
 
 @item wl-use-petname
 @vindex  wl-use-petname
@@ -3458,6 +3449,11 @@ which is displayed when there's no @samp{Subject:} field in the message.
 The initial setting is 80.
 Width of summary line. If @code{nil}, summary line's width is as is.
 
+@item wl-summary-use-frame
+@vindex wl-summary-use-frame
+The initial setting is @code{nil}.
+If non-nil, use new frame for the summary.
+
 @item wl-use-folder-petname
 @vindex  wl-use-folder-petname
 The initial setting is the list shown below:
@@ -3616,6 +3612,7 @@ cached.
 Message Buffers utilize MIME-View mode of SEMI/tm.  For operational
 procedures and key bindings, refer to respective documents.
 @xref{MIME-View, , ,mime-ui-en, a MIME user interface for GNU Emacs}.
+You can also see help by @kbd{?} in message buffer.
 
 @kbd{p} at the top of a message or @kbd{n} at the bottom of a message
 brings you back to Summary mode.  @kbd{l} toggles display of Summary
@@ -3680,6 +3677,10 @@ If nil, the value of mime-view-visible-field-list is used.
 '("Return-Path" "Received" "^To" "^Cc" "Newsgroups" "Subject" "^From").
 Header fields in message buffer are orderd by this value.
 Each elements are regexp of field-name.
+@item wl-message-truncate-lines
+@vindex wl-message-truncate-lines
+The initial value is the value of @code{default-truncate-lines}.
+If it is non-nil, truncate long lines in message buffer.
 @end table
 
 @node Draft, Disconnected Operations, Message, Top
@@ -3711,6 +3712,7 @@ the message is saved when it is sent.
 Multi-part editing utilize MIME edit mode of SEMI/tm.  For procedures of
 editing, refer to respective documents.
 @xref{MIME-Edit, , ,mime-ui-en, a MIME user interface for GNU Emacs}.
+You can also see help by @kbd{C-c C-x ?} in draft buffer.
 
 @subsection Dynamic Modification of Messages
 @vindex wl-draft-config-alist
@@ -3731,13 +3733,13 @@ before sending the message.
 @lisp
 @group
 (setq wl-draft-config-alist
-      '(((string-match "aaa.ne.jp$" (system-name))
+      '(((string-match "aaa.example.com$" (system-name))
          ;; @r{applied if the expression is non-nil}
          (wl-smtp-posting-server . "mailserver-B")
          (wl-nntp-posting-server . "newsserver-B")
          ;; @r{settings of temporary variables}
          )
-        ("^To: .*user@@aaa.bbb.com"
+        ("^To: .*user@@aaa.bbb.example.com"
          ;; @r{applied if it matches the header of the draft buffer}
          ("Organization" . (format "Go %s" my-webpage)))
                        ;; @r{you can write elisp expressions here (eval only)}
@@ -3826,11 +3828,11 @@ invoked.
 
 Note that @code{wl-draft-config-alist} is applied only once when
 @code{wl-draft-send-and-exit} or @code{wl-draft-send} is invoked.
-Therefore, if you want to apply @code{wl-draft-config-alist} again after 
+Therefore, if you want to apply @code{wl-draft-config-alist} again after
 aborting transmission, execute @kbd{C-c C-e}
 (@code{wl-draft-config-exec}) explicitly.
 
-If you don't want to apply @code{wl-draft-config-alist} when 
+If you don't want to apply @code{wl-draft-config-alist} when
 @code{wl-draft-send-and-exit} or @code{wl-draft-send} is invoked,
 do the following:
 
@@ -3838,7 +3840,7 @@ do the following:
 (remove-hook 'wl-draft-send-hook 'wl-draft-config-exec)
 @end lisp
 
-If you want to apply @code{wl-draft-config-alist} when a draft buffer is 
+If you want to apply @code{wl-draft-config-alist} when a draft buffer is
 prepared, do the following:
 
 @lisp
@@ -3872,7 +3874,7 @@ The format of @code{wl-template-alist} is almost the same as
          (body . "Hello.\n"))
         ("report"
          (template . "default")                 ;; @r{(a)}
-         ("To" . "jousi@@kaisha.jp")
+         ("To" . "boss@@example.com")
          ("Subject" . "Report")
          (body-file . "~/work/report.txt")
          )
@@ -3894,7 +3896,7 @@ window is shown below the draft buffer.  You can select a template by
 @kbd{n} and @kbd{p} seeing the buffer window.
 
 Press the @key{RET} key and the template is actually applied to the draft
-buffer.  If you press @kbd{q}, nothing is applied.  In addition, you can 
+buffer.  If you press @kbd{q}, nothing is applied.  In addition, you can
 adjust the window size by @code{wl-template-buffer-lines}.
 
 If @code{wl-template-visible-select} is @code{nil}, you should type the
@@ -3942,7 +3944,7 @@ If non-nil, POP connection is established using SSL.  If
 unset, @code{elmo-default-pop3-stream-type} is used.
 @end table
 
-If variables for POP-before-SMTP (@code{wl-pop-before-smtp-*}) are 
+If variables for POP-before-SMTP (@code{wl-pop-before-smtp-*}) are
 unset, settings for POP folders (@code{elmo-default-pop3-*}) are
 used.
 Therefore, if SMTP server and POP server are actually the same, and if
@@ -4024,6 +4026,12 @@ the @samp{+draft} folder.
 Encodes or decodes the specified region in Caesar cipher.
 (@code{wl-caesar-region})
 
+@item C-l
+@kindex C-l (Draft)
+@findex wl-draft-highlight-and-recenter
+Recenter and rehighlight current draft.
+(@code{wl-draft-highlight-and-recenter})
+
 @item M-t
 @kindex M-t (Draft)
 @findex wl-toggle-plugged
@@ -4178,7 +4186,7 @@ template while previewing.
 @item wl-template-buffer-lines
 @vindex wl-template-buffer-lines
 The initial setting is 7.
-If @code{wl-template-visible-select} is non-nil, this variable specifies 
+If @code{wl-template-visible-select} is non-nil, this variable specifies
 the size of the preview window.
 
 @item wl-draft-reply-buffer-style
@@ -4192,6 +4200,11 @@ a reply draft buffer when it is prepared.
 The initial setting is @code{nil}.
 If non-nil, use new frame for the draft.
 
+@item wl-draft-truncate-lines
+@vindex wl-draft-truncate-lines
+The initial value is the value of @code{default-truncate-lines}.
+If it is non-nil, truncate long lines in draft buffer.
+
 @item wl-from
 @vindex wl-from
 The initial setting is the value of the variable
@@ -4243,8 +4256,8 @@ sent off-line.
 
 @item wl-draft-use-cache
 @vindex wl-draft-use-cache
-The initial setting is @code{t}.
-If non-nil, cache the message which is sent.
+The initial setting is @code{nil}. If the value is non-nil and
+@code{wl-insert-message-id} is nil, cache the message which is sent.
 
 @item wl-auto-flush-queue
 @vindex wl-auto-flush-queue
@@ -4497,7 +4510,7 @@ re-filed or copied to the specified folders are appended to the folder
 @subsection Creation of Folders (IMAP4)
 
 You can create IMAP folders off-line.  The creation of folders are
-reflected in the servers when Wanderlust becomes on-line.  At that time, 
+reflected in the servers when Wanderlust becomes on-line.  At that time,
 if folders failed to be created on the servers for any reasons, messages
 re-filed to such folders are appended to the folder @samp{+lost+found}.
 
@@ -4532,7 +4545,7 @@ remove caches for messages relevant to off-line operations.
 @node Plugged Mode, Off-line State settings, Enable Operations, Disconnected Operations
 @section Switching On-line/Off-line per Server/Port
 
-@kbd{M-t} described above switches networking states as a whole, but you 
+@kbd{M-t} described above switches networking states as a whole, but you
 can switch on-line/off-line per server/port.
 
 Pressing @kbd{C-t} in the folder or summary modes brings you in
@@ -4578,7 +4591,7 @@ off-line (in XEmacs or Emacs 21, they are shown with icons).  Pressing
 @samp{+queue} for off-line transmission, and @dfn{dop queue} means
 off-line operations when @code{elmo-enable-disconnected-operation} is
 @code{t}.
-@c If the variable @code{elmo-enable-disconnected-operation} is non-nil, 
+@c If the variable @code{elmo-enable-disconnected-operation} is non-nil,
 @c off-line operations are enabled.
 
 They are displayed if there are any of them.  In the example above, in
@@ -4604,7 +4617,7 @@ off-line state.  You can specify off-line state on a per server or port
 basis.  Refer to @code{wl-reset-plugged-alist} also.
 
 Usually, when Wanderlust starts up, the plugged state of each port is
-read from @file{~/.folder} and @code{wl-smtp-posting-server},
+read from @file{~/.folders} and @code{wl-smtp-posting-server},
 @code{wl-nntp-posting-server} and so on.  If you want to change the
 plugged state of these ports or to add other ports, configure
 @code{wl-make-plugged-hook} with a function.
@@ -4660,7 +4673,7 @@ appended while the off-line re-file/copy queue is processed.
 @item elmo-plugged-condition
 @vindex elmo-plugged-condition
 The initial setting is @code{one}.
-The value of @code{wl-plugged} reflects the return value of the function 
+The value of @code{wl-plugged} reflects the return value of the function
 @code{elmo-plugged-p} (without arguments).
 This variable @code{elmo-plugged-condition} specifies the condition on
 which the return value of @code{(elmo-plugged-p)} should be t depending on the
@@ -4884,7 +4897,7 @@ re-files every certain number of messages to archiving folders.
 
 This differs from @samp{wl-expire-archive-number1} in that this re-files
 to the folder up to the specified number regardless of message numbers.
-The archiving folders to which messages are re-filed are determined in the 
+The archiving folders to which messages are re-filed are determined in the
 same way as @code{wl-expire-archive-number1}.
 
 @item wl-expire-archive-date
@@ -5026,7 +5039,7 @@ following settings as well:
 @table @code
 @item all
 All messages with permanent marks are retained,
-i.e. @code{wl-summary-read-uncached-mark} is included in addition to the 
+i.e. @code{wl-summary-read-uncached-mark} is included in addition to the
 defaults.
 
 @item none
@@ -5050,7 +5063,7 @@ messages with @code{wl-summary-expire-reserve-marks} are also retained.
 @vindex wl-expire-archive-get-folder-func
 The initial setting is @code{wl-expire-archive-get-folder}.
 
-This variable specifies a function that returns the name of an archiving 
+This variable specifies a function that returns the name of an archiving
 folder for standard functions in the place of @var{destination}.
 You can use the following three variables for simple modification of
 folder names; if you want more complex settings, define your own
@@ -5180,7 +5193,7 @@ folders only.
 folders.  If there are the archiving folders already, only new messages
 are appended.
 
-You can use @code{wl-archive-alist} in order to specify how messages are 
+You can use @code{wl-archive-alist} in order to specify how messages are
 archived according to their folder names, as in @code{wl-expire-alist}.
 For example:
 
@@ -5220,7 +5233,7 @@ These functions are good to archive all messages in a folder by their
 numbers or by their dates.
 These are also useful for backup or confirmation purposes before
 expiration.
-If you try to re-file them after they are archived, they are deleted but 
+If you try to re-file them after they are archived, they are deleted but
 not re-filed.
 
 Per default, the archiving folders to which messages are copied are
@@ -5294,7 +5307,7 @@ Wanderlust specifics.
 
 @subsection Score File Specification
 
-@code{wl-score-folder-alist} specifies score files or variables in which 
+@code{wl-score-folder-alist} specifies score files or variables in which
 scores are defined, corresponding to folder names.
 
 @lisp
@@ -5353,10 +5366,10 @@ For example, for "subject" field, a type and a time limit are prompted,
 but for "from" field, they are fixed upon automatically as substring and
 permanent respectively.
 However, score values can be modified by the prefix argument.
-Typing @kbd{?} at the mini-buffer shows a help on keys and corresponding 
+Typing @kbd{?} at the mini-buffer shows a help on keys and corresponding
 headers and types.
 
-At last, type @kbd{C-c C-c} in the score editing buffer.  This saves the 
+At last, type @kbd{C-c C-c} in the score editing buffer.  This saves the
 score file and terminates the edit mode.  Typing @kbd{C-c C-c} after
 erasing contents of the buffer deletes the score file being edited.
 
@@ -5701,7 +5714,7 @@ retrieved.
 
 @end enumerate
 
-The sum of these scores @emph{after all factors are applied} becomes the 
+The sum of these scores @emph{after all factors are applied} becomes the
 score of the message.
 
 @cindex Score File Atoms
@@ -5731,7 +5744,7 @@ The default is @code{wl-summary-important-above}.
 
 @subsection Caveats
 
-Not to mention the @code{extra} key, if @code{lines} or @code{xref} keys 
+Not to mention the @code{extra} key, if @code{lines} or @code{xref} keys
 are used, you need to set @code{elmo-msgdb-extra-fields}.
 
 @lisp
@@ -5791,6 +5804,7 @@ Examples with other packages.
 * x-face-mule::                 x-face-mule.el
 * dired-dd::                    dired-dd.el
 * MHC::                         MHC
+* mime-w3m::                    mime-w3m.el
 @end menu
 
 
@@ -5962,7 +5976,7 @@ specific, but general-purpose for tm/SEMI).
 @end group
 @end lisp
 
-@node MHC, , dired-dd, Living with other packages
+@node MHC, mime-w3m, dired-dd, Living with other packages
 @subsection mhc.el
 @pindex MHC
 
@@ -5991,6 +6005,15 @@ For mhc-current:
 @end group
 @end lisp
 
+@node mime-w3m,  , MHC, Living with other packages
+@subsection mime-w3m.el
+@pindex mime-w3m
+
+You can display html part by using @file{mime-w3m.el}
+distributed with emacs-w3m (@uref{http://emacs-w3m.namazu.org/}).
+You can find the usage in comment region at the head of @file{mime-w3m.el}.
+
+
 @node Highlights, Biff, Living with other packages, Customization
 @section Highlights
 
@@ -6041,7 +6064,7 @@ regular expressions.
 
 @item wl-highlight-citation-prefix-regexp
 @vindex  wl-highlight-citation-prefix-regexp
-Specifies a regular expression to which quoted lines in bodies of 
+Specifies a regular expression to which quoted lines in bodies of
 drafts and messages match.
 Bodies matching to this regular expression are highlighted by the faces
 specified by (@code{wl-highlight-message-cited-text-*}).
@@ -6259,16 +6282,16 @@ If @code{nil}, wl doesn't check mail arrival.
 @item wl-biff-check-interval
 @vindex wl-biff-check-interval
 The initial setting is 40 (in seconds).
-Check mail arrival in this period. 
+Check mail arrival in this period.
 
 @item wl-biff-notify-hook
 @vindex wl-biff-notify-hook
-The initial setting is @code{nil}.
-This is a hook run at the arrival of the new mail.
-To beep, set as:
+This hook is run at the arrival of new mail.
+To beep with mail arrival(initial setting), set as follows.
 @lisp
-(setq wl-biff-notify-hook '(beep))
+(setq wl-biff-notify-hook '(ding))
 @end lisp
+For silence, set to @code{nil}.
 @end table
 
 
@@ -6309,7 +6332,7 @@ following settings:
 in the original message, @samp{Reply-To:} field in the original is
 copied to @samp{To:} field.)
 
-Moreover, the behavior of @kbd{a} with prefix argument can 
+Moreover, the behavior of @kbd{a} with prefix argument can
 be directed by @code{wl-draft-reply-with-argument-list} as well.
 
 Note: To set the behavior when you reply to the message written by yourself, use
@@ -6428,7 +6451,7 @@ If non-nil, you are asked for confirmation when Wanderlust terminates.
 
 @item wl-interactive-send
 @vindex wl-interactive-send
-The initial setting is @code{nil}.
+The initial setting is @code{t}.
 If non-nil, you are asked for confirmation when mail is sent.
 
 @item wl-folder-sync-range-alist
@@ -6708,7 +6731,7 @@ If you send a bug report, please attach Backtrace with it.
 @footnote{@uref{http://www.jpl.org/elips/BUGS-ja.html} describes how to
 in Japanese.}
 
-I would like to express my thanks to the members of the mailing list for 
+I would like to express my thanks to the members of the mailing list for
 valuable advice and many pieces of code they contributed.
 
 
@@ -6753,6 +6776,7 @@ valuable advice and many pieces of code they contributed.
       9/12    biff feature with Satata-san & Yamaoka-san.
      10/17    expire-hide by Okada-san.
      11/08    Released 2.4.0 stable.
+2001  7/04    Released 2.6.0 stable.
 @end example
 
 See @file{ChangeLog} for details.
@@ -6815,6 +6839,6 @@ U.S. Billboard magazines in 1980s.
 @contents
 @bye
 
-@c Local Variables: 
+@c Local Variables:
 @c fill-column: 72
 @c End: