From: teranisi <teranisi>
Date: Wed, 12 Apr 2000 00:24:20 +0000 (+0000)
Subject: Added description about auto-refile.
X-Git-Tag: wl-1_1_1~54
X-Git-Url: http://git.chise.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fd63f439e0dfb1c6453884210ae87c50ea51ac4e;p=elisp%2Fwanderlust.git

Added description about auto-refile.
---

diff --git a/NEWS b/NEWS
index 2a741bd..5f56d96 100644
--- a/NEWS
+++ b/NEWS
@@ -13,6 +13,8 @@ Wanderlust NEWS -- User-visible changes in Wanderlust. 21 Mar 2000
 
 *** All wl-* files are moved to the directory 'wl'.
 
+** Syntax of wl-refile-rule-alist is extended (compatible with older one).
+
 * Changes in version 1.1.0 from 1.0.3.
 
 ** Install
diff --git a/NEWS.ja b/NEWS.ja
index 4a665c0..b98a52c 100644
--- a/NEWS.ja
+++ b/NEWS.ja
@@ -10,6 +10,8 @@ Wanderlust NEWS ($BF|K\8lHG(B) -- User-visible changes in Wanderlust. 21 Mar 2
 
 *** wl-* $B$N%U%!%$%k$O(B 'wl' $B%G%#%l%/%H%j$K0\F0$7$^$7$?!#(B
 
+** wl-refile-rule-alist $B$N5-=RJ}K!$,3HD%$5$l$^$7$?(B($B0JA0$H8_49@-$,$"$j$^$9(B)$B!#(B
+
 * 1.0.3 $B$+$i(B version 1.1.0 $B$X$NJQ99E@(B 
 
 ** $B%$%s%9%H!<%k(B
diff --git a/doc/wl-ja.texi b/doc/wl-ja.texi
index b1e56ac..33d6768 100644
--- a/doc/wl-ja.texi
+++ b/doc/wl-ja.texi
@@ -5,7 +5,7 @@
 @c @documentlanguage ja
 @c %**end of header
 @c Wanderlust $B$N(B texinfo
-@set Time-stamp: <2000-04-10 09:51:22 teranisi>
+@set Time-stamp: <00/04/12 00:01:23 teranisi>
 @set version 1.1.1
 @synindex pg cp
 @finalout
@@ -2257,6 +2257,9 @@ imap4 $B$N%a%C%;!<%8$@$1$,@hFI$_$5$l$^$9!#(B
 @end table
 
 @subsection $B<+F0%j%U%!%$%k(B
+@vindex elmo-msgdb-extra-fields
+@vindex wl-refile-rule-alist
+@findex wl-summary-auto-refile
 
 $B%a%C%;!<%8$N%X%C%@>pJs$+$iG$0U$N%U%)%k%@$X?6$jJ,$1$k<+F0%j%U%!%$%k5!G=$,(B
 @kbd{C-o} (@code{wl-summary-auto-refile}) $B$G;HMQ$G$-$^$9!#<+F0%j%U%!%$%k$O(B 
@@ -2267,10 +2270,10 @@ msgdb $B$N(B overview $B>pJs$r85$K?6$jJ,$1$7$^$9!#(B
 @lisp
 (setq elmo-msgdb-extra-fields
       '("x-ml-name"
-      "reply-to"
-      "sender"
-      "mailing-list"
-      "newsgroups"))
+        "reply-to"
+        "sender"
+        "mailing-list"
+        "newsgroups"))
 @end lisp
 
 @noindent
@@ -2279,20 +2282,53 @@ msgdb $B$N(B overview $B>pJs$r85$K?6$jJ,$1$7$^$9!#(B
 $B$,$"$j$^$9!#(B
 
 $B<!$K?6$jJ,$1$9$k%k!<%k$r@_Dj$7$^$9!#(B
+$B<+F0?6$jJ,$1$O!$JQ?t(B @code{wl-refile-rule-alist} $B$NCM$K4p$E$$$F9T$o$l$^$9!#(B
+@code{wl-refile-rule-alist} $B$O!"(B
+
+@example
+        ($B%U%#!<%k%I(B ($B@55,I=8=(B . $B?6$jJ,$1@h(B)
+                    ($B@55,I=8=(B . $B?6$jJ,$1@h(B)
+                    @dots{})
+@end example
+
+$B$N$h$&$J%k!<%k$N%j%9%H$H$J$C$F$$$^$9!#3F%k!<%k$O!"!X%U%#!<%k%I!Y$NCM$,(B
+$B!X@55,I=8=!Y$K%^%C%A$9$k$H$-$K!X?6$jJ,$1@h!Y$K?6$jJ,$1$k$H$$$&0UL#$r;}$A(B
+$B$^$9!#A0J}$K;XDj$5$l$?%k!<%k$,M%@h$5$l$^$9!#(B
+
+$B!X%U%#!<%k%I!YItJ,$K$O!"%U%#!<%k%IL>$NJ8;zNs$r;XDj$7$^$9!#$^$?!"%U%#!<%k(B
+$B%IL>$NJ8;zNs$N%j%9%H$r;XDj$9$k$3$H$b$G$-$^$9!#$3$N>l9g!"%j%9%H$N$$$:$l$+(B
+$B$N%U%#!<%k%I$NCM$,%^%C%A$7$?$H$-$KH/2P$7$^$9(B(OR $B>r7o$H$J$j$^$9(B)$B!#(B
+
+$B!X@55,I=8=!Y$K$O%U%#!<%k%I$NCM$K%^%C%A$5$;$k@55,I=8=J8;zNs$r;XDj$7$^$9!#(B
+$B!X?6$jJ,$1@h!Y$K$O?6$jJ,$1@h$N%U%)%k%@L>$NJ8;zNs$r;XDj$7$^$9!#!X?6$jJ,$1(B
+$B@h!YItJ,$K$O!":F$S%k!<%k$r=q$/$3$H$b$G$-!"$=$N>l9g!"$=$N%k!<%k$N%U%#!<%k(B
+$B%I$NCM$N>r7o$H8=:_$N%k!<%k$N%U%#!<%k%I$NCM$N>r7o$,K~$?$5$l$?$H$-$KH/2P$7(B
+$B$^$9(B(AND $B>r7o$H$J$j$^$9(B)$B!#(B
+
+$B$^$?!"!X@55,I=8=!Y$G%^%C%A$7$?ItJ,J8;zNs$O!"!X?6$jJ,$1@h!Y$K0J2<$N(B
+$B;XDj$r$9$k$3$H$G;2>H$G$-$^$9!#(B
+
+@example
+\&            $B%^%C%A$7$?J8;zNsA4BN$r;2>H$7$^$9!#(B
+\N (N $B$O?t;z(B) N $BHVL\$N(B `\(...\)' $B$K%^%C%A$7$?J8;zNs$r;2>H$7$^$9!#(B
+@end example
+
+$B0J2<$O(B @code{wl-refile-rule-alist} $B$N0lNc$G$9!#(B
 
 @lisp
 (setq wl-refile-rule-alist
-      '(
-        ("x-ml-name"
+      '(("x-ml-name"
          ("^Wanderlust" . "+wl")
          ("^Elisp" . "+elisp"))
+        (("To" "Cc")
+         ("\\([a-z]+\\)@@gohome.org" . "+\\1"))
         ("From"
-         ("teranisi@@isl.ntt.co.jp" . "+teranisi"))))
+         ("me@@gohome.org" . ("To" ("you@@gohome.org" . 
+                                    "+from-me-to-you"))))))
 @end lisp
 
-$B$3$N$h$&$J@_Dj$r$7(B @kbd{C-o} (@code{wl-summary-auto-refile}) $B$G>r7o$K(B
-$B%^%C%A$7$?%a%C%;!<%8$K%j%U%!%$%k%^!<%/$,IU2C$5$l$^$9!#(B@kbd{x} $B$G%j%U%!%$(B
-$B%k$r<B9T$7$^$9!#%k!<%k$NA0J}$K$"$k?6$jJ,$1>r7o$,M%@h$5$l$^$9!#(B
+@kbd{C-o} (@code{wl-summary-auto-refile}) $B$G>r7o$K%^%C%A$7$?%a%C%;!<%8$K(B
+$B%j%U%!%$%k%^!<%/$,IU2C$5$l$^$9!#(B@kbd{x} $B$G%j%U%!%$%k$r<B9T$7$^$9!#(B
 
 @code{wl-summary-auto-refile-skip-marks} $B$r@_Dj$9$k$3$H$K$h$j!"(B
 $B<+F0%j%U%!%$%k$NBP>]$H$9$k%a%C%;!<%8$rJQ99$9$k$3$H$,$G$-$^$9!#(B
@@ -2308,7 +2344,6 @@ msgdb $B$N(B overview $B>pJs$r85$K?6$jJ,$1$7$^$9!#(B
 @noindent
 $B$NMM$K(B @code{wl-summary-auto-refile-skip-marks} $B$r(B nil $B$K$7$^$9!#(B
 
-
 @subsection $B%9%F%#%C%-!<%5%^%j(B
 @cindex Summary, Sticky
 @cindex Sticky Summary
@@ -2487,12 +2522,14 @@ prefix argument $B$D$-$J$i$P%-%c%C%7%e$,B8:_$7$F$bL5;k$7$F:FFI$_9~$_$7D>$7$^$9!
 @kindex N (Summary)
 @findex wl-summary-down
 $B2<J}8~$K$"$kL$FI$b$7$/$O(B @samp{$}$B%^!<%/$D$-$N%a%C%;!<%8$X0\F0$7$^$9!#(B
+$B%*%U%i%$%s%b!<%I$N$H$-$K$O!"%-%c%C%7%e$5$l$F$$$J$$%a%C%;!<%8$K0\F0$7$^$;$s!#(B
 (@code{wl-summary-down})
 
 @item P
 @kindex P (Summary)
 @findex wl-summary-up
 $B>eJ}8~$K$"$kL$FI$b$7$/$O(B @samp{$}$B%^!<%/$D$-$N%a%C%;!<%8$X0\F0$7$^$9!#(B
+$B%*%U%i%$%s%b!<%I$N$H$-$K$O!"%-%c%C%7%e$5$l$F$$$J$$%a%C%;!<%8$K0\F0$7$^$;$s!#(B
 (@code{wl-summary-up})
 
 @item w
diff --git a/doc/wl.texi b/doc/wl.texi
index 0a6324d..d4a9559 100644
--- a/doc/wl.texi
+++ b/doc/wl.texi
@@ -5,7 +5,7 @@
 @c @documentlanguage en
 @c %**end of header
 @c texinfo of Wanderlust
-@set Time-stamp: <2000-04-10 09:57:19 teranisi>
+@set Time-stamp: <00/04/12 00:04:16 teranisi>
 @set version 1.1.1
 @synindex pg cp
 @finalout
@@ -393,7 +393,6 @@ such as "elmo" then add following to @file{WL-CFG}:
 @end lisp
 
 @noindent
-
 @subsection Install as a XEmacs package
 @cindex XEmacs package
 @cindex XEmacs package install
@@ -541,7 +540,6 @@ bar@@foo.gohome.org             "Mr. Bar"    "Michael Bar"
 @end example
 
 @noindent
-
 One line defines one persons description.
 
 Actually, in default setup, "nickname" is used in summary-mode and "real name"
@@ -632,7 +630,6 @@ M-x wl
 @end example
 
 @noindent
-
 After initialization, Folder Mode which shows the list of folders will appear.
 That means the folders you defined in the @file{~/.folders} are listed
 If you start Wanderlust with prefix argument like @kbd{C-u M-x wl}, you
@@ -1013,8 +1010,6 @@ Of course, following is possible @t{:-)}
 @end lisp
 
 @noindent
-
-
 @node Archive Vars,  , Archive Tips, Archive Folder
 @subsection Variables About Archive Folder
 @cindex Archive variables
@@ -1369,7 +1364,6 @@ FOLDER-NAME:NEW-NUMBER/UNREAD-NUMBER/ALL-NUMBER
 @end example
 
 @noindent
-
 @kbd{s} key on the folder line updates these numbers.
 It changes its color if it has many new messages.
 
@@ -2172,7 +2166,6 @@ For example, the following line indicates one thread (a context of a topic).
 @end example
 
 @noindent
-
 If you type @kbd{/} on this line, the thread is opened and it changes
 the appearance like following.
 
@@ -2201,7 +2194,6 @@ M-x elmo-cache-expire-by-size
 @end example
 
 @noindent
-
 The command deletes cache files to the specified size by the order of
 last accessed time.
 
@@ -2240,8 +2232,11 @@ A list of regexp of folders to enable message prefetching.
 @end table
 
 @subsection Auto Refile
+@vindex elmo-msgdb-extra-fields
+@vindex wl-refile-rule-alist
+@findex wl-summary-auto-refile
 
-You refile messages automatically, by typing @kbd{C-o}
+You can refile messages automatically, by typing @kbd{C-o}
 (@code{wl-summary-auto-refile}). It decides destination of refile by
 the content of the message header information (information in the msgdb).
 
@@ -2252,34 +2247,63 @@ set the variable @code{elmo-msgdb-extra-fields} like following.
 @lisp
 (setq elmo-msgdb-extra-fields
       '("x-ml-name"
-      "reply-to"
-      "sender"
-      "mailing-list"
-      "newsgroups"))
+        "reply-to"
+        "sender"
+        "mailing-list"
+        "newsgroups"))
 @end lisp
 
 @noindent
-
 By this setting, Wanderlust saves extra fields in the msgdb.  You have
 to type @kbd{s all} to get extra fields for the messages that are
 already exists in the summary.
 
-Then, specify the refile rule in the @code{wl-refile-rule-alist} like
-following.
+Then, specify the refile rule.  The refile target folder of auto
+refiling is decided by the value of @code{wl-refile-rule-alist}.
+@code{wl-refile-rule-alist} is a list of a rule:
+
+@example
+        (FIELD (REGEXP . TARGET)
+               (REGEXP . TARGET)
+               @dots{})
+@end example
+
+Each rule means `if FIELD value matches REGEXP, then refile to TARGET folder'.
+The rule matched first is applied.
+
+FIELD is a string of field name.  You can specify a list of field name
+string, too. In this case, if one of these fields is matched, then the
+rule is fired (i.e. OR condition).
+
+REGEXP is a regular expression for field value.  TARGET is a target
+folder string. You can specify a rule at TARGET part, too.  In this
+case, If the field value of the rule and the current rule is matched,
+then the current rule is fired (i.e. AND condition).
+
+In TARGET part, you can refer matched substring of REGEXP.
+To refer substring, specify following in TARGET:
+
+@example
+\&            means substitute original matched text.
+\N (number)   means substitute what matched the Nth `\(...\)'.
+@end example
+
+Following is an example of @code{wl-refile-rule-alist}.
 
 @lisp
 (setq wl-refile-rule-alist
-      '(
-        ("x-ml-name"
+      '(("x-ml-name"
          ("^Wanderlust" . "+wl")
          ("^Elisp" . "+elisp"))
+        (("To" "Cc")
+         ("\\([a-z]+\\)@@gohome.org" . "+\\1"))
         ("From"
-         ("teranisi@@isl.ntt.co.jp" . "+teranisi"))))
+         ("me@@gohome.org" . ("To" ("you@@gohome.org" . 
+                                    "+from-me-to-you"))))))
 @end lisp
 
-After these setting, refile marks are automatically put on the condition
+After these settings, refile marks are automatically put on the condition
 matched messages by typing @kbd{C-o} (@code{wl-summary-auto-refile}).
-The rule matched first is applied.
 
 Messages which have @code{wl-summary-auto-refile-skip-marks} is skipped
 auto refiling. 
@@ -3477,7 +3501,6 @@ As shown in the example in @code{wl-draft-config-alist}, you can select
 @end example
 
 @noindent
-
 @subsection Sending mail by POP-before-SMTP
 @cindex POP-before-SMTP
 
@@ -4229,7 +4252,6 @@ Items in the list has the format of:
 @end example
 
 @noindent
-
 The folder is examined if it matches "regexp_for_folders" from the
 beginning of the list.  If you invoke expiration on the folder that does
 not match any of them, nothing will happen.