Score Commands

Score File Specification

wl-score-folder-alist specifies score files or variables in which scores are defined, corresponding to folder names.

(setq wl-score-folder-alist
      '(("^-.*"
         "news.SCORE"
         "my.SCORE")
        (".*"
         "all.SCORE")))

If paths to the score files are omitted, the directory specified in the variable wl-score-files-directory is assumed.

No matter what you write in wl-score-folder-alist, the default score file wl-score-default-file (`all.SCORE') is always read (it does not have to exist). Therefore, in the example above, the three score files, `news.SCORE', `my.SCORE', and `all.SCORE' are read for the folders that matches `^-.*'.

Scored Messages

Scores are attached to the messages that are specified by wl-summary-score-marks temporarily when the summary is updated; when you exit from the summary, the scores are removed and reverts to the defaults.

Creation of Score Files

In the summary buffer, move to an appropriate message and type L. Then type s, s, and p at a prompt in a mini-buffer. The string in Subject is presented. Edit it and press RET.

This makes -1000 are scored for messages with the same `Subject:' as the string you entered. That is, such a score file is created automatically.

Then, try typing h and e in the same summary buffer. The score file you just made appears. This buffer is called score editing buffer thereafter. When you type C-c C-e in it, you are prompted in the mini-buffer as you are previously; type a. Then a score entry for "From" should be inserted. In this way, you can create a score file easily either in the summary buffer or in the score editing buffer.

By the way, you might be aware the numbers of key strokes are different between s s p and a. This is determined by wl-score-header-default-entry. This variable specifies the default score entries corresponding to header fields. For example, for "subject" field, a type and a time limit are prompted, but for "from" field, they are fixed upon automatically as substring and permanent respectively. However, score values can be modified by the prefix argument. Typing ? at the mini-buffer shows a help on keys and corresponding headers and types.

At last, type C-c C-c in the score editing buffer. This saves the score file and terminates the edit mode. Typing C-c C-c after erasing contents of the buffer deletes the score file being edited.

Tips

Selecting Score Files

You can change score files to which scores are appended by wl-summary-increase-score and wl-summary-lower-score by wl-score-change-score-file.

Summing Up the Score

If you add the same entries by wl-summary-increase-score, wl-summary-lower-score, and wl-score-edit-insert-entry, scores for the entry is summed up.

For example, if you create `from' entry with the score of -1000 by L a and again `from' with -200, one entry with the score of -1200 will be created as a result.

Creating Thread Key

Creating `Thread' key by wl-summary-increase-score or wl-summary-lower-score appends `Message-ID' of all children.

Creating Followup Key

Creating `Followup' key by wl-summary-increase-score or wl-summary-lower-score appends `Message-ID' of the message at the cursor to `References' key. If wl-score-auto-make-followup-entry is non-nil, `Message-ID' of all messages to be followed up within dates specified by wl-score-expiry-days.

Key Bindings

K

Increases the score for the current message. And the score entry is appended to the score file at the same moment. You can specify the score value by a prefix argument.

L

Decreases the score for the current message. And the score entry is appended to the score file at the same moment. You can specify the score value by a prefix argument.

h R

Re-applies the scoring. However, already scored messages are not scored anew.

h c

Changes the score file currently selected.

h e

Edits the score file currently selected. If there are multiple score files, the previously specified one is selected.

h f

Edits an arbitrary score file and selects it.

h F

Erases caches associated to the score files that are read. If you modified score files directly (from other than Wanderlust), you need to re-read them after erasing the cache.

h m

Specifies the criterion for scores to be marked as read. Messages with scores less than this value are marked as read.

h x

Specifies the criterion for scores to be deleted from the summary. Messages with scores less than this value are deleted. "Deleted" means it is not shown; they are not removed from the summary information or the folder. The deleted messages can be shown by rescan-noscore again.

Key Bindings in the Score Editing Buffer

C-c C-k

Abandons the file being edited.

C-c C-c

Saves the file being edited, and quits from the edit mode.

C-c C-p

Re-draws the score.

C-c C-d

Inserts the number of dates from Dec. 31, 1 B.C. It is used for creating the third factor of time-limited scores.

C-c C-s

Inserts the header of the message selected in the summary buffer.

C-c C-e

Inserts the score entry of the message selected in the summary buffer.

Customizable Variables

wl-summary-default-score

The initial setting is 0 (zero). This variable specifies the default value of the score. The score is increased or decreased based upon this value.

wl-summary-important-above

The initial setting is nil. Messages with scores larger than this value are attached with the important mark (`$'). If nil, no important marks are attached.

wl-summary-target-above

The initial setting is nil. Messages with scores larger than this value are attached with the target mark (`*'). If nil, no target marks are attached.

wl-summary-mark-below

The initial setting is 0 (zero). Messages with scores smaller than this value are marked as read.

wl-summary-expunge-below

The initial setting is nil. Messages with scores smaller than this value are deleted from the summary. If nil, they are not deleted.

wl-summary-score-marks

The initial setting is the list shown below:

(list wl-summary-new-mark)

Messages with these marks are scored.

wl-use-scoring

The initial setting is t. If non-nil, scoring is enabled.

wl-score-files-directory

The initial setting is `~/.elmo/'. The default directory for score files.

wl-score-interactive-default-score

The initial setting is 1000. This value is used as a score when a score factor is nil in the score file. It is also used in wl-summary-increase-score and wl-summary-lower-score, on condition that the value of wl-score-header-default-entry is nil.

wl-score-expiry-days

The initial setting is 7. This is the number of days before time-limited scores are deleted.

wl-score-update-entry-dates

The initial setting is t. If non-nil, it enables deletion of time-limited scores.

wl-score-header-default-entry

Specifies the default value for each header field for score entries created by wl-summary-increase-score, wl-summary-lower-score, and wl-score-edit-insert-entry.

wl-score-simplify-fuzzy-regexp

In the case of a type of a score entry is fuzzy, this specifies a regular expression to be deleted from the string. Because this is usually used for Subject, the default is prefixes that are attached by mailing list programs.

wl-summary-rescore-partial-threshold

The initial setting is 200. When sync-all or rescan is executed, if there are messages more than this value, only the last same number of messages as this value are scored.

wl-summary-auto-sync-marks

If non-nil, unread/important marks are synchronized when the summary does. Unread marks reflect information on the IMAP4 server. Important marks reflect information on the IMAP4 server (flagged or not), and contents of `'mark' folder. The initial setting is t.

Go to the first, previous, next, last section, table of contents.