Added description about auto-refile.
authorteranisi <teranisi>
Wed, 12 Apr 2000 00:24:20 +0000 (00:24 +0000)
committerteranisi <teranisi>
Wed, 12 Apr 2000 00:24:20 +0000 (00:24 +0000)
NEWS
NEWS.ja
doc/wl-ja.texi
doc/wl.texi

diff --git a/NEWS b/NEWS
index 2a741bd..5f56d96 100644 (file)
--- 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 (file)
--- a/NEWS.ja
+++ b/NEWS.ja
@@ -10,6 +10,8 @@ Wanderlust NEWS (\e$BF|K\8lHG\e(B) -- User-visible changes in Wanderlust. 21 Mar 2
 
 *** wl-* \e$B$N%U%!%$%k$O\e(B 'wl' \e$B%G%#%l%/%H%j$K0\F0$7$^$7$?!#\e(B
 
+** wl-refile-rule-alist \e$B$N5-=RJ}K!$,3HD%$5$l$^$7$?\e(B(\e$B0JA0$H8_49@-$,$"$j$^$9\e(B)\e$B!#\e(B
+
 * 1.0.3 \e$B$+$i\e(B version 1.1.0 \e$B$X$NJQ99E@\e(B 
 
 ** \e$B%$%s%9%H!<%k\e(B
index b1e56ac..33d6768 100644 (file)
@@ -5,7 +5,7 @@
 @c @documentlanguage ja
 @c %**end of header
 @c Wanderlust \e$B$N\e(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 \e$B$N%a%C%;!<%8$@$1$,@hFI$_$5$l$^$9!#\e(B
 @end table
 
 @subsection \e$B<+F0%j%U%!%$%k\e(B
+@vindex elmo-msgdb-extra-fields
+@vindex wl-refile-rule-alist
+@findex wl-summary-auto-refile
 
 \e$B%a%C%;!<%8$N%X%C%@>pJs$+$iG$0U$N%U%)%k%@$X?6$jJ,$1$k<+F0%j%U%!%$%k5!G=$,\e(B
 @kbd{C-o} (@code{wl-summary-auto-refile}) \e$B$G;HMQ$G$-$^$9!#<+F0%j%U%!%$%k$O\e(B 
@@ -2267,10 +2270,10 @@ msgdb \e$B$N\e(B overview \e$B>pJs$r85$K?6$jJ,$1$7$^$9!#\e(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 \e$B$N\e(B overview \e$B>pJs$r85$K?6$jJ,$1$7$^$9!#\e(B
 \e$B$,$"$j$^$9!#\e(B
 
 \e$B<!$K?6$jJ,$1$9$k%k!<%k$r@_Dj$7$^$9!#\e(B
+\e$B<+F0?6$jJ,$1$O!$JQ?t\e(B @code{wl-refile-rule-alist} \e$B$NCM$K4p$E$$$F9T$o$l$^$9!#\e(B
+@code{wl-refile-rule-alist} \e$B$O!"\e(B
+
+@example
+        (\e$B%U%#!<%k%I\e(B (\e$B@55,I=8=\e(B . \e$B?6$jJ,$1@h\e(B)
+                    (\e$B@55,I=8=\e(B . \e$B?6$jJ,$1@h\e(B)
+                    @dots{})
+@end example
+
+\e$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$,\e(B
+\e$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\e(B
+\e$B$^$9!#A0J}$K;XDj$5$l$?%k!<%k$,M%@h$5$l$^$9!#\e(B
+
+\e$B!X%U%#!<%k%I!YItJ,$K$O!"%U%#!<%k%IL>$NJ8;zNs$r;XDj$7$^$9!#$^$?!"%U%#!<%k\e(B
+\e$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$+\e(B
+\e$B$N%U%#!<%k%I$NCM$,%^%C%A$7$?$H$-$KH/2P$7$^$9\e(B(OR \e$B>r7o$H$J$j$^$9\e(B)\e$B!#\e(B
+
+\e$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!#\e(B
+\e$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\e(B
+\e$B@h!YItJ,$K$O!":F$S%k!<%k$r=q$/$3$H$b$G$-!"$=$N>l9g!"$=$N%k!<%k$N%U%#!<%k\e(B
+\e$B%I$NCM$N>r7o$H8=:_$N%k!<%k$N%U%#!<%k%I$NCM$N>r7o$,K~$?$5$l$?$H$-$KH/2P$7\e(B
+\e$B$^$9\e(B(AND \e$B>r7o$H$J$j$^$9\e(B)\e$B!#\e(B
+
+\e$B$^$?!"!X@55,I=8=!Y$G%^%C%A$7$?ItJ,J8;zNs$O!"!X?6$jJ,$1@h!Y$K0J2<$N\e(B
+\e$B;XDj$r$9$k$3$H$G;2>H$G$-$^$9!#\e(B
+
+@example
+\&            \e$B%^%C%A$7$?J8;zNsA4BN$r;2>H$7$^$9!#\e(B
+\N (N \e$B$O?t;z\e(B) N \e$BHVL\$N\e(B `\(...\)' \e$B$K%^%C%A$7$?J8;zNs$r;2>H$7$^$9!#\e(B
+@end example
+
+\e$B0J2<$O\e(B @code{wl-refile-rule-alist} \e$B$N0lNc$G$9!#\e(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
 
-\e$B$3$N$h$&$J@_Dj$r$7\e(B @kbd{C-o} (@code{wl-summary-auto-refile}) \e$B$G>r7o$K\e(B
-\e$B%^%C%A$7$?%a%C%;!<%8$K%j%U%!%$%k%^!<%/$,IU2C$5$l$^$9!#\e(B@kbd{x} \e$B$G%j%U%!%$\e(B
-\e$B%k$r<B9T$7$^$9!#%k!<%k$NA0J}$K$"$k?6$jJ,$1>r7o$,M%@h$5$l$^$9!#\e(B
+@kbd{C-o} (@code{wl-summary-auto-refile}) \e$B$G>r7o$K%^%C%A$7$?%a%C%;!<%8$K\e(B
+\e$B%j%U%!%$%k%^!<%/$,IU2C$5$l$^$9!#\e(B@kbd{x} \e$B$G%j%U%!%$%k$r<B9T$7$^$9!#\e(B
 
 @code{wl-summary-auto-refile-skip-marks} \e$B$r@_Dj$9$k$3$H$K$h$j!"\e(B
 \e$B<+F0%j%U%!%$%k$NBP>]$H$9$k%a%C%;!<%8$rJQ99$9$k$3$H$,$G$-$^$9!#\e(B
@@ -2308,7 +2344,6 @@ msgdb \e$B$N\e(B overview \e$B>pJs$r85$K?6$jJ,$1$7$^$9!#\e(B
 @noindent
 \e$B$NMM$K\e(B @code{wl-summary-auto-refile-skip-marks} \e$B$r\e(B nil \e$B$K$7$^$9!#\e(B
 
-
 @subsection \e$B%9%F%#%C%-!<%5%^%j\e(B
 @cindex Summary, Sticky
 @cindex Sticky Summary
@@ -2487,12 +2522,14 @@ prefix argument \e$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
 \e$B2<J}8~$K$"$kL$FI$b$7$/$O\e(B @samp{$}\e$B%^!<%/$D$-$N%a%C%;!<%8$X0\F0$7$^$9!#\e(B
+\e$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!#\e(B
 (@code{wl-summary-down})
 
 @item P
 @kindex P (Summary)
 @findex wl-summary-up
 \e$B>eJ}8~$K$"$kL$FI$b$7$/$O\e(B @samp{$}\e$B%^!<%/$D$-$N%a%C%;!<%8$X0\F0$7$^$9!#\e(B
+\e$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!#\e(B
 (@code{wl-summary-up})
 
 @item w
index 0a6324d..d4a9559 100644 (file)
@@ -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.