From: Alex Schroeder <alex@gnu.org>
Date: Fri, 20 Jan 2006 21:30:50 +0000 (+0000)
Subject: (rmail-inbox-alist): Doc.
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=458fb8b26beed40c22488cb3f837c96c4bc80c4c;p=emacs.git

(rmail-inbox-alist): Doc.
---

diff --git a/lisp/mail/ChangeLog b/lisp/mail/ChangeLog
index 442775761e7..ea071ac7d0a 100644
--- a/lisp/mail/ChangeLog
+++ b/lisp/mail/ChangeLog
@@ -1,3 +1,7 @@
+2006-01-20  Alex Schroeder  <alex@gnu.org>
+
+	* rmail.el (rmail-inbox-alist): Doc.
+
 2006-01-20  Henrik Enberg  <enberg@printf.se>
 
 	* rmailsum.el (rmail-summary-get-sender): New function.
diff --git a/lisp/mail/rmail.el b/lisp/mail/rmail.el
index b1d5cee830e..98865e43621 100644
--- a/lisp/mail/rmail.el
+++ b/lisp/mail/rmail.el
@@ -358,8 +358,14 @@ and the value of the environment variable MAIL overrides it)."
 ;;;###autoload
 (defcustom rmail-inbox-alist nil
   "*Alist of mail files and backup directory names.
-Each element looks like (MAIL-FILE . INBOX-LIST).  Mail files with
-names matching MAIL-FILE will retrieve mail from files in INBOX-LIST."
+Each element has the form (MAIL-FILE INBOX ...).  When running
+rmail on MAIL-FILE, mails in all the INBOX files listed will be
+moved to the MAIL-FILE.  Be sure to fully qualify your MAIL-FILE.
+
+Example setting if procmail delivers all your spam to
+~/Mail/SPAM.in and you read it from the file ~/Mail/SPAM:
+
+\(setq rmail-inbox-alist '((\"~/Mail/SPAM\" \"~/Mail/SPAM.in\")))"
   :type '(alist :key-type file :value-type (repeat file))
   :group 'rmail-retrieve
   :group 'rmail-files)