From fd63f439e0dfb1c6453884210ae87c50ea51ac4e Mon Sep 17 00:00:00 2001 From: teranisi Date: Wed, 12 Apr 2000 00:24:20 +0000 Subject: [PATCH] Added description about auto-refile. --- NEWS | 2 ++ NEWS.ja | 2 ++ doc/wl-ja.texi | 61 ++++++++++++++++++++++++++++++++++++++---------- doc/wl.texi | 70 +++++++++++++++++++++++++++++++++++++------------------- 4 files changed, 99 insertions(+), 36 deletions(-) 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$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$rr7o$,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]$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 $B2eJ}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. -- 1.7.10.4