* elmo-imap4.el: Remove trailing whitespace.
[elisp/wanderlust.git] / doc / wl.texi
index bd4de19..a7997f6 100644 (file)
@@ -671,9 +671,10 @@ This chapter describes the folder types which Wanderlust is able to handle.
 Wanderlust uses ELMO as it's interface, so you can use every folder types
 supported by ELMO.
 
-As of version @value{VERSION}, 14 types of folders are predefined. These
+As of version @value{VERSION}, 15 types of folders are predefined. These
 are IMAP, NNTP, LocalDir(MH), Maildir, News Spool, Archive, POP,
-Shimbun, Namazu, Multi, Filter, Pipe, Internal and File folder types.
+Shimbun, Search, Multi, Filter, Pipe, File, Access and Internal folder
+types.
 
 @menu
 * IMAP Folder::                 @samp{%} -- IMAP folder
@@ -684,12 +685,13 @@ Shimbun, Namazu, Multi, Filter, Pipe, Internal and File folder types.
 * Archive Folder::              @samp{$} -- Archive folder
 * POP Folder::                  @samp{&} -- POP folder
 * Shimbun Folder::              @samp{@@} -- Shimbun Folder
-* Namazu Folder::               @samp{[} -- Namazu Folder
+* Search Folder::               @samp{[} -- Search Folder
 * Multi Folder::                @samp{*} -- Multi folder
 * Filter Folder::               @samp{/} -- Filter folder
 * Pipe Folder::                 @samp{|} -- Pipe folder
 * Internal Folder::             @samp{'} -- Internal folder
 * File Folder::                          -- File folder
+* Access Folder::                        -- Access folder
 @end menu
 
 
@@ -835,7 +837,7 @@ Format:
 
 @example
 @group
-@samp{-} @var{newsgroup} [[@samp{:} @var{username}][@samp{@@} @var{hostname}][@samp{:} @var{port}]][@samp{!}]
+@samp{-} @var{newsgroup} [@samp{:} @var{username}][@samp{@@} @var{hostname}][@samp{:} @var{port}][@samp{!}]
 @end group
 @end example
 
@@ -1224,7 +1226,7 @@ Format:
 
 @example
 @group
-@samp{&} [@var{username}][[@samp{/} @var{authenticate-type}][@samp{:} @var{numbering-method}][@samp{@@} @var{hostname}][@samp{:} @var{port}]][@samp{!}]
+@samp{&} [@var{username}][@samp{/} @var{authenticate-type}][@samp{:} @var{numbering-method}][@samp{@@} @var{hostname}][@samp{:} @var{port}][@samp{!}]
 @end group
 @end example
 
@@ -1278,7 +1280,7 @@ normal connection in these cases, add @samp{!direct} at the end of
 folder name.
 
 
-@node Shimbun Folder, Namazu Folder, POP Folder, Folders
+@node Shimbun Folder, Search Folder, POP Folder, Folders
 @section Shimbun Folder
 @cindex @samp{@@}
 @cindex Shimbun Folder
@@ -1330,30 +1332,56 @@ Example:
       '("^@@airs\\." "^@@namazu\\."))
 @end example
 
-@kbd{s rescan} is needed after fetching to update summary view.
+Update summary view automatically after fetching.
 @end table
 
 
-@node Namazu Folder, Multi Folder, Shimbun Folder, Folders
-@section Namazu Folder
+@node Search Folder, Multi Folder, Shimbun Folder, Folders
+@section Search Folder
 @cindex @samp{[}
-@cindex Namazu Folder
-@cindex Folder, Namazu
+@cindex Search Folder
+@cindex Folder, Search
 @cindex Folder, Text Search
-@pindex Namazu
-@pindex nmz
-A folder to access messages found in namazu-index with some condition.
-It uses namazu (@uref{http://www.namazu.org/}) for search.
+
+A folder to access messages found by an external program with some
+condition.
 
 Format:
 
 @example
 @group
-@samp{[} @var{search condition} @samp{]} [ @var{absolute path of namazu index} ]
+@samp{[} @var{search condition} @samp{]} [ @var{search target} [ @samp{!} @var{search engine} ] ]
 @end group
 @end example
 
-Default value of the path of namazu index can be assigned by @code{elmo-nmz-default-index-path}.
+The format of the @var{search condition} and @var{search target} depend
+on the @var{search engine}.
+
+@subsection Supported search engines
+
+Supported search engines are following ones.  Default search engine can
+be assigned by @code{elmo-search-default-engine}.
+
+@menu
+* namazu::      namazu
+* grep::        grep
+@end menu
+
+
+@node namazu, grep, Search Folder, Search Folder
+@subsection namazu
+@pindex namazu
+
+The messages registered in the namazu-index is found by using namazu
+(@uref{http://www.namazu.org/}).
+
+@var{search condition} is a query of namazu.  Please refer to the
+document of the attached to namazu for details.
+
+@var{search target} is a namazu-index used for search.  The directory
+with the index or the alias that explain in the following can be
+specified.  Default value of the path of namazu index can be assigned by
+@code{elmo-search-namazu-default-index-path}.
 
 Example:
 
@@ -1366,7 +1394,7 @@ Example:
 @end group
 @end example
 
-@subsection TIPS
+@c @subsection TIPS
 
 @subsubsection Enter space to separate keywords
 
@@ -1379,7 +1407,7 @@ You can define an alias name for index.
 Example:
 
 @example
-(setq elmo-nmz-index-alias-alist
+(setq elmo-search-namazu-index-alias-alist
       '(("cache" . "~/.elmo/cache")
         ("docs" . "~/documents")))
 @end example
@@ -1396,15 +1424,15 @@ directory @file{~/.elmo/cache}.
 
 @subsubsection Multiple indices
 
-You can specify a list for @code{elmo-nmz-default-index-path} and
-@code{elmo-nmz-index-alias-alist}.
+You can specify a list for @code{elmo-search-namazu-default-index-path} and
+@code{elmo-search-namazu-index-alias-alist}.
 When list is specified, all index contained in the list is used as the 
 namazu indices.
 
 Example:
 
 @example
-(setq elmo-nmz-index-alias-alist
+(setq elmo-search-namazu-index-alias-alist
       '(("all" . ("~/.elmo/cache" "~/documents"))
         ("cache" . "~/.elmo/cache")))
 @end example
@@ -1418,7 +1446,32 @@ Using above alias setting, you can specify
 to execute a namazu search with keyword @samp{wanderlust} using indices in the 
 directory @file{~/.elmo/cache} and @file{~/documents}.
 
-@node Multi Folder, Filter Folder, Namazu Folder, Folders
+@node grep,  , namazu, Search Folder
+@subsection grep
+@pindex grep
+
+The files that exists in the directory specified with the @var{search
+target} are found by using grep.
+
+@var{search condition} is a regular expression of grep.  The directory
+as @var{search target} cannot be omitted.
+
+Example:
+
+@example
+@group
+[wanderlust]~/Mail/inbox!grep
+    -> search messages matched with "wanderlust"
+       from the directory "~/Mail/inbox"
+
+["[sr]emi"]~/Mail/semi!grep
+    -> If @samp{]} is included in regular expression,
+       @var{search condition} should be enclosed with @samp{"}.
+@end group
+@end example
+
+
+@node Multi Folder, Filter Folder, Search Folder, Folders
 @section Multi Folder
 @cindex @samp{*}
 @cindex Multi Folder
@@ -1493,8 +1546,8 @@ Example:
 @item
 Date filter: @samp{since:@var{date}}, @samp{before:@var{date}}
 
-since: only messages arrived since @var{date} are picked.
-before: only messages arrived before @var{date} are picked.
+since: only messages arrived since @var{date} are picked (@var{date} is included).
+before: only messages arrived before @var{date} are picked (@var{date} is not included).
 
 You can specify following as @var{date}.
 
@@ -1747,7 +1800,7 @@ the name of the subdirectories of the cache directory
 (@file{~/.elmo/cache}).
 
 
-@node File Folder,  , Internal Folder, Folders
+@node File Folder, Access Folder, Internal Folder, Folders
 @section File folder
 @cindex File Folder
 
@@ -1770,6 +1823,31 @@ file:/etc       -> @file{/etc}
 @end example
 
 
+@node Access Folder,  , File Folder, Folders
+@section Access folder
+@cindex Access Folder
+
+A folder to access virtual folder which collects messages from a root
+folder and subfolders of one.  The add and remove of the subfolder is
+automatically reflected.
+
+
+Format:
+
+@example
+@samp{access:} @var{root-folder}
+@end example
+
+Example:
+
+@example
+@group
+access:%INBOX -> All subfolders of IMAP mailbox "inbox".
+access:'cache -> All of 'cache folder
+@end group
+@end example
+
+
 @node Folder, Summary, Folders, Top
 @chapter Folder mode
 @cindex Folder
@@ -2637,7 +2715,7 @@ message has empty subject field.
 @subsection Temporary Marks
 @cindex Mark, Temporary
 
-There are four temporary marks,
+There are seven temporary marks,
 @samp{*}, @samp{d}, @samp{D}, @samp{o}, @samp{O}, @samp{i} and @samp{~}.
 Temporary marks indicates message operations.
 
@@ -2678,8 +2756,8 @@ Your answer is printed in the summary line.
 
 @subsection Persistent Marks
 
-There are five persistent marks, @samp{!}, @samp{N}, @samp{n}, @samp{U},
-@samp{u}, @samp{A}, @samp{a} and @samp{$}.
+There are ten persistent marks, @samp{!}, @samp{N}, @samp{n}, @samp{U},
+@samp{u}, @samp{A}, @samp{a}, @samp{F}, @samp{f} and @samp{$}.
 
 The persistent mark indicates the message's status and it is saved.
 Each persistent mark indicates:
@@ -2702,7 +2780,12 @@ message with @samp{!} is not cached yet.
 It is already replied message.
 @item a
 It is already replied message. It differs from @samp{A} that message
-with @samp{u} is already cached.
+with @samp{a} is already cached.
+@item F
+It is already forwarded message.
+@item f
+It is already forwarded message. It differs from @samp{F} that message
+with @samp{f} is already cached.
 @item $
 It is a message with some global flag.  It is convenient to put this
 mark on the messages to remember (If you want to remember to write a
@@ -2716,10 +2799,10 @@ If the message is read and cached (or local message),there are no
 persistent mark.
 @end table
 
-@samp{N}, @samp{U}, @samp{!}, @samp{A} indicates that the message have
-no cache.  Messages with the marks other than these, you can read them
-in the offline status even they are in the IMAP folder or netnews
-folder.
+@samp{N}, @samp{U}, @samp{!}, @samp{A}, @samp{F} indicates that the
+message have no cache.  Messages with the marks other than these, you
+can read them in the offline status even they are in the IMAP folder or
+netnews folder.
 
 Among messages with persistent marks, ones with marks specified by 
 @code{wl-summary-expire-reserve-marks} are excluded from the expiration
@@ -2811,22 +2894,13 @@ variables.
 @table @code
 @item wl-message-buffer-prefetch-folder-type-list
 @vindex wl-message-buffer-prefetch-folder-type-list
-The initial setting is @code{t}. In this case, prefetch messages in all
-folders.
-If it is a list of folder types, it specifies the folder types in which
-message prefetching is enabled.
-Following is an example (prefetch messages in nntp and imap4 folders)
-
-@lisp
-@group
-(setq wl-message-buffer-prefetch-folder-type-list
-      '(nntp imap4))
-@end group
-@end lisp
-
-In this case, multi folder that contains localdir and imap4 prefetches
-only imap4 messages.  This variable precedes the value of
+The initial setting is @code{'(imap4 nntp)}.  If it is a list of folder
+types, it specifies the folder types in which message prefetching is
+enabled. In initial setting, messages are prefetch only in the nntp and
+imap4 folders. In this case, multi folder that contains localdir and 
+imap4 prefetches only imap4 messages. This variable precedes the value of
 @code{wl-message-buffer-prefetch-folder-list}.
+To prefetch messages in all folder types, specify @code{t}.
 
 @item wl-message-buffer-prefetch-folder-list
 @vindex wl-message-buffer-prefetch-folder-list
@@ -2835,11 +2909,11 @@ A list of regexp of folders to enable message prefetching.
 
 @item wl-message-buffer-prefetch-depth
 @vindex wl-message-buffer-prefetch-depth
-The initial setting is 3. The number of messages for automatical prefetch.
+The initial setting is 1. The number of messages for automatical prefetch.
 
 @item wl-message-buffer-prefetch-idle-time
 @vindex wl-message-buffer-prefetch-idle-time
-The initial setting is 0.2 (in seconds). The period of automatical prefetch.
+The initial setting is 1 (in seconds). The period of automatical prefetch.
 
 @item wl-message-buffer-prefetch-threshold
 @vindex wl-message-buffer-prefetch-threshold
@@ -3002,8 +3076,19 @@ An example follows.
 @end group
 @end lisp
 
-Where the number set the column number of the field (for negative value,
-filled from right)
+Where the number set the column number of the field. If negative value,
+the column is filled from right. If the number begins with @samp{0},
+@samp{0} is used for filling columns instead of @samp{ }.
+
+Example:
+
+@example
+@group
+%5n   -> `1    '
+%-05n -> `00001'
+@end group
+@end example
+
 
 Major control strings defined by @code{wl-summary-line-format-spec-alist}
 are displayed in the following list.
@@ -3011,6 +3096,8 @@ are displayed in the following list.
 @example
 @group
 %n  message number
+%T  temporary mark
+%P  persistent mark
 %Y  year
 %M  month
 %D  day
@@ -3025,14 +3112,15 @@ are displayed in the following list.
 %S  size
 %c  +number-of-children: (display only for opened thread)
 %C  [+number-of-children] (display only for opened thread)
-%T  temporary mark (mandatory)
-%P  persistent mark (mandatory)
+%#  mailing list information (`(' ML-name [ ` ' ML-number ] `)')
+%l  number in the mailing list
+%@@ `@@' only if the first MIME part is multipart/mixed
+%~  ` ' only if previous column is not empty
 @end group
 @end example
 
-@code{wl-summary-line-format} must contain temporary mark (@samp{%T})
-and persistent mark (@samp{%P}). Furthermore, these marks must appear at
-the constant column. For example, if you specify @samp{%T} or
+The temporary mark (@samp{%T}) and persistent mark (@samp{%P}) must
+appear at the constant column. For example, if you specify @samp{%T} or
 @samp{%P} after the @samp{%t}, which changes its length by thread
 position, marks are not treated correctly.
 
@@ -3172,10 +3260,13 @@ Display the previous page of the message at the current cursor point.
 
 @item @key{RET}
 @kindex @key{RET} (Summary)
-@findex wl-summary-next-line-content
+@findex wl-summary-enter-handler
 Display the next line of the message at the current cursor point.
-Display the message at the current cursor point if it is not displayed yet.
-(@code{wl-summary-next-line-content})
+Display the message at the current cursor point if it is not displayed
+yet.  (@code{wl-summary-next-line-content}) If prefix argument is
+specified, message is scrolled up by one line.
+(@code{wl-summary-prev-line-content}) If prefix argument is numeric,
+cursor is jumped to the message with specified number.
 
 @item -
 @itemx M-@key{RET}
@@ -3548,6 +3639,10 @@ Jump to the message which is displayed last.
 @item ?
 @kindex ? (Summary)
 Put @samp{*} mark on the messages that satisfies the specified condition.
+If messages already have @samp{*} mark, new @samp{*} marks are overridden.
+If prefix argument is specified, current @samp{*} marks are removed and
+new @samp{*} marks are appended.
+
 @findex wl-summary-pick
 (@code{wl-summary-pick})
 
@@ -4056,12 +4151,6 @@ If non-nil, sender part displays nickname.
 The initial setting is @code{t}.
 If non-nil, message is split as pages by @samp{^L}.
 
-@item wl-message-window-size
-@vindex  wl-message-window-size
-The initial setting is '(1 . 4).
-A cons cell to specify the rate of summary and message window.
-car:cdr corresponds summary:message.
-
 @item wl-summary-from-function
 @vindex wl-summary-from-function
 Format function to display sender in summary.
@@ -4289,6 +4378,12 @@ cached.
 The initial setting is @code{t}.  If non-nil, messages read in Shimbun
 folders are cached.
 
+@item wl-summary-resend-use-cache
+@vindex wl-summary-resend-use-cache
+The initial setting is @code{nil}.  If non-nil, messages are resend
+using cache even in the offline status. Note that if you use cache,
+the message identity is not guaranteed.
+
 @item wl-folder-process-duplicates-alist
 @vindex wl-folder-process-duplicates-alist
 The initial setting is @code{nil}.
@@ -4419,7 +4514,7 @@ message number will be changed.
 @table @code
 @item wl-message-window-size
 @vindex wl-message-window-size
-Initial setting is @code{'(1 . 4)}.  It is a cons cell and the ratio of
+Initial setting is @code{(1 . 4)}.  It is a cons cell and the ratio of
 its car and cdr value corresponds to the ratio of Summary and Message
 windows.
 
@@ -4449,6 +4544,12 @@ Each elements are regexp of field-name.
 @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.
+
+@item wl-message-auto-reassemble-message/partial
+@vindex wl-message-auto-reassemble-message/partial
+The initial setting is @code{nil}.
+If non-nil, automatically reassemble fragments of the message on
+displaying when its MIME media type is message/partial.
 @end table
 
 @node Draft, Disconnected Operations, Message, Top
@@ -4472,6 +4573,7 @@ with those if possible.
 Basically it is Emacs-standard mail mode.
 
 @menu
+* Parameters for Sending::
 * Editing Header::
 * Editing Message Body and Sending::
 * Dynamical Message Re-arrangement::
@@ -4479,7 +4581,55 @@ Basically it is Emacs-standard mail mode.
 * POP-before-SMTP::
 @end menu
 
-@node Editing Header, Editing Message Body and Sending, Usage of Draft Mode, Usage of Draft Mode
+@node Parameters for Sending, Editing Header, Usage of Draft Mode, Usage of Draft Mode
+@subsection Parameters for Sending
+
+According to the information of servers to send messages, configure
+following variables.
+
+@table @code
+@item wl-smtp-posting-server
+The name of the SMTP server used for mail transmission.
+
+@item wl-smtp-posting-port
+The SMTP port number for mail transmission.
+Without configuration, use default SMTP port number (25).
+
+@item wl-nntp-posting-server
+The name of NNTP server used for news submission.
+Without configuration, use @code{elmo-nntp-default-server}.
+
+@item wl-nntp-posting-port
+The NNTP port number for news submission.
+Without configuration, use @code{elmo-nntp-default-port}.
+@end table
+
+You may configure following variables on demand. See section
+Variables of Draft Mode for detail @xref{Variables of Draft Mode}.
+
+@table @code
+@item wl-smtp-posting-user
+User name for authentication by SMTP AUTH.
+
+@item wl-smtp-authenticate-type
+The authentication method for SMTP AUTH.
+Without configuration, authentication will not be carried out.
+
+@item wl-smtp-authenticate-realm
+The authentication realm for SMTP AUTH.
+Without configuration, authentication realm will not be specified.
+
+@item wl-smtp-connection-type
+Specify how to establish SMTP connections.
+
+@item wl-nntp-posting-user
+User name for AUTHINFO authentication on news submission.
+
+@item wl-nntp-posting-stream-type
+Specify how to establish NNTP connections.
+@end table
+
+@node Editing Header, Editing Message Body and Sending, Parameters for Sending, Usage of Draft Mode
 @subsection Editing Message Header
 
 You can freely edit header region above @samp{--text follows this line--},
@@ -4760,6 +4910,9 @@ adjust the window size by @code{wl-template-buffer-lines}.
 If @code{wl-template-visible-select} is @code{nil}, you should type the
 name of the template in the mini buffer.
 
+If @code{wl-template-select} is executed with prefix argument,
+inversed value of @code{wl-template-visible-select} is used.
+
 As shown in the example in @code{wl-draft-config-alist}, you can select
 @samp{default} template by writing:
 
@@ -4771,14 +4924,15 @@ As shown in the example in @code{wl-draft-config-alist}, you can select
 @subsection Sending mail by POP-before-SMTP
 @cindex POP-before-SMTP
 
-You can send mail by POP-before-SMTP with this single line:
+You can send mail by POP-before-SMTP. Necessary setting is
 
 @lisp
 (setq wl-draft-send-mail-function 'wl-draft-send-mail-with-pop-before-smtp)
 @end lisp
 
 @noindent
-Configure the following variables if you need.
+to change mail posting function from its default value @code{wl-draft-send-mail-with-smtp}.
+Also you would configure following variables on demand.
 
 @table @code
 @item wl-pop-before-smtp-user
@@ -4814,7 +4968,6 @@ Refer to the following URL about POP-before-SMTP.
 
 @example
 @group
-http://spam.ayamura.org/tools/smPbS.html
 http://www.iecc.com/pop-before-smtp.html
 @end group
 @end example
@@ -4833,7 +4986,8 @@ http://www.iecc.com/pop-before-smtp.html
 Cites the content of the current message buffer (the part under cursor).
 If the region is active, cites the region (it affects only if
 @code{transient-mark-mode} (on GNU Emacs) or @code{zmacs-regions}
-(on XEmacs) is Non-nil).
+(on XEmacs) is Non-nil). If the command is called with prefix argument,
+the text inserted by yank command (the text content of clipboard) is cited.
 (@code{wl-draft-yank-original})
 
 @item C-c C-p
@@ -5180,6 +5334,12 @@ If non-nil, always removes your own address from @samp{To:} and
 If any of @code{wl-subscribed-mailing-list} are contained in @samp{To:}
 or @samp{Cc:} field, do not insert @samp{Bcc:} or @samp{Fcc:} field.
 
+@item wl-draft-send-mail-function
+@vindex wl-draft-send-mail-function
+The initial setting is @code{wl-draft-send-mail-with-smtp}.
+This is the function to post mails. To use POP-before-SMTP, set this to
+@code{wl-draft-send-mail-with-pop-before-smtp}.
+
 @item wl-smtp-posting-server
 @vindex wl-smtp-posting-server
 The initial setting is @code{nil}.
@@ -5217,7 +5377,7 @@ If @code{nil}, authentication realm is not specified in the authentication.
 The initial setting is @code{nil}.
 This symbol-valued variable specifies how to establish SMTP connections.
 If @code{nil}, use default connection type.
-If it is @code{starttls}, use STARTTLS (RFC2595).
+If it is @code{starttls}, use STARTTLS (RFC3207).
 If it is @code{ssl}, use SSL.
 
 @item wl-nntp-posting-server
@@ -5237,7 +5397,7 @@ If it is still @code{nil}, AUTHINFO authentication will not be carried out.
 @vindex wl-nntp-posting-port
 The initial setting is @code{nil}.
 This is the port number of the NNTP server used for news submission.
-If @code{nil}, @code{elmo-nntp-default-server} is used.
+If @code{nil}, @code{elmo-nntp-default-port} is used.
 
 @item wl-nntp-posting-stream-type
 @vindex wl-nntp-posting-stream-type
@@ -5403,12 +5563,15 @@ later) is non-nil, you can following operations:
 * Re-file and Copy queue::      Re-file and Copy (IMAP4)
 * Creation of Folders::         Create Folders off-line (IMAP4)
 * Marking::                     Mark (IMAP4)
-* Pre-fetching Reservations::   Pre-fetch (IMAP4, NNTP)
+* Pre-fetching Reservations::   Pre-fetch
 @end menu
 
 As soon as Wanderlust becomes on-line, such operations invoked off-line
 are reflected in the servers via network.
 
+If the variable @code{elmo-enable-disconnected-operation} is @code{nil},
+these off-line operations are not executed and causes an error on
+re-file or copy operations.
 
 @node Send Messages off-line, Re-file and Copy queue, Enable Operations, Enable Operations
 @subsection Transmission of Messages
@@ -5459,23 +5622,12 @@ are also reflected in the servers when Wanderlust becomes on-line.
 
 
 @node Pre-fetching Reservations,  , Marking, Enable Operations
-@subsection Pre-fetching (IMAP4, NNTP)
-
-You can make reservations for pre-fetching messages in IMAP or NNTP
-folders.  Reserved messages are marked with @samp{!} but not cached
-yet.  When Wanderlust becomes on-line, they are pre-fetched from
-servers.
-
-If the variable @code{elmo-enable-disconnected-operation} is @code{nil},
-these off-line operations for IMAP4 and NNTP do not take place, and
-off-line re-file, copy or suchlike simply results in error.
-
-Because off-line operations use cache files, it is a bad idea to erase
-them by hand; it may cause Wanderlust to malfunction.
+@subsection Pre-fetching
 
-If you want to remove caches, be sure to execute @kbd{M-x
-elmo-cache-expire-by-size}.  @code{elmo-cache-expire-by-size} does not
-remove caches for messages relevant to off-line operations.
+You can make reservations for pre-fetching messages in networking
+folders (IMAP, NNTP, POP3, shimbun).  Reserved messages are marked with
+@samp{u} but not cached yet.  When Wanderlust becomes on-line, they are
+pre-fetched from servers.
 
 
 @node Plugged Mode, Off-line State settings, Enable Operations, Disconnected Operations
@@ -5597,8 +5749,8 @@ manually, press @kbd{F} in the folder mode.
 
 @item elmo-enable-disconnected-operation
 @vindex elmo-enable-disconnected-operation
-The initial setting is @code{t}.  Controls off-line operations
-regarding IMAP4.  If non-nil, off-line operations are carried out.
+The initial setting is @code{t}.  Controls off-line operations regarding
+networking folders.  If non-nil, off-line operations are carried out.
 
 @item elmo-lost+found-folder
 @vindex elmo-lost+found-folder
@@ -5963,10 +6115,9 @@ The initial setting is the list below.
 
 @lisp
 @group
-(list wl-summary-important-mark
+(list wl-summary-flag-mark
       wl-summary-new-uncached-mark
       wl-summary-new-cached-mark
-      wl-summary-unread-mark
       wl-summary-unread-uncached-mark
       wl-summary-unread-cached-mark)
 @end group
@@ -7007,6 +7158,7 @@ Put spam mark (@samp{s}) on current message.
 @kindex k c (Summary)
 @findex wl-summary-test-spam
 Test current message and put spam mark if judged as spam.
+Remove spam mark if judged as non-spam.
 
 @item k C
 @kindex k C (Summary)
@@ -7035,6 +7187,52 @@ Register current message as non-spam.
 @findex wl-summary-register-as-good-all
 Register all messages in the folder as non-spam.
 
+@item r k m
+@kindex r k m (Summary)
+@findex wl-summary-spam-region
+Put spam mark on messages in the specified region.
+
+@item r k c
+@kindex r k c (Summary)
+@findex wl-summary-test-spam-region
+Test messages in the specified region and put spam mark if judged as spam.
+Remove spam mark if judged as non-spam.
+
+@item r k s
+@kindex r k s (Summary)
+@findex wl-summary-register-as-spam-region
+Register messages in the specified region as spam.
+
+@item r k n
+@kindex r k n (Summary)
+@findex wl-summary-register-as-good-region
+Register messages in the specified region as non-spam.
+
+@item t k m
+@kindex t k m (Summary)
+@findex wl-thread-spam
+Put spam mark on messages which are the descendant of the current thread.
+With prefix argument, it affects on the all messages in the thread tree.
+
+@item t k c
+@kindex t k c (Summary)
+@findex wl-thread-test-spam
+Test messages which are the descendant of the current thread and put spam mark
+if judged as spam.  Remove spam mark if judged as non-spam.
+With prefix argument, it affects on the all messages in the thread tree.
+
+@item t k s
+@kindex t k s (Summary)
+@findex wl-thread-register-as-spam
+Register messages which are the descendant of the current thread as spam.
+With prefix argument, it affects on the all messages in the thread tree.
+
+@item t k n
+@kindex t k n (Summary)
+@findex wl-thread-register-as-good
+Register messages which are the descendant of the current thread as non-spam.
+With prefix argument, it affects on the all messages in the thread tree.
+
 @item m k
 @kindex m k (Summary)
 @findex wl-summary-target-mark-spam
@@ -7266,7 +7464,7 @@ Specify options to give to the shell executing @command{bsfilter}.
 
 @item elmo-spam-bsfilter-update-switch
 @vindex elmo-spam-bsfilter-update-switch
-The initial setting is @code{"--synchronous-auto-update"}.
+The initial setting is @code{"--auto-update"}.
 Specify options to give to @command{bsfilter} for learning messages.
 
 @end table
@@ -7373,7 +7571,7 @@ when you change the @code{spam_header} parameter in the config file.
 
 @end table
 
-@node Regular Expressions Header Matching,  , SpamAssassin, Spam Filter Processors
+@node Regular Expressions Header Matching,  , SpamOracle, Spam Filter Processors
 @subsection Regular Expressions Header Matching
 @cindex Regular Expressions Header Matching
 
@@ -8659,11 +8857,13 @@ The initial setting is @code{t}.
 If non-nil, you are asked for confirmation if accumulated off-line
 operations are executed.
 
-@item elmo-display-progress-threshold
-@vindex elmo-display-progress-threshold
-The initial setting is 20.
-Threshold for display of progress gauge.  If number of renewal is more than
-this value, display progress gauge.
+@item elmo-network-session-idle-timeout
+@vindex elmo-network-session-idle-timeout
+The initial setting is @code{nil}.
+Idle timeout of the network cache. Specified in seconds.
+If elapsed time since last access is larger than this value,
+cached session is not reused. If nil, network cache is reused.
+
 @end table
 
 
@@ -8700,20 +8900,22 @@ But by writing following line, you may use the old format of the msgdb as it was
 @end group
 @end lisp
 
-With the default setup,
-the old msgdb format will be used as it was. 
-You may convert the format 
-by writing following lines in @file{~/.wl} or so.
+With the default setup, the old msgdb format is converted to the new
+format automatically.  You may change this behavior by writing following
+lines in @file{~/.wl}.
 
 @lisp
 @group
 ;; @r{If the format of msgdb is different from} @code{elmo-msgdb-default-type},
 ;; @r{the format will be converted automatically when}
-;; @r{the msgdb is being loaded.}
+;; @r{the msgdb is being loaded (default).}
 (setq elmo-msgdb-convert-type 'auto)
 
 ;; @r{Convert msgdb when hitting @kbd{s all} in Summary mode}
 (setq elmo-msgdb-convert-type 'sync)
+
+;; @r{Inhibit conversion}
+(setq elmo-msgdb-convert-type nil)
 @end group
 @end lisp
 
@@ -8722,7 +8924,10 @@ But you will have following limitations.
 
 @enumerate
 @item
-You may only use @samp{important} flag. The other flags may not be available.
+You cannot use forwarded mark (@samp{F}, @samp{f}).
+@item
+You may only use @samp{important} flag. The other global flags may not
+be available.
 @end enumerate
 
 @subsection Changes from @samp{'mark} folder to  @samp{'flag}.
@@ -8905,6 +9110,7 @@ Read messages posted to @t{<wl-en@@lists.airs.net>}
       2/09    'file' folder is added.
       9/12    forwarded mark.
               Default value of the mark strings are changed.
+     12/24    Released 2.12.0 stable.
 @end example
 
 See @file{ChangeLog} for details.
@@ -8934,8 +9140,7 @@ Each versions has code names (they are almost jokes).
 Currently they are picked up alphabetically from the top 40 hits of
 U.S. Billboard magazines in 1980s.
 
-(@uref{http://lyrics.natalnet.com.br/html/top40/index.html})
-
+(@uref{http://ntl.matrix.com.br/pfilho/html/top40/})
 
 @node Index,  , Addition, Top
 @unnumbered Index