[Emacs-diffs] /srv/bzr/emacs/trunk r106497: * rmail.texi (Rmail Output): Mention rmail-automatic-folder-directives.

[Glenn Morris]

------------------------------------------------------------
revno: 106497
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Wed 2011-11-23 19:12:46 -0500
message:
  * rmail.texi (Rmail Output): Mention rmail-automatic-folder-directives.
modified:
  doc/emacs/ChangeLog
  doc/emacs/rmail.texi

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2011-11-21 06:16:49 +0000
+++ b/doc/emacs/ChangeLog       2011-11-24 00:12:46 +0000
@@ -1,3 +1,8 @@
+2011-11-24  Glenn Morris  <address@hidden>
+
+       * rmail.texi (Rmail Output):
+       Mention rmail-automatic-folder-directives.  (Bug#9657)
+
 2011-11-21  Chong Yidong  <address@hidden>
 
        * mark.texi (Global Mark Ring): Fix description of global mark

=== modified file 'doc/emacs/rmail.texi'
--- a/doc/emacs/rmail.texi      2011-10-24 02:01:54 +0000
+++ b/doc/emacs/rmail.texi      2011-11-24 00:12:46 +0000
@@ -571,6 +571,22 @@
 that returns a file name as a string.  @code{rmail-output-file-alist}
 applies to both @kbd{o} and @kbd{C-o}.
 
address@hidden 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
address@hidden, 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)