From 01d06b1fc449b3b6d7637576d634ad8704bb8433 Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Wed, 23 Nov 2011 19:12:46 -0500 Subject: [PATCH] * rmail.texi (Rmail Output): Mention rmail-automatic-folder-directives. --- doc/emacs/ChangeLog | 5 +++++ doc/emacs/rmail.texi | 16 ++++++++++++++++ 2 files changed, 21 insertions(+) diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 6e687bcefc9..e27c778679c 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,8 @@ +2011-11-24 Glenn Morris + + * rmail.texi (Rmail Output): + Mention rmail-automatic-folder-directives. (Bug#9657) + 2011-11-21 Chong Yidong * mark.texi (Global Mark Ring): Fix description of global mark diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 71c23655608..0df4a3a7bb5 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi @@ -571,6 +571,22 @@ the file name to use, or more generally it may be any Lisp expression that returns a file name as a string. @code{rmail-output-file-alist} applies to both @kbd{o} and @kbd{C-o}. +@vindex rmail-automatic-folder-directives +Rmail can automatically save messages from your primary Rmail file +(the one that @code{rmail-file-name} specifies) to other files, based +on the value of the variable @code{rmail-automatic-folder-directives}. +This variable is a list of elements (@samp{directives}) that say which +messages to save where. Each directive is a list consisting of an +output file, followed by one or more pairs of a header name and a regular +expression. If a message has a header matching the specified regular +expression, that message is saved to the given file. If the directive +has more than one header entry, all must match. Rmail checks directives +when it shows a message from the file @code{rmail-file-name}, and +applies the first that matches (if any). If the output file is +@code{nil}, the message is deleted, not saved. For example, you can use +this feature to save messages from a particular address, or with a +particular subject, to a dedicated file. + @node Rmail Labels @section Labels @cindex label (Rmail) -- 2.11.4.GIT