Update.
[elisp/wanderlust.git] / doc / wl.texi
index 47f592b..1438e2d 100644 (file)
@@ -673,7 +673,7 @@ supported by ELMO.
 
 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, File, Access and Internal folder
+Shimbun, Search, Multi, Filter, Pipe, File, Access and Internal folder
 types.
 
 @menu
@@ -685,7 +685,7 @@ 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
@@ -1280,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
@@ -1332,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:
 
@@ -1368,7 +1394,7 @@ Example:
 @end group
 @end example
 
-@subsection TIPS
+@c @subsection TIPS
 
 @subsubsection Enter space to separate keywords
 
@@ -1381,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
@@ -1398,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
@@ -1420,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
@@ -3064,7 +3115,7 @@ are displayed in the following list.
 %#  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 empty
+%~  ` ' only if previous column is not empty
 @end group
 @end example
 
@@ -5326,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
@@ -7108,11 +7159,6 @@ Put spam mark (@samp{s}) on current message.
 @findex wl-summary-test-spam
 Test current message and put spam mark if judged as spam.
 
-@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.
-
 @item k C
 @kindex k C (Summary)
 @findex wl-summary-mark-spam
@@ -7140,6 +7186,29 @@ 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.
+
+@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.  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
@@ -8764,12 +8833,6 @@ 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}.