Delete misplaced comment.
[bpt/emacs.git] / lisp / mail / rmail.el
CommitLineData
c88ab9ce
ER
1;;; rmail.el --- main code of "RMAIL" mail reader for Emacs.
2
bd1f0f84 3;; Copyright (C) 1985, 1986, 1987, 1988, 1993 Free Software Foundation, Inc.
3a801d0c 4
e5167999 5;; Maintainer: FSF
d7b4d18f 6;; Keywords: mail
e5167999 7
581d7e0b
RM
8;; This file is part of GNU Emacs.
9
10;; GNU Emacs is free software; you can redistribute it and/or modify
11;; it under the terms of the GNU General Public License as published by
e5167999 12;; the Free Software Foundation; either version 2, or (at your option)
581d7e0b
RM
13;; any later version.
14
15;; GNU Emacs is distributed in the hope that it will be useful,
16;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18;; GNU General Public License for more details.
19
20;; You should have received a copy of the GNU General Public License
21;; along with GNU Emacs; see the file COPYING. If not, write to
22;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
23
e5167999 24;;; Code:
581d7e0b
RM
25
26;; Souped up by shane@mit-ajax based on ideas of rlk@athena.mit.edu
27;; New features include attribute and keyword support, message
28;; selection by dispatch table, summary by attributes and keywords,
29;; expunging by dispatch table, sticky options for file commands.
30
bd1f0f84
RS
31;; Extended by Bob Weiner of Motorola
32;; New features include: rmail and rmail-summary buffers remain
33;; synchronized and key bindings basically operate the same way in both
34;; buffers, summary by topic or by regular expression, rmail-reply-prefix
35;; variable, and a bury rmail buffer (wipe) command.
36;;
37
581d7e0b 38(require 'mail-utils)
bd1f0f84
RS
39
40;; For Emacs V18 compatibility
bd1f0f84
RS
41(and (not (fboundp 'buffer-disable-undo))
42 (fboundp 'buffer-flush-undo)
31e1d920 43 (defalias 'buffer-disable-undo 'buffer-flush-undo))
bd1f0f84
RS
44
45; These variables now declared in paths.el.
581d7e0b
RM
46;(defvar rmail-spool-directory "/usr/spool/mail/"
47; "This is the name of the directory used by the system mailer for\n\
48;delivering new mail. It's name should end with a slash.")
49;(defvar rmail-file-name
50; (expand-file-name "~/RMAIL")
51; "")
52
53;;;###autoload
54(defvar rmail-dont-reply-to-names nil "\
55*A regexp specifying names to prune of reply to messages.
388348ae 56A value of nil means exclude your own name only.")
581d7e0b
RM
57
58;;;###autoload
59(defvar rmail-default-dont-reply-to-names "info-" "\
60A regular expression specifying part of the value of the default value of
61the variable `rmail-dont-reply-to-names', for when the user does not set
62`rmail-dont-reply-to-names' explicitly. (The other part of the default
63value is the user's name.)
388348ae 64It is useful to set this variable in the site customization file.")
581d7e0b
RM
65
66;;;###autoload
43224042
RS
67(defvar rmail-ignored-headers "^via:\\|^mail-from:\\|^origin:\\|^status:\\|^received:\\|^x400-originator:\\|^x400-recipients:\\|^x400-received:\\|^x400-mts-identifier:\\|^x400-content-type:\\|^message-id:\\|^summary-line:" "\
68*Regexp to match Header fields that rmail should normally hide.")
581d7e0b
RM
69
70;;;###autoload
71(defvar rmail-delete-after-output nil "\
72*Non-nil means automatically delete a message that is copied to a file.")
73
74;;;###autoload
5009d9f0 75(defvar rmail-primary-inbox-list nil "\
3af9db89
RS
76*List of files which are inboxes for user's primary mail file `~/RMAIL'.
77`nil' means the default, which is (\"/usr/spool/mail/$USER\")
78\(the name varies depending on the operating system,
581d7e0b
RM
79and the value of the environment variable MAIL overrides it).")
80
94ed51e8
RS
81;;;###autoload
82(defvar rmail-mail-new-frame nil
83 "*Non-nil means Rmail makes a new frame for composing outgoing mail.")
84
b30b6e28
RS
85;;;###autoload
86(defvar rmail-retry-setup-hook nil
87 "Hook that `rmail-retry-failure' uses in place of `mail-setup-hook'.")
88
90254bb0
RS
89;;;###autoload
90(defvar rmail-secondary-file-directory "~/"
91 "*Directory for additional secondary Rmail files.")
92;;;###autoload
93(defvar rmail-secondary-file-regexp "\\.xmail$"
94 "*Regexp for which files are secondary Rmail files.")
95
bd1f0f84
RS
96;; These may be altered by site-init.el to match the format of mmdf files
97;; delimiting used on a given host (delim1 and delim2 from the config
98;; files).
581d7e0b
RM
99
100(defvar mmdf-delim1 "^\001\001\001\001\n"
101 "Regexp marking the start of an mmdf message")
102(defvar mmdf-delim2 "^\001\001\001\001\n"
103 "Regexp marking the end of an mmdf message")
104
105(defvar rmail-message-filter nil
c47fae76
KH
106 "If non nil, a filter function for new messages in RMAIL.
107Called with region narrowed to the message, including headers.")
581d7e0b 108
bd1f0f84
RS
109(defvar rmail-reply-prefix "Re: "
110 "String to prepend to Subject line when replying to a message.")
111
581d7e0b
RM
112(defvar rmail-mode-map nil)
113
114(defvar rmail-inbox-list nil)
115(defvar rmail-keywords nil)
116
117;; Message counters and markers. Deleted flags.
118
119(defvar rmail-current-message nil)
120(defvar rmail-total-messages nil)
121(defvar rmail-message-vector nil)
122(defvar rmail-deleted-vector nil)
123
124;; These are used by autoloaded rmail-summary.
125
126(defvar rmail-summary-buffer nil)
127(defvar rmail-summary-vector nil)
128
129;; `Sticky' default variables.
130
131;; Last individual label specified to a or k.
132(defvar rmail-last-label nil)
bd1f0f84 133;; Last set of values specified to C-M-n, C-M-p, C-M-s or C-M-l.
581d7e0b 134(defvar rmail-last-multi-labels nil)
bd1f0f84 135(defvar rmail-last-regexp nil)
c08f13bf
RS
136(defvar rmail-default-file nil
137 "*Default file name for \\[rmail-output].")
138(defvar rmail-default-rmail-file (expand-file-name "~/XMAIL")
139 "*Default file name for \\[rmail-output-to-rmail-file].")
46947372 140
4746118a
JB
141;;; Regexp matching the delimiter of messages in UNIX mail format
142;;; (UNIX From lines), minus the initial ^. Note that if you change
143;;; this expression, you must change the code in rmail-nuke-pinhead-header
144;;; that knows the exact ordering of the \\( \\) subexpressions.
46947372 145(defvar rmail-unix-mail-delimiter
b7cceaf1 146 (let ((time-zone-regexp
13a5fb22 147 (concat "\\([A-Z]?[A-Z][A-Z][A-Z]\\( DST\\)?"
b7cceaf1
JB
148 "\\|[-+]?[0-9][0-9][0-9][0-9]"
149 "\\|"
150 "\\) *")))
151 (concat
152 "From "
153
154 ;; Username, perhaps with a quoted section that can contain spaces.
155 "\\("
156 "[^ \n]*"
157 "\\(\\|\".*\"[^ \n]*\\)"
158 "\\) ?"
159
160 ;; The time the message was sent.
161 "\\([^ \n]*\\) *" ; day of the week
162 "\\([^ ]*\\) *" ; month
163 "\\([0-9]*\\) *" ; day of month
164 "\\([0-9:]*\\) *" ; time of day
165
166 ;; Perhaps a time zone, specified by an abbreviation, or by a
167 ;; numeric offset.
168 time-zone-regexp
169
170 ;; The year.
171 " [0-9][0-9]\\([0-9]*\\) *"
172
173 ;; On some systems the time zone can appear after the year, too.
174 time-zone-regexp
175
176 ;; I'm not sure what this is.
177 "\\(remote from [^\n]*\\)?"
178
179 "\n"))
180 nil)
181
bd1f0f84
RS
182;; Perform BODY in the summary buffer
183;; in such a way that its cursor is properly updated in its own window.
184(defmacro rmail-select-summary (&rest body)
185 (` (progn (if (rmail-summary-displayed)
186 (let ((window (selected-window)))
46564c8d
RS
187 (save-excursion
188 (unwind-protect
189 (progn
190 (pop-to-buffer rmail-summary-buffer)
191 (,@ body))
192 (select-window window))))
bd1f0f84
RS
193 (save-excursion
194 (set-buffer rmail-summary-buffer)
195 (progn (,@ body))))
196 (rmail-maybe-display-summary))))
581d7e0b
RM
197\f
198;;;; *** Rmail Mode ***
199
200;;;###autoload
201(defun rmail (&optional file-name-arg)
202 "Read and edit incoming mail.
c42722e3 203Moves messages into file named by `rmail-file-name' (a babyl format file)
581d7e0b
RM
204 and edits that file in RMAIL Mode.
205Type \\[describe-mode] once editing that file, for a list of RMAIL commands.
206
d2fc297c
RS
207May be called with file name as argument; then performs rmail editing on
208that file, but does not copy any new mail into the file.
209Interactively, if you supply a prefix argument, then you
210have a chance to specify a file name with the minibuffer."
581d7e0b
RM
211 (interactive (if current-prefix-arg
212 (list (read-file-name "Run rmail on RMAIL file: "
213 nil nil t))))
c08f13bf
RS
214 (or rmail-default-file
215 (setq rmail-default-file (expand-file-name "~/xmail")))
581d7e0b
RM
216 (let* ((file-name (expand-file-name (or file-name-arg rmail-file-name)))
217 (existed (get-file-buffer file-name)))
218 ;; Like find-file, but in the case where a buffer existed
219 ;; and the file was reverted, recompute the message-data.
220 (if (and existed (not (verify-visited-file-modtime existed)))
221 (progn
222 ;; Don't be confused by apparent local-variables spec
223 ;; in the last message in the RMAIL file.
8defe99b 224 (let ((enable-local-variables nil))
581d7e0b 225 (find-file file-name))
bd1f0f84
RS
226 (if (and (verify-visited-file-modtime existed)
227 (eq major-mode 'rmail-mode))
581d7e0b
RM
228 (progn (rmail-forget-messages)
229 (rmail-set-message-counters))))
8defe99b 230 (let ((enable-local-variables nil))
581d7e0b 231 (find-file file-name)))
bd1f0f84
RS
232 (if (eq major-mode 'rmail-edit-mode)
233 (error "Exit Rmail Edit mode before getting new mail."))
581d7e0b
RM
234 (if (and existed (> (buffer-size) 0))
235 ;; Buffer not new and not empty; ensure in proper mode, but that's all.
236 (or (eq major-mode 'rmail-mode)
237 (rmail-mode-2))
238 (rmail-mode-2)
581d7e0b
RM
239 ;; Convert all or part to Babyl file if possible.
240 (rmail-convert-file)
241 (goto-char (point-max))
242 (if (null rmail-inbox-list)
243 (progn
244 (rmail-set-message-counters)
245 (rmail-show-message))))
e9c735fa 246 (let ((existing-unseen (rmail-first-unseen-message)))
c42722e3
RS
247 (or file-name-arg
248 (rmail-get-new-mail))
e9c735fa
JA
249 ;; Show the first unseen message, which might be from a previous session
250 ;; or might have been just read in by rmail-get-new-mail. Must
251 ;; determine already unseen messages first, as rmail-get-new-mail
eb8c3be9 252 ;; positions on the first new message, thus marking it as seen.
e9c735fa 253 (rmail-show-message existing-unseen))))
581d7e0b
RM
254
255;; Given the value of MAILPATH, return a list of inbox file names.
256;; This is turned off because it is not clear that the user wants
257;; all these inboxes to feed into the primary rmail file.
258; (defun rmail-convert-mailpath (string)
259; (let (idx list)
260; (while (setq idx (string-match "[%:]" string))
261; (let ((this (substring string 0 idx)))
262; (setq string (substring string (1+ idx)))
263; (setq list (cons (if (string-match "%" this)
264; (substring this 0 (string-match "%" this))
265; this)
266; list))))
267; list))
268
269; I have checked that adding "-*- rmail -*-" to the BABYL OPTIONS line
270; will not cause emacs 18.55 problems.
271
272(defun rmail-convert-file ()
273 (let (convert)
274 (widen)
275 (goto-char (point-min))
276 ;; If file doesn't start like a Babyl file,
277 ;; convert it to one, by adding a header and converting each message.
278 (cond ((looking-at "BABYL OPTIONS:"))
279 ((looking-at "Version: 5\n")
280 ;; Losing babyl file made by old version of Rmail.
281 ;; Just fix the babyl file header; don't make a new one,
282 ;; so we don't lose the Labels: file attribute, etc.
283 (let ((buffer-read-only nil))
284 (insert "BABYL OPTIONS: -*- rmail -*-\n")))
760a3528
BF
285 ((equal (point-min) (point-max))
286 ;; Empty RMAIL file. Just insert the header.
287 (rmail-insert-rmail-file-header))
581d7e0b 288 (t
760a3528 289 ;; Non-empty file in non-RMAIL format. Add header and convert.
581d7e0b
RM
290 (setq convert t)
291 (rmail-insert-rmail-file-header)))
292 ;; If file was not a Babyl file or if there are
293 ;; Unix format messages added at the end,
294 ;; convert file as necessary.
295 (if (or convert
e3e87be8
RS
296 (save-excursion
297 (goto-char (point-max))
298 (search-backward "\^_")
299 (forward-char 1)
300 (looking-at "\n*From ")))
581d7e0b
RM
301 (let ((buffer-read-only nil))
302 (message "Converting to Babyl format...")
e3e87be8
RS
303 ;; If file needs conversion, convert it all,
304 ;; except for the BABYL header.
305 ;; (rmail-convert-to-babyl-format would delete the header.)
e3e87be8
RS
306 (goto-char (point-min))
307 (search-forward "\n\^_" nil t)
073fb956 308 (narrow-to-region (point) (point-max))
581d7e0b
RM
309 (rmail-convert-to-babyl-format)
310 (message "Converting to Babyl format...done")))))
311
760a3528
BF
312;;; I have checked that adding "-*- rmail -*-" to the BABYL OPTIONS line
313;;; will not cause emacs 18.55 problems.
581d7e0b
RM
314
315(defun rmail-insert-rmail-file-header ()
316 (let ((buffer-read-only nil))
317 (insert "BABYL OPTIONS: -*- rmail -*-
318Version: 5
319Labels:
320Note: This is the header of an rmail file.
321Note: If you are seeing it in rmail,
322Note: it means the file has no messages in it.\n\^_")))
323
324(if rmail-mode-map
325 nil
326 (setq rmail-mode-map (make-keymap))
327 (suppress-keymap rmail-mode-map)
bd1f0f84
RS
328 (define-key rmail-mode-map "a" 'rmail-add-label)
329 (define-key rmail-mode-map "b" 'rmail-bury)
330 (define-key rmail-mode-map "c" 'rmail-continue)
331 (define-key rmail-mode-map "d" 'rmail-delete-forward)
332 (define-key rmail-mode-map "\C-d" 'rmail-delete-backward)
333 (define-key rmail-mode-map "e" 'rmail-edit-current-message)
334 (define-key rmail-mode-map "f" 'rmail-forward)
335 (define-key rmail-mode-map "g" 'rmail-get-new-mail)
336 (define-key rmail-mode-map "h" 'rmail-summary)
337 (define-key rmail-mode-map "i" 'rmail-input)
338 (define-key rmail-mode-map "j" 'rmail-show-message)
339 (define-key rmail-mode-map "k" 'rmail-kill-label)
340 (define-key rmail-mode-map "l" 'rmail-summary-by-labels)
581d7e0b 341 (define-key rmail-mode-map "\e\C-h" 'rmail-summary)
581d7e0b
RM
342 (define-key rmail-mode-map "\e\C-l" 'rmail-summary-by-labels)
343 (define-key rmail-mode-map "\e\C-r" 'rmail-summary-by-recipients)
344 (define-key rmail-mode-map "\e\C-s" 'rmail-summary-by-regexp)
bd1f0f84
RS
345 (define-key rmail-mode-map "\e\C-t" 'rmail-summary-by-topic)
346 (define-key rmail-mode-map "m" 'rmail-mail)
347 (define-key rmail-mode-map "\em" 'rmail-retry-failure)
348 (define-key rmail-mode-map "n" 'rmail-next-undeleted-message)
349 (define-key rmail-mode-map "\en" 'rmail-next-message)
350 (define-key rmail-mode-map "\e\C-n" 'rmail-next-labeled-message)
351 (define-key rmail-mode-map "o" 'rmail-output-to-rmail-file)
352 (define-key rmail-mode-map "\C-o" 'rmail-output)
353 (define-key rmail-mode-map "p" 'rmail-previous-undeleted-message)
354 (define-key rmail-mode-map "\ep" 'rmail-previous-message)
355 (define-key rmail-mode-map "\e\C-p" 'rmail-previous-labeled-message)
356 (define-key rmail-mode-map "q" 'rmail-quit)
357 (define-key rmail-mode-map "r" 'rmail-reply)
ed7ace63 358;; I find I can't live without the default M-r command -- rms.
bd1f0f84
RS
359;; (define-key rmail-mode-map "\er" 'rmail-search-backwards)
360 (define-key rmail-mode-map "s" 'rmail-expunge-and-save)
361 (define-key rmail-mode-map "\es" 'rmail-search)
362 (define-key rmail-mode-map "t" 'rmail-toggle-header)
363 (define-key rmail-mode-map "u" 'rmail-undelete-previous-message)
364 (define-key rmail-mode-map "w" 'rmail-edit-current-message)
365 (define-key rmail-mode-map "x" 'rmail-expunge)
366 (define-key rmail-mode-map "." 'rmail-beginning-of-message)
367 (define-key rmail-mode-map "<" 'rmail-first-message)
368 (define-key rmail-mode-map ">" 'rmail-last-message)
369 (define-key rmail-mode-map " " 'scroll-up)
370 (define-key rmail-mode-map "\177" 'scroll-down)
371 (define-key rmail-mode-map "?" 'describe-mode)
3bf526cf
RS
372 (define-key rmail-mode-map "\C-c\C-s\C-d" 'rmail-sort-by-date)
373 (define-key rmail-mode-map "\C-c\C-s\C-s" 'rmail-sort-by-subject)
374 (define-key rmail-mode-map "\C-c\C-s\C-a" 'rmail-sort-by-author)
375 (define-key rmail-mode-map "\C-c\C-s\C-r" 'rmail-sort-by-recipient)
376 (define-key rmail-mode-map "\C-c\C-s\C-c" 'rmail-sort-by-correspondent)
377 (define-key rmail-mode-map "\C-c\C-s\C-l" 'rmail-sort-by-lines)
9ae6d54a 378 (define-key rmail-mode-map "\C-c\C-s\C-k" 'rmail-sort-by-keywords)
bd1f0f84 379 )
5201ddda
RS
380\f
381(define-key rmail-mode-map [menu-bar] (make-sparse-keymap))
382
383(define-key rmail-mode-map [menu-bar classify]
384 (cons "Classify" (make-sparse-keymap "Classify")))
385
4139208e
RS
386(define-key rmail-mode-map [menu-bar classify input-menu]
387 '("Input Rmail file (menu)" . rmail-input-menu))
388
389(define-key rmail-mode-map [menu-bar classify output-menu]
390 '("Output (Rmail menu)" . rmail-output-menu))
391
5201ddda
RS
392(define-key rmail-mode-map [menu-bar classify output-inbox]
393 '("Output (inbox)" . rmail-output))
394
395(define-key rmail-mode-map [menu-bar classify output]
396 '("Output (Rmail)" . rmail-output-to-rmail-file))
397
398(define-key rmail-mode-map [menu-bar classify kill-label]
399 '("Kill Label" . rmail-kill-label))
400
401(define-key rmail-mode-map [menu-bar classify add-label]
402 '("Add Label" . rmail-add-label))
403
404(define-key rmail-mode-map [menu-bar summary]
405 (cons "Summary" (make-sparse-keymap "Summary")))
406
407(define-key rmail-mode-map [menu-bar summary labels]
408 '("By Labels" . rmail-summary-by-labels))
409
410(define-key rmail-mode-map [menu-bar summary recipients]
411 '("By Recipients" . rmail-summary-by-recipients))
412
413(define-key rmail-mode-map [menu-bar summary topic]
414 '("By Topic" . rmail-summary-by-topic))
415
416(define-key rmail-mode-map [menu-bar summary regexp]
417 '("By Regexp" . rmail-summary-by-regexp))
418
419(define-key rmail-mode-map [menu-bar summary all]
420 '("All" . rmail-summary))
421
422(define-key rmail-mode-map [menu-bar mail]
423 (cons "Mail" (make-sparse-keymap "Mail")))
424
425(define-key rmail-mode-map [menu-bar mail continue]
426 '("Continue" . rmail-continue))
427
428(define-key rmail-mode-map [menu-bar mail forward]
429 '("Forward" . rmail-forward))
430
431(define-key rmail-mode-map [menu-bar mail retry]
432 '("Retry" . rmail-retry-failure))
433
434(define-key rmail-mode-map [menu-bar mail reply]
435 '("Reply" . rmail-reply))
436
437(define-key rmail-mode-map [menu-bar mail mail]
438 '("Mail" . rmail-mail))
439
440(define-key rmail-mode-map [menu-bar delete]
441 (cons "Delete" (make-sparse-keymap "Delete")))
442
443(define-key rmail-mode-map [menu-bar delete expunge/save]
444 '("Expunge/Save" . rmail-expunge-and-save))
581d7e0b 445
5201ddda
RS
446(define-key rmail-mode-map [menu-bar delete expunge]
447 '("Expunge" . rmail-expunge))
448
449(define-key rmail-mode-map [menu-bar delete undelete]
450 '("Undelete" . rmail-undelete-previous-message))
451
452(define-key rmail-mode-map [menu-bar delete delete]
453 '("Delete" . rmail-delete-forward))
454
455(define-key rmail-mode-map [menu-bar move]
456 (cons "Move" (make-sparse-keymap "Move")))
457
458(define-key rmail-mode-map [menu-bar move search-back]
459 '("Search Back" . rmail-search-backward))
460
461(define-key rmail-mode-map [menu-bar move search]
462 '("Search" . rmail-search))
463
464(define-key rmail-mode-map [menu-bar move previous]
465 '("Previous Nondeleted" . rmail-previous-undeleted-message))
466
467(define-key rmail-mode-map [menu-bar move next]
468 '("Next Nondeleted" . rmail-next-undeleted-message))
469
470(define-key rmail-mode-map [menu-bar move last]
471 '("Last" . rmail-last-message))
472
473(define-key rmail-mode-map [menu-bar move first]
474 '("First" . rmail-first-message))
475
476(define-key rmail-mode-map [menu-bar move previous]
477 '("Previous" . rmail-previous-message))
478
479(define-key rmail-mode-map [menu-bar move next]
480 '("Next" . rmail-next-message))
481\f
581d7e0b
RM
482;; Rmail mode is suitable only for specially formatted data.
483(put 'rmail-mode 'mode-class 'special)
484
9712b0bd 485;;;###autoload
581d7e0b
RM
486(defun rmail-mode ()
487 "Rmail Mode is used by \\<rmail-mode-map>\\[rmail] for editing Rmail files.
488All normal editing commands are turned off.
489Instead, these commands are available:
490
491\\[rmail-beginning-of-message] Move point to front of this message (same as \\[beginning-of-buffer]).
492\\[scroll-up] Scroll to next screen of this message.
493\\[scroll-down] Scroll to previous screen of this message.
494\\[rmail-next-undeleted-message] Move to Next non-deleted message.
495\\[rmail-previous-undeleted-message] Move to Previous non-deleted message.
496\\[rmail-next-message] Move to Next message whether deleted or not.
497\\[rmail-previous-message] Move to Previous message whether deleted or not.
498\\[rmail-first-message] Move to the first message in Rmail file.
499\\[rmail-last-message] Move to the last message in Rmail file.
500\\[rmail-show-message] Jump to message specified by numeric position in file.
501\\[rmail-search] Search for string and show message it is found in.
502\\[rmail-delete-forward] Delete this message, move to next nondeleted.
503\\[rmail-delete-backward] Delete this message, move to previous nondeleted.
504\\[rmail-undelete-previous-message] Undelete message. Tries current message, then earlier messages
505 till a deleted message is found.
bd1f0f84 506\\[rmail-edit-current-message] Edit the current message. \\[rmail-cease-edit] to return to Rmail.
581d7e0b
RM
507\\[rmail-expunge] Expunge deleted messages.
508\\[rmail-expunge-and-save] Expunge and save the file.
509\\[rmail-quit] Quit Rmail: expunge, save, then switch to another buffer.
510\\[save-buffer] Save without expunging.
3af9db89 511\\[rmail-get-new-mail] Move new mail from system spool directory into this file.
581d7e0b
RM
512\\[rmail-mail] Mail a message (same as \\[mail-other-window]).
513\\[rmail-continue] Continue composing outgoing message started before.
bd1f0f84
RS
514\\[rmail-reply] Reply to this message. Like \\[rmail-mail] but initializes some fields.
515\\[rmail-retry-failure] Send this message again. Used on a mailer failure message.
581d7e0b
RM
516\\[rmail-forward] Forward this message to another user.
517\\[rmail-output-to-rmail-file] Output this message to an Rmail file (append it).
518\\[rmail-output] Output this message to a Unix-format mail file (append it).
519\\[rmail-input] Input Rmail file. Run Rmail on that file.
520\\[rmail-add-label] Add label to message. It will be displayed in the mode line.
521\\[rmail-kill-label] Kill label. Remove a label from current message.
522\\[rmail-next-labeled-message] Move to Next message with specified label
523 (label defaults to last one specified).
524 Standard labels: filed, unseen, answered, forwarded, deleted.
bd1f0f84 525 Any other label is present only if you add it with \\[rmail-add-label].
581d7e0b
RM
526\\[rmail-previous-labeled-message] Move to Previous message with specified label
527\\[rmail-summary] Show headers buffer, with a one line summary of each message.
bd1f0f84
RS
528\\[rmail-summary-by-labels] Summarize only messages with particular label(s).
529\\[rmail-summary-by-recipients] Summarize only messages with particular recipient(s).
530\\[rmail-summary-by-regexp] Summarize only messages with particular regexp(s).
531\\[rmail-summary-by-topic] Summarize only messages with subject line regexp(s).
532\\[rmail-toggle-header] Toggle display of complete header."
581d7e0b
RM
533 (interactive)
534 (rmail-mode-2)
535 (rmail-set-message-counters)
aac180a7 536 (rmail-show-message rmail-total-messages))
581d7e0b
RM
537
538(defun rmail-mode-2 ()
539 (kill-all-local-variables)
540 (rmail-mode-1)
541 (rmail-variables)
542 (run-hooks 'rmail-mode-hook))
543
544(defun rmail-mode-1 ()
545 (setq major-mode 'rmail-mode)
546 (setq mode-name "RMAIL")
547 (setq buffer-read-only t)
876cd689
RS
548 ;; No need to auto save RMAIL files in normal circumstances
549 ;; because they contain no info except attribute changes
550 ;; and deletion of messages.
551 ;; The one exception is when messages are copied into an Rmail mode buffer.
552 ;; rmail-output-to-rmail-file enables auto save when you do that.
581d7e0b
RM
553 (setq buffer-auto-save-file-name nil)
554 (if (boundp 'mode-line-modified)
555 (setq mode-line-modified "--- ")
556 (setq mode-line-format
557 (cons "--- " (cdr (default-value 'mode-line-format)))))
558 (use-local-map rmail-mode-map)
559 (set-syntax-table text-mode-syntax-table)
560 (setq local-abbrev-table text-mode-abbrev-table))
561
562(defun rmail-variables ()
563 (make-local-variable 'revert-buffer-function)
564 (setq revert-buffer-function 'rmail-revert)
565 (make-local-variable 'rmail-last-label)
bd1f0f84 566 (make-local-variable 'rmail-last-regexp)
581d7e0b
RM
567 (make-local-variable 'rmail-deleted-vector)
568 (make-local-variable 'rmail-summary-buffer)
569 (make-local-variable 'rmail-summary-vector)
570 (make-local-variable 'rmail-current-message)
571 (make-local-variable 'rmail-total-messages)
572 (make-local-variable 'require-final-newline)
573 (setq require-final-newline nil)
574 (make-local-variable 'version-control)
575 (setq version-control 'never)
576 (make-local-variable 'file-precious-flag)
577 (setq file-precious-flag t)
578 (make-local-variable 'rmail-message-vector)
579 (make-local-variable 'rmail-last-file)
580 (make-local-variable 'rmail-inbox-list)
581 (setq rmail-inbox-list (rmail-parse-file-inboxes))
849056cc
RS
582 ;; Provide default set of inboxes for primary mail file ~/RMAIL.
583 (and (null rmail-inbox-list)
6cd37f8f 584 (or (equal buffer-file-name (expand-file-name rmail-file-name))
a38837b5
RS
585 (equal buffer-file-truename
586 (abbreviate-file-name (file-truename rmail-file-name))))
849056cc
RS
587 (setq rmail-inbox-list
588 (or rmail-primary-inbox-list
589 (list (or (getenv "MAIL")
590 (concat rmail-spool-directory
d0eecffa 591 (user-login-name)))))))
581d7e0b
RM
592 (make-local-variable 'rmail-keywords)
593 ;; this gets generated as needed
a4b340c5
KH
594 (setq rmail-keywords nil)
595 ;; Make everything permanent, in case the user switches major modes
596 ;; during an edit.
597 (put 'revert-buffer-function 'permanent-local t)
598 (put 'rmail-last-label 'permanent-local t)
599 (put 'rmail-last-regexp 'permanent-local t)
600 (put 'rmail-deleted-vector 'permanent-local t)
601 (put 'rmail-summary-buffer 'permanent-local t)
602 (put 'rmail-summary-vector 'permanent-local t)
603 (put 'rmail-current-message 'permanent-local t)
604 (put 'rmail-total-messages 'permanent-local t)
605 (put 'require-final-newline 'permanent-local t)
606 (put 'version-control 'permanent-local t)
607 (put 'file-precious-flag 'permanent-local t)
608 (put 'rmail-message-vector 'permanent-local t)
609 (put 'rmail-last-file 'permanent-local t)
610 (put 'rmail-inbox-list 'permanent-local t)
611 (put 'rmail-keywords 'permanent-local t))
581d7e0b
RM
612
613;; Handle M-x revert-buffer done in an rmail-mode buffer.
614(defun rmail-revert (arg noconfirm)
615 (let (revert-buffer-function)
616 ;; Call our caller again, but this time it does the default thing.
617 (if (revert-buffer arg noconfirm)
618 ;; If the user said "yes", and we changed something,
619 ;; reparse the messages.
620 (progn
621 (rmail-convert-file)
622 (goto-char (point-max))
623 (rmail-set-message-counters)
624 (rmail-show-message)))))
625
626;; Return a list of files from this buffer's Mail: option.
627;; Does not assume that messages have been parsed.
628;; Just returns nil if buffer does not look like Babyl format.
629(defun rmail-parse-file-inboxes ()
630 (save-excursion
631 (save-restriction
632 (widen)
633 (goto-char 1)
634 (cond ((looking-at "BABYL OPTIONS:")
635 (search-forward "\n\^_" nil 'move)
636 (narrow-to-region 1 (point))
637 (goto-char 1)
638 (if (search-forward "\nMail:" nil t)
639 (progn
640 (narrow-to-region (point) (progn (end-of-line) (point)))
641 (goto-char (point-min))
642 (mail-parse-comma-list))))))))
643
644(defun rmail-expunge-and-save ()
645 "Expunge and save RMAIL file."
646 (interactive)
647 (rmail-expunge)
c7065819
KH
648 (save-buffer)
649 (if (rmail-summary-exists)
650 (rmail-select-summary (set-buffer-modified-p nil))))
581d7e0b
RM
651
652(defun rmail-quit ()
653 "Quit out of RMAIL."
654 (interactive)
655 (rmail-expunge-and-save)
656 ;; Don't switch to the summary buffer even if it was recently visible.
657 (if rmail-summary-buffer
21f69e7e
RS
658 (progn
659 (replace-buffer-in-windows rmail-summary-buffer)
660 (bury-buffer rmail-summary-buffer)))
581d7e0b 661 (let ((obuf (current-buffer)))
21f69e7e 662 (replace-buffer-in-windows obuf)
581d7e0b
RM
663 (bury-buffer obuf)))
664
665;;;###autoload
666(defun rmail-input (filename)
bd1f0f84 667 "Run Rmail on file FILENAME."
581d7e0b
RM
668 (interactive "FRun rmail on RMAIL file: ")
669 (rmail filename))
670
90254bb0
RS
671;; Choose a .xmail file in dir rmail-secondary-file-directory.
672(defun rmail-secondary-file-menu (event)
20625095 673 (let* ((files (directory-files rmail-secondary-file-directory nil
90254bb0
RS
674 rmail-secondary-file-regexp))
675 (menu (list "Rmail Files"
676 (cons "Rmail Files"
677 (mapcar (function (lambda (f) (cons f f)))
4139208e
RS
678 files))))
679 (chosen (x-popup-menu event menu)))
680 (if chosen
681 (expand-file-name chosen rmail-secondary-file-directory))))
90254bb0
RS
682
683(defun rmail-input-menu (event)
684 "Choose a new Rmail file to edit, with a menu."
685 (interactive "e")
686 (rmail-input (expand-file-name (rmail-secondary-file-menu event)
687 rmail-secondary-file-directory)))
581d7e0b
RM
688\f
689;;;; *** Rmail input ***
690
691;; RLK feature not added in this version:
692;; argument specifies inbox file or files in various ways.
693
694(defun rmail-get-new-mail (&optional file-name)
695 "Move any new mail from this RMAIL file's inbox files.
696The inbox files can be specified with the file's Mail: option. The
697variable `rmail-primary-inbox-list' specifies the inboxes for your
3af9db89
RS
698primary RMAIL file if it has no Mail: option. By default, this is
699your /usr/spool/mail/$USER.
581d7e0b
RM
700
701You can also specify the file to get new mail from. In this case, the
702file of new mail is not changed or deleted. Noninteractively, you can
703pass the inbox file name as an argument. Interactively, a prefix
704argument causes us to read a file name and use that file as the inbox."
705 (interactive
706 (list (if current-prefix-arg
707 (read-file-name "Get new mail from file: "))))
708 (or (verify-visited-file-modtime (current-buffer))
709 (progn
710 (find-file (buffer-file-name))
449783e9 711 (setq buffer-read-only t)
581d7e0b
RM
712 (if (verify-visited-file-modtime (current-buffer))
713 (rmail-forget-messages))))
714 (rmail-maybe-set-message-counters)
715 (widen)
716 ;; Get rid of all undo records for this buffer.
717 (or (eq buffer-undo-list t)
718 (setq buffer-undo-list nil))
719 (unwind-protect
720 (let ((opoint (point))
721 (new-messages 0)
722 (delete-files ())
723 ;; If buffer has not changed yet, and has not been saved yet,
724 ;; don't replace the old backup file now.
725 (make-backup-files (and make-backup-files (buffer-modified-p)))
726 (buffer-read-only nil)
727 ;; Don't make undo records for what we do in getting mail.
728 (buffer-undo-list t))
729 (goto-char (point-max))
730 (skip-chars-backward " \t\n") ; just in case of brain damage
731 (delete-region (point) (point-max)) ; caused by require-final-newline
732 (save-excursion
733 (save-restriction
734 (narrow-to-region (point) (point))
735 ;; Read in the contents of the inbox files,
736 ;; renaming them as necessary,
737 ;; and adding to the list of files to delete eventually.
738 (if file-name
739 (rmail-insert-inbox-text (list file-name) nil)
740 (setq delete-files (rmail-insert-inbox-text rmail-inbox-list t)))
741 ;; Scan the new text and convert each message to babyl format.
742 (goto-char (point-min))
743 (save-excursion
744 (setq new-messages (rmail-convert-to-babyl-format)))
745 (or (zerop new-messages)
746 (let (success)
747 (widen)
934111d0 748 (search-backward "\n\^_" nil t)
581d7e0b
RM
749 (narrow-to-region (point) (point-max))
750 (goto-char (1+ (point-min)))
751 (rmail-count-new-messages)
752 (save-buffer)))
753 ;; Delete the old files, now that babyl file is saved.
754 (while delete-files
755 (condition-case ()
ba0b5507
RS
756 ;; First, try deleting.
757 (condition-case ()
758 (delete-file (car delete-files))
759 (file-error
760 ;; If we can't delete it, truncate it.
761 (write-region (point) (point) (car delete-files))))
581d7e0b
RM
762 (file-error nil))
763 (setq delete-files (cdr delete-files)))))
764 (if (= new-messages 0)
765 (progn (goto-char opoint)
766 (if (or file-name rmail-inbox-list)
767 (message "(No new mail has arrived)")))
bd1f0f84
RS
768 (if (rmail-summary-exists)
769 (rmail-select-summary
770 (rmail-update-summary)))
581d7e0b
RM
771 (message "%d new message%s read"
772 new-messages (if (= 1 new-messages) "" "s"))
773 (and (boundp 'display-time-string)
151c7da2 774 (stringp display-time-string)
581d7e0b
RM
775 (string-match " Mail" display-time-string)
776 (setq display-time-string
777 (concat
778 (substring display-time-string 0 (match-beginning 0))
779 (substring display-time-string (match-end 0))))
780 (force-mode-line-update 'all))))
781 ;; Don't leave the buffer screwed up if we get a disk-full error.
782 (rmail-show-message)))
783
784(defun rmail-insert-inbox-text (files renamep)
bd1f0f84 785 (let (file tofile delete-files movemail popmail)
581d7e0b 786 (while files
5170c9cb
KH
787 (setq file (file-truename
788 (expand-file-name (substitute-in-file-name (car files))))
581d7e0b 789 ;;>> un*x specific <<
2581ab99
JB
790 ;; The "+" used to be "~", which is an extremely poor choice;
791 ;; it might accidentally be deleted when space is low
792 ;; (as happened to me!).
793 tofile (concat file "+"))
581d7e0b
RM
794 ;; If getting from mail spool directory,
795 ;; use movemail to move rather than just renaming,
796 ;; so as to interlock with the mailer.
5170c9cb
KH
797 (setq movemail (string= (file-name-directory file)
798 (file-truename rmail-spool-directory))
bd1f0f84
RS
799 popmail (string-match "^po:" (file-name-nondirectory file)))
800 (if popmail (setq file (file-name-nondirectory file)
801 renamep t))
581d7e0b
RM
802 (if movemail
803 (progn
804 (setq tofile (expand-file-name
bd1f0f84
RS
805 ;; Generate name to move to from inbox name,
806 ;; in case of multiple inboxes that need moving.
807 (concat ".newmail-" (file-name-nondirectory file))
808 ;; Use the directory of this rmail file
809 ;; because it's a nuisance to use the homedir
810 ;; if that is on a full disk and this rmail
811 ;; file isn't.
812 (file-name-directory
813 (expand-file-name buffer-file-name))))
581d7e0b
RM
814 ;; On some systems, /usr/spool/mail/foo is a directory
815 ;; and the actual inbox is /usr/spool/mail/foo/foo.
816 (if (file-directory-p file)
d0eecffa 817 (setq file (expand-file-name (user-login-name)
581d7e0b 818 file)))))
bd1f0f84
RS
819 (if popmail
820 (message "Getting mail from post office ...")
821 (if (or (and (file-exists-p tofile)
822 (/= 0 (nth 7 (file-attributes tofile))))
823 (and (file-exists-p file)
824 (/= 0 (nth 7 (file-attributes file)))))
825 (message "Getting mail from %s..." file)))
581d7e0b
RM
826 ;; Set TOFILE if have not already done so, and
827 ;; rename or copy the file FILE to TOFILE if and as appropriate.
828 (cond ((not renamep)
829 (setq tofile file))
bd1f0f84
RS
830 ((or (file-exists-p tofile) (and (not popmail)
831 (not (file-exists-p file))))
581d7e0b 832 nil)
bd1f0f84 833 ((and (not movemail) (not popmail))
019bf2a3
RS
834 ;; Try copying. If that fails (perhaps no space),
835 ;; rename instead.
836 (condition-case nil
837 (copy-file file tofile nil)
838 (error
660a52f9
RS
839 ;; Third arg is t so we can replace existing file TOFILE.
840 (rename-file file tofile t)))
ba0b5507
RS
841 ;; Make the real inbox file empty.
842 ;; Leaving it deleted could cause lossage
843 ;; because mailers often won't create the file.
844 (condition-case ()
845 (write-region (point) (point) file)
846 (file-error nil)))
581d7e0b
RM
847 (t
848 (let ((errors nil))
849 (unwind-protect
850 (save-excursion
851 (setq errors (generate-new-buffer " *rmail loss*"))
852 (buffer-disable-undo errors)
853 (call-process
854 (expand-file-name "movemail" exec-directory)
855 nil errors nil file tofile)
856 (if (not (buffer-modified-p errors))
857 ;; No output => movemail won
858 nil
859 (set-buffer errors)
860 (subst-char-in-region (point-min) (point-max)
861 ?\n ?\ )
862 (goto-char (point-max))
863 (skip-chars-backward " \t")
864 (delete-region (point) (point-max))
865 (goto-char (point-min))
866 (if (looking-at "movemail: ")
867 (delete-region (point-min) (match-end 0)))
868 (beep t)
869 (message (concat "movemail: "
870 (buffer-substring (point-min)
871 (point-max))))
872 (sit-for 3)
873 nil))
874 (if errors (kill-buffer errors))))))
875 ;; At this point, TOFILE contains the name to read:
876 ;; Either the alternate name (if we renamed)
877 ;; or the actual inbox (if not renaming).
878 (if (file-exists-p tofile)
879 (let (size)
880 (goto-char (point-max))
881 (setq size (nth 1 (insert-file-contents tofile)))
882 (goto-char (point-max))
883 (or (= (preceding-char) ?\n)
884 (zerop size)
885 (insert ?\n))
886 (setq delete-files (cons tofile delete-files))))
887 (message "")
888 (setq files (cdr files)))
889 delete-files))
890
891;; the rmail-break-forwarded-messages feature is not implemented
892(defun rmail-convert-to-babyl-format ()
893 (let ((count 0) start
b77ab9e8
RS
894 (case-fold-search nil)
895 (invalid-input-resync
896 (function (lambda ()
897 (message "Invalid Babyl format in inbox!")
898 (sit-for 1)
899 ;; Try to get back in sync with a real message.
900 (if (re-search-forward
901 (concat mmdf-delim1 "\\|^From") nil t)
902 (beginning-of-line)
903 (goto-char (point-max)))))))
581d7e0b
RM
904 (goto-char (point-min))
905 (save-restriction
906 (while (not (eobp))
907 (cond ((looking-at "BABYL OPTIONS:");Babyl header
b77ab9e8
RS
908 (if (search-forward "\n\^_" nil t)
909 ;; If we find the proper terminator, delete through there.
910 (delete-region (point-min) (point))
911 (funcall invalid-input-resync)
a553316b 912 (delete-region (point-min) (point))))
581d7e0b
RM
913 ;; Babyl format message
914 ((looking-at "\^L")
915 (or (search-forward "\n\^_" nil t)
b77ab9e8 916 (funcall invalid-input-resync))
581d7e0b
RM
917 (setq count (1+ count))
918 ;; Make sure there is no extra white space after the ^_
919 ;; at the end of the message.
920 ;; Narrowing will make sure that whatever follows the junk
921 ;; will be treated properly.
922 (delete-region (point)
923 (save-excursion
924 (skip-chars-forward " \t\n")
925 (point)))
926 (narrow-to-region (point) (point-max)))
927 ;;*** MMDF format
928 ((let ((case-fold-search t))
929 (looking-at mmdf-delim1))
930 (let ((case-fold-search t))
931 (replace-match "\^L\n0, unseen,,\n*** EOOH ***\n")
932 (setq start (point))
933 (re-search-forward mmdf-delim2 nil t)
934 (replace-match "\^_"))
935 (save-excursion
936 (save-restriction
937 (narrow-to-region start (1- (point)))
938 (goto-char (point-min))
939 (while (search-forward "\n\^_" nil t); single char "\^_"
940 (replace-match "\n^_")))); 2 chars: "^" and "_"
941 (narrow-to-region (point) (point-max))
942 (setq count (1+ count)))
943 ;;*** Mail format
944 ((looking-at "^From ")
945 (setq start (point))
946 (insert "\^L\n0, unseen,,\n*** EOOH ***\n")
947 (rmail-nuke-pinhead-header)
bd1f0f84
RS
948 ;; If this message has a Content-Length field,
949 ;; skip to the end of the contents.
950 (let* ((header-end (save-excursion
951 (and (re-search-forward "\n\n" nil t)
a865e55b 952 (1- (point)))))
bd1f0f84
RS
953 (case-fold-search t)
954 (size
955 ;; Get the numeric value from the Content-Length field.
956 (save-excursion
957 ;; Back up to end of prev line,
958 ;; in case the Content-Length field comes first.
959 (forward-char -1)
960 (and (search-forward "\ncontent-length: "
961 header-end t)
962 (let ((beg (point))
963 (eol (progn (end-of-line) (point))))
5458f7f1
KH
964 (string-to-int (buffer-substring beg eol)))))))
965 (and size
966 (if (and (natnump size)
967 (<= (+ header-end size) (point-max))
968 ;; Make sure this would put us at a position
969 ;; that we could continue from.
970 (save-excursion
971 (goto-char (+ header-end size))
972 (skip-chars-forward "\n")
973 (or (eobp)
974 (and (looking-at "BABYL OPTIONS:")
975 (search-forward "\n\^_" nil t))
976 (and (looking-at "\^L")
977 (search-forward "\n\^_" nil t))
978 (let ((case-fold-search t))
979 (looking-at mmdf-delim1))
980 (looking-at "From "))))
981 (goto-char (+ header-end size))
982 (message "Ignoring invalid Content-Length field")
983 (sit-for 1 0 t))))
bd1f0f84 984
581d7e0b
RM
985 (if (re-search-forward
986 (concat "^[\^_]?\\("
46947372
JB
987 rmail-unix-mail-delimiter
988 "\\|"
581d7e0b
RM
989 mmdf-delim1 "\\|"
990 "^BABYL OPTIONS:\\|"
991 "\^L\n[01],\\)") nil t)
992 (goto-char (match-beginning 1))
993 (goto-char (point-max)))
994 (setq count (1+ count))
995 (save-excursion
996 (save-restriction
997 (narrow-to-region start (point))
998 (goto-char (point-min))
999 (while (search-forward "\n\^_" nil t); single char
1000 (replace-match "\n^_")))); 2 chars: "^" and "_"
1001 (insert ?\^_)
1002 (narrow-to-region (point) (point-max)))
1003 ;;
8896f2df
RS
1004 ;; This kludge is because some versions of sendmail.el
1005 ;; insert an extra newline at the beginning that shouldn't
1006 ;; be there. sendmail.el has been fixed, but old versions
1007 ;; may still be in use. -- rms, 7 May 1993.
1008 ((eolp) (delete-char 1))
a553316b 1009 (t (error "Cannot convert to babyl format")))))
581d7e0b
RM
1010 count))
1011
1012;; Delete the "From ..." line, creating various other headers with
1013;; information from it if they don't already exist. Now puts the
c42722e3
RS
1014;; original line into a mail-from: header line for debugging and for
1015;; use by the rmail-output function.
581d7e0b
RM
1016(defun rmail-nuke-pinhead-header ()
1017 (save-excursion
1018 (save-restriction
1019 (let ((start (point))
1020 (end (progn
1021 (condition-case ()
1022 (search-forward "\n\n")
1023 (error
1024 (goto-char (point-max))
1025 (insert "\n\n")))
1026 (point)))
1027 has-from has-date)
1028 (narrow-to-region start end)
1029 (let ((case-fold-search t))
1030 (goto-char start)
1031 (setq has-from (search-forward "\nFrom:" nil t))
1032 (goto-char start)
1033 (setq has-date (and (search-forward "\nDate:" nil t) (point)))
1034 (goto-char start))
1035 (let ((case-fold-search nil))
46947372 1036 (if (re-search-forward (concat "^" rmail-unix-mail-delimiter) nil t)
581d7e0b
RM
1037 (replace-match
1038 (concat
1039 "Mail-from: \\&"
1040 ;; Keep and reformat the date if we don't
1041 ;; have a Date: field.
1042 (if has-date
1043 ""
b7cceaf1
JB
1044 (concat
1045 "Date: \\3, \\5 \\4 \\9 \\6 "
1046
1047 ;; The timezone could be matched by group 7 or group 10.
1048 ;; If neither of them matched, assume EST, since only
1049 ;; Easterners would be so sloppy.
1050 ;; It's a shame the substitution can't use "\\10".
1051 (cond
1052 ((/= (match-beginning 7) (match-end 7)) "\\7")
1053 ((/= (match-beginning 10) (match-end 10))
1054 (buffer-substring (match-beginning 10)
1055 (match-end 10)))
1056 (t "EST"))
1057 "\n"))
581d7e0b
RM
1058 ;; Keep and reformat the sender if we don't
1059 ;; have a From: field.
1060 (if has-from
1061 ""
15a36ac5
RS
1062 "From: \\1\n"))
1063 t)))))))
581d7e0b
RM
1064\f
1065;;;; *** Rmail Message Formatting and Header Manipulation ***
1066
1067(defun rmail-reformat-message (beg end)
1068 (goto-char beg)
1069 (forward-line 1)
1070 (if (/= (following-char) ?0)
1071 (error "Bad format in RMAIL file."))
1072 (let ((buffer-read-only nil)
1073 (delta (- (buffer-size) end)))
1074 (delete-char 1)
1075 (insert ?1)
1076 (forward-line 1)
15a36ac5 1077 (let ((case-fold-search t))
c42722e3
RS
1078 (while (looking-at "Summary-line:\\|Mail-From:")
1079 (forward-line 1)))
581d7e0b
RM
1080 (if (looking-at "\\*\\*\\* EOOH \\*\\*\\*\n")
1081 (delete-region (point)
1082 (progn (forward-line 1) (point))))
1083 (let ((str (buffer-substring (point)
1084 (save-excursion (search-forward "\n\n" end 'move)
1085 (point)))))
1086 (insert str "*** EOOH ***\n")
1087 (narrow-to-region (point) (- (buffer-size) delta)))
1088 (goto-char (point-min))
1089 (if rmail-ignored-headers (rmail-clear-headers))
1090 (if rmail-message-filter (funcall rmail-message-filter))))
1091
1092(defun rmail-clear-headers ()
1093 (if (search-forward "\n\n" nil t)
1094 (save-restriction
1095 (narrow-to-region (point-min) (point))
1096 (let ((buffer-read-only nil))
1097 (while (let ((case-fold-search t))
1098 (goto-char (point-min))
1099 (re-search-forward rmail-ignored-headers nil t))
1100 (beginning-of-line)
1101 (delete-region (point)
1102 (progn (re-search-forward "\n[^ \t]")
1103 (forward-char -1)
1104 (point))))))))
1105
1106(defun rmail-toggle-header ()
1107 "Show original message header if pruned header currently shown, or vice versa."
1108 (interactive)
1109 (rmail-maybe-set-message-counters)
1110 (narrow-to-region (rmail-msgbeg rmail-current-message) (point-max))
1111 (let ((buffer-read-only nil))
1112 (goto-char (point-min))
1113 (forward-line 1)
1114 (if (= (following-char) ?1)
1115 (progn (delete-char 1)
1116 (insert ?0)
1117 (forward-line 1)
15a36ac5 1118 (let ((case-fold-search t))
c42722e3
RS
1119 (while (looking-at "Summary-Line:\\|Mail-From:")
1120 (forward-line 1)))
581d7e0b
RM
1121 (insert "*** EOOH ***\n")
1122 (forward-char -1)
1123 (search-forward "\n*** EOOH ***\n")
1124 (forward-line -1)
1125 (let ((temp (point)))
1126 (and (search-forward "\n\n" nil t)
1127 (delete-region temp (point))))
1128 (goto-char (point-min))
1129 (search-forward "\n*** EOOH ***\n")
1130 (narrow-to-region (point) (point-max)))
1131 (rmail-reformat-message (point-min) (point-max)))))
1132\f
1133;;;; *** Rmail Attributes and Keywords ***
1134
1135;; Make a string describing current message's attributes and keywords
1136;; and set it up as the name of a minor mode
1137;; so it will appear in the mode line.
1138(defun rmail-display-labels ()
1139 (let ((blurb "") (beg (point-min-marker)) (end (point-max-marker)))
1140 (save-excursion
1141 (unwind-protect
1142 (progn
1143 (widen)
1144 (goto-char (rmail-msgbeg rmail-current-message))
1145 (forward-line 1)
1146 (if (looking-at "[01],")
1147 (progn
1148 (narrow-to-region (point) (progn (end-of-line) (point)))
1149 ;; Truly valid BABYL format requires a space before each
1150 ;; attribute or keyword name. Put them in if missing.
1151 (let (buffer-read-only)
1152 (goto-char (point-min))
1153 (while (search-forward "," nil t)
1154 (or (looking-at "[ ,]") (eobp)
1155 (insert " "))))
1156 (goto-char (point-max))
1157 (if (search-backward ",," nil 'move)
1158 (progn
1159 (if (> (point) (1+ (point-min)))
1160 (setq blurb (buffer-substring (+ 1 (point-min)) (point))))
1161 (if (> (- (point-max) (point)) 2)
1162 (setq blurb
1163 (concat blurb
1164 ";"
1165 (buffer-substring (+ (point) 3)
1166 (1- (point-max)))))))))))
1167 ;; Note: we don't use save-restriction because that does not work right
1168 ;; if changes are made outside the saved restriction
1169 ;; before that restriction is restored.
1170 (narrow-to-region beg end)
1171 (set-marker beg nil)
1172 (set-marker end nil)))
1173 (while (string-match " +," blurb)
1174 (setq blurb (concat (substring blurb 0 (match-beginning 0)) ","
1175 (substring blurb (match-end 0)))))
1176 (while (string-match ", +" blurb)
1177 (setq blurb (concat (substring blurb 0 (match-beginning 0)) ","
1178 (substring blurb (match-end 0)))))
1179 (setq mode-line-process
1180 (concat " " rmail-current-message "/" rmail-total-messages
1181 blurb))))
1182
1183;; Turn an attribute of a message on or off according to STATE.
1184;; ATTR is the name of the attribute, as a string.
1185;; MSGNUM is message number to change; nil means current message.
1186(defun rmail-set-attribute (attr state &optional msgnum)
1187 (let ((omax (point-max-marker))
1188 (omin (point-min-marker))
1189 (buffer-read-only nil))
1190 (or msgnum (setq msgnum rmail-current-message))
708bfd4f
RS
1191 (if (> msgnum 0)
1192 (unwind-protect
1193 (save-excursion
1194 (widen)
1195 (goto-char (+ 3 (rmail-msgbeg msgnum)))
1196 (let ((curstate
1197 (not
1198 (null (search-backward (concat ", " attr ",")
1199 (prog1 (point) (end-of-line)) t)))))
1200 (or (eq curstate (not (not state)))
1201 (if curstate
1202 (delete-region (point) (1- (match-end 0)))
1203 (beginning-of-line)
1204 (forward-char 2)
1205 (insert " " attr ","))))
1206 (if (string= attr "deleted")
1207 (rmail-set-message-deleted-p msgnum state)))
1208 ;; Note: we don't use save-restriction because that does not work right
1209 ;; if changes are made outside the saved restriction
1210 ;; before that restriction is restored.
1211 (narrow-to-region omin omax)
1212 (set-marker omin nil)
1213 (set-marker omax nil)
1214 (if (= msgnum rmail-current-message)
1215 (rmail-display-labels))))))
581d7e0b
RM
1216
1217;; Return t if the attributes/keywords line of msg number MSG
1218;; contains a match for the regexp LABELS.
1219(defun rmail-message-labels-p (msg labels)
1220 (save-excursion
1221 (save-restriction
1222 (widen)
1223 (goto-char (rmail-msgbeg msg))
1224 (forward-char 3)
1225 (re-search-backward labels (prog1 (point) (end-of-line)) t))))
1226\f
1227;;;; *** Rmail Message Selection And Support ***
1228
1229(defun rmail-msgend (n)
1230 (marker-position (aref rmail-message-vector (1+ n))))
1231
1232(defun rmail-msgbeg (n)
1233 (marker-position (aref rmail-message-vector n)))
1234
1235(defun rmail-widen-to-current-msgbeg (function)
1236 "Call FUNCTION with point at start of internal data of current message.
1237Assumes that bounds were previously narrowed to display the message in Rmail.
1238The bounds are widened enough to move point where desired, then narrowed
1239again afterward.
1240
1241FUNCTION may not change the visible text of the message, but it may
1242change the invisible header text."
1243 (save-excursion
c462c964 1244 (let ((obeg (- (point-max) (point-min))))
581d7e0b
RM
1245 (unwind-protect
1246 (progn
1247 (narrow-to-region (rmail-msgbeg rmail-current-message)
1248 (point-max))
1249 (goto-char (point-min))
1250 (funcall function))
1251 ;; Note: we don't use save-restriction because that does not work right
1252 ;; if changes are made outside the saved restriction
1253 ;; before that restriction is restored.
1254 ;; Here we assume that changes made by FUNCTION
1255 ;; occur before the visible region of the message.
c462c964 1256 (narrow-to-region (- (point-max) obeg) (point-max))))))
581d7e0b
RM
1257
1258(defun rmail-forget-messages ()
1259 (unwind-protect
1260 (if (vectorp rmail-message-vector)
1261 (let* ((i 0)
1262 (v rmail-message-vector)
1263 (n (length v)))
1264 (while (< i n)
1265 (move-marker (aref v i) nil)
1266 (setq i (1+ i)))))
1267 (setq rmail-message-vector nil)
1268 (setq rmail-deleted-vector nil)))
1269
1270(defun rmail-maybe-set-message-counters ()
1271 (if (not (and rmail-deleted-vector
1272 rmail-message-vector
1273 rmail-current-message
1274 rmail-total-messages))
1275 (rmail-set-message-counters)))
1276
1277(defun rmail-count-new-messages (&optional nomsg)
1278 (let* ((case-fold-search nil)
1279 (total-messages 0)
1280 (messages-head nil)
1281 (deleted-head nil))
1282 (or nomsg (message "Counting new messages..."))
1283 (goto-char (point-max))
1284 ;; Put at the end of messages-head
1285 ;; the entry for message N+1, which marks
1286 ;; the end of message N. (N = number of messages).
1287 (search-backward "\n\^_")
1288 (forward-char 1)
1289 (setq messages-head (list (point-marker)))
1290 (rmail-set-message-counters-counter (point-min))
1291 (setq rmail-current-message (1+ rmail-total-messages))
1292 (setq rmail-total-messages
1293 (+ rmail-total-messages total-messages))
1294 (setq rmail-message-vector
1295 (vconcat rmail-message-vector (cdr messages-head)))
1296 (aset rmail-message-vector
1297 rmail-current-message (car messages-head))
1298 (setq rmail-deleted-vector
1299 (concat rmail-deleted-vector deleted-head))
1300 (setq rmail-summary-vector
1301 (vconcat rmail-summary-vector (make-vector total-messages nil)))
1302 (goto-char (point-min))
1303 (or nomsg (message "Counting new messages...done (%d)" total-messages))))
1304
1305(defun rmail-set-message-counters ()
1306 (rmail-forget-messages)
1307 (save-excursion
1308 (save-restriction
1309 (widen)
1310 (let* ((point-save (point))
1311 (total-messages 0)
1312 (messages-after-point)
1313 (case-fold-search nil)
1314 (messages-head nil)
1315 (deleted-head nil))
1316 (message "Counting messages...")
1317 (goto-char (point-max))
1318 ;; Put at the end of messages-head
1319 ;; the entry for message N+1, which marks
1320 ;; the end of message N. (N = number of messages).
cf805d5d
RS
1321 (search-backward "\n\^_" nil t)
1322 (if (/= (point) (point-max)) (forward-char 1))
581d7e0b
RM
1323 (setq messages-head (list (point-marker)))
1324 (rmail-set-message-counters-counter (min (point) point-save))
1325 (setq messages-after-point total-messages)
1326 (rmail-set-message-counters-counter)
1327 (setq rmail-total-messages total-messages)
1328 (setq rmail-current-message
1329 (min total-messages
1330 (max 1 (- total-messages messages-after-point))))
1331 (setq rmail-message-vector
1332 (apply 'vector (cons (point-min-marker) messages-head))
1333 rmail-deleted-vector (concat "D" deleted-head)
1334 rmail-summary-vector (make-vector rmail-total-messages nil))
1335 (message "Counting messages...done")))))
1336
1337(defun rmail-set-message-counters-counter (&optional stop)
1338 (while (search-backward "\n\^_\^L\n" stop t)
1339 (forward-char 1)
1340 (setq messages-head (cons (point-marker) messages-head))
1341 (save-excursion
1342 (setq deleted-head
1343 (cons (if (search-backward ", deleted,"
1344 (prog1 (point)
1345 (forward-line 2))
1346 t)
1347 ?D ?\ )
1348 deleted-head)))
1349 (if (zerop (% (setq total-messages (1+ total-messages)) 20))
1350 (message "Counting messages...%d" total-messages))))
1351
1352(defun rmail-beginning-of-message ()
1353 "Show current message starting from the beginning."
1354 (interactive)
1355 (rmail-show-message rmail-current-message))
1356
1357(defun rmail-show-message (&optional n)
bd1f0f84
RS
1358 "Show message number N (prefix argument), counting from start of file.
1359If summary buffer is currently displayed, update current message there also."
581d7e0b
RM
1360 (interactive "p")
1361 (rmail-maybe-set-message-counters)
1362 (widen)
1363 (if (zerop rmail-total-messages)
1364 (progn (narrow-to-region (point-min) (1- (point-max)))
1365 (goto-char (point-min))
1366 (setq mode-line-process nil))
1367 (let (blurb)
1368 (if (not n)
1369 (setq n rmail-current-message)
1370 (cond ((<= n 0)
1371 (setq n 1
1372 rmail-current-message 1
1373 blurb "No previous message"))
1374 ((> n rmail-total-messages)
1375 (setq n rmail-total-messages
1376 rmail-current-message rmail-total-messages
1377 blurb "No following message"))
1378 (t
1379 (setq rmail-current-message n))))
1380 (let ((beg (rmail-msgbeg n))
1381 (end (rmail-msgend n)))
1382 (goto-char beg)
1383 (forward-line 1)
1384 (if (= (following-char) ?0)
1385 (progn
1386 (rmail-reformat-message beg end)
1387 (rmail-set-attribute "unseen" nil))
1388 (search-forward "\n*** EOOH ***\n" end t)
1389 (narrow-to-region (point) end))
1390 (goto-char (point-min))
1391 (rmail-display-labels)
1392 (run-hooks 'rmail-show-message-hook)
bd1f0f84
RS
1393 ;; If there is a summary buffer, try to move to this message
1394 ;; in that buffer. But don't complain if this message
1395 ;; is not mentioned in the summary.
1396 (if (rmail-summary-exists)
1397 (let ((curr-msg rmail-current-message))
1398 (rmail-select-summary
1399 (rmail-summary-goto-msg curr-msg t t))))
581d7e0b
RM
1400 (if blurb
1401 (message blurb))))))
1402
1403(defun rmail-next-message (n)
1404 "Show following message whether deleted or not.
1405With prefix arg N, moves forward N messages, or backward if N is negative."
1406 (interactive "p")
1407 (rmail-maybe-set-message-counters)
1408 (rmail-show-message (+ rmail-current-message n)))
1409
1410(defun rmail-previous-message (n)
1411 "Show previous message whether deleted or not.
1412With prefix arg N, moves backward N messages, or forward if N is negative."
1413 (interactive "p")
1414 (rmail-next-message (- n)))
1415
1416(defun rmail-next-undeleted-message (n)
1417 "Show following non-deleted message.
1418With prefix arg N, moves forward N non-deleted messages,
c42722e3
RS
1419or backward if N is negative.
1420
1421Returns t if a new message is being shown, nil otherwise."
581d7e0b
RM
1422 (interactive "p")
1423 (rmail-maybe-set-message-counters)
1424 (let ((lastwin rmail-current-message)
1425 (current rmail-current-message))
1426 (while (and (> n 0) (< current rmail-total-messages))
1427 (setq current (1+ current))
1428 (if (not (rmail-message-deleted-p current))
1429 (setq lastwin current n (1- n))))
1430 (while (and (< n 0) (> current 1))
1431 (setq current (1- current))
1432 (if (not (rmail-message-deleted-p current))
1433 (setq lastwin current n (1+ n))))
1434 (if (/= lastwin rmail-current-message)
c42722e3
RS
1435 (progn (rmail-show-message lastwin)
1436 t)
1437 (if (< n 0)
1438 (message "No previous nondeleted message"))
1439 (if (> n 0)
1440 (message "No following nondeleted message"))
1441 nil)))
581d7e0b
RM
1442
1443(defun rmail-previous-undeleted-message (n)
1444 "Show previous non-deleted message.
1445With prefix argument N, moves backward N non-deleted messages,
1446or forward if N is negative."
1447 (interactive "p")
1448 (rmail-next-undeleted-message (- n)))
1449
1450(defun rmail-first-message ()
1451 "Show first message in file."
1452 (interactive)
1453 (rmail-maybe-set-message-counters)
1454 (rmail-show-message 1))
1455
1456(defun rmail-last-message ()
1457 "Show last message in file."
1458 (interactive)
1459 (rmail-maybe-set-message-counters)
1460 (rmail-show-message rmail-total-messages))
1461
1462(defun rmail-what-message ()
1463 (let ((where (point))
1464 (low 1)
1465 (high rmail-total-messages)
1466 (mid (/ rmail-total-messages 2)))
1467 (while (> (- high low) 1)
1468 (if (>= where (rmail-msgbeg mid))
1469 (setq low mid)
1470 (setq high mid))
1471 (setq mid (+ low (/ (- high low) 2))))
1472 (if (>= where (rmail-msgbeg high)) high low)))
1473
bd1f0f84
RS
1474(defun rmail-message-recipients-p (msg recipients &optional primary-only)
1475 (save-restriction
1476 (goto-char (rmail-msgbeg msg))
1477 (search-forward "\n*** EOOH ***\n")
1478 (narrow-to-region (point) (progn (search-forward "\n\n") (point)))
1479 (or (string-match recipients (or (mail-fetch-field "To") ""))
1480 (string-match recipients (or (mail-fetch-field "From") ""))
1481 (if (not primary-only)
1482 (string-match recipients (or (mail-fetch-field "Cc") ""))))))
1483
1484(defun rmail-message-regexp-p (msg regexp)
1485 "Return t, if for message number MSG, regexp REGEXP matches in the header."
1486 (goto-char (rmail-msgbeg msg))
1487 (let ((end
1488 (save-excursion
1489 (search-forward "*** EOOH ***" (point-max)) (point))))
1490 (re-search-forward regexp end t)))
1491
5201ddda
RS
1492(defun rmail-search-backward (regexp &optional n)
1493 "Show message containing next match for REGEXP.
1494Prefix argument gives repeat count; negative argument means search
1495backwards (through earlier messages).
1496Interactively, empty argument means use same regexp used last time."
1497 (interactive
1498 (let* ((reversep (>= (prefix-numeric-value current-prefix-arg) 0))
1499 (prompt
1500 (concat (if reversep "Reverse " "") "Rmail search (regexp): "))
1501 regexp)
1502 (if rmail-search-last-regexp
1503 (setq prompt (concat prompt
1504 "(default "
1505 rmail-search-last-regexp
1506 ") ")))
1507 (setq regexp (read-string prompt))
1508 (cond ((not (equal regexp ""))
1509 (setq rmail-search-last-regexp regexp))
1510 ((not rmail-search-last-regexp)
1511 (error "No previous Rmail search string")))
1512 (list rmail-search-last-regexp
1513 (prefix-numeric-value current-prefix-arg))))
1514 (rmail-search regexp (- n)))
1515
581d7e0b 1516(defvar rmail-search-last-regexp nil)
e91f80c4 1517(defun rmail-search (regexp &optional n)
581d7e0b 1518 "Show message containing next match for REGEXP.
e91f80c4
RS
1519Prefix argument gives repeat count; negative argument means search
1520backwards (through earlier messages).
1521Interactively, empty argument means use same regexp used last time."
581d7e0b
RM
1522 (interactive
1523 (let* ((reversep (< (prefix-numeric-value current-prefix-arg) 0))
1524 (prompt
1525 (concat (if reversep "Reverse " "") "Rmail search (regexp): "))
1526 regexp)
1527 (if rmail-search-last-regexp
1528 (setq prompt (concat prompt
1529 "(default "
1530 rmail-search-last-regexp
1531 ") ")))
1532 (setq regexp (read-string prompt))
1533 (cond ((not (equal regexp ""))
1534 (setq rmail-search-last-regexp regexp))
1535 ((not rmail-search-last-regexp)
1536 (error "No previous Rmail search string")))
e91f80c4
RS
1537 (list rmail-search-last-regexp
1538 (prefix-numeric-value current-prefix-arg))))
1539 (or n (setq n 1))
581d7e0b 1540 (message "%sRmail search for %s..."
df8a44dd 1541 (if (< n 0) "Reverse " "")
581d7e0b
RM
1542 regexp)
1543 (rmail-maybe-set-message-counters)
1544 (let ((omin (point-min))
1545 (omax (point-max))
1546 (opoint (point))
1547 win
e91f80c4 1548 (reversep (< n 0))
581d7e0b
RM
1549 (msg rmail-current-message))
1550 (unwind-protect
1551 (progn
1552 (widen)
e91f80c4
RS
1553 (while (/= n 0)
1554 ;; Check messages one by one, advancing message number up or down
1555 ;; but searching forward through each message.
1556 (if reversep
1557 (while (and (null win) (> msg 1))
1558 (goto-char (rmail-msgbeg (setq msg (1- msg))))
1559 (setq win (re-search-forward
1560 regexp (rmail-msgend msg) t)))
1561 (while (and (null win) (< msg rmail-total-messages))
1562 (goto-char (rmail-msgbeg (setq msg (1+ msg))))
1563 (setq win (re-search-forward regexp (rmail-msgend msg) t))))
df8a44dd 1564 (setq n (+ n (if reversep 1 -1)))))
581d7e0b
RM
1565 (if win
1566 (progn
1567 ;; If this is a reverse search and we found a message,
1568 ;; search backward thru this message to position point.
1569 (if reversep
1570 (progn
1571 (goto-char (rmail-msgend msg))
1572 (re-search-backward
1573 regexp (rmail-msgbeg msg) t)))
1574 (setq win (point))
1575 (rmail-show-message msg)
1576 (message "%sRmail search for %s...done"
1577 (if reversep "Reverse " "")
1578 regexp)
1579 (goto-char win))
1580 (goto-char opoint)
1581 (narrow-to-region omin omax)
1582 (ding)
1583 (message "Search failed: %s" regexp)))))
1584
e91f80c4
RS
1585(defun rmail-search-backwards (regexp &optional n)
1586 "Show message containing previous match for REGEXP.
1587Prefix argument gives repeat count; negative argument means search
1588forward (through later messages).
1589Interactively, empty argument means use same regexp used last time."
1590 (interactive
df8a44dd 1591 (let* ((reversep (>= (prefix-numeric-value current-prefix-arg) 0))
e91f80c4
RS
1592 (prompt
1593 (concat (if reversep "Reverse " "") "Rmail search (regexp): "))
1594 regexp)
1595 (if rmail-search-last-regexp
1596 (setq prompt (concat prompt
1597 "(default "
1598 rmail-search-last-regexp
1599 ") ")))
1600 (setq regexp (read-string prompt))
1601 (cond ((not (equal regexp ""))
1602 (setq rmail-search-last-regexp regexp))
1603 ((not rmail-search-last-regexp)
1604 (error "No previous Rmail search string")))
1605 (list rmail-search-last-regexp
1606 (prefix-numeric-value current-prefix-arg))))
1607 (rmail-search regexp (- (or n -1))))
1608
581d7e0b
RM
1609;; Show the first message which has the `unseen' attribute.
1610(defun rmail-first-unseen-message ()
117f4b92 1611 (rmail-maybe-set-message-counters)
581d7e0b
RM
1612 (let ((current 1)
1613 found)
1614 (save-restriction
1615 (widen)
1616 (while (and (not found) (< current rmail-total-messages))
581d7e0b 1617 (if (rmail-message-labels-p current ", ?\\(unseen\\),")
462c1094
RM
1618 (setq found current))
1619 (setq current (1+ current))))
e9c735fa
JA
1620;; Let the caller show the message.
1621;; (if found
1622;; (rmail-show-message found))
1623 found))
581d7e0b
RM
1624\f
1625;;;; *** Rmail Message Deletion Commands ***
1626
1627(defun rmail-message-deleted-p (n)
1628 (= (aref rmail-deleted-vector n) ?D))
1629
1630(defun rmail-set-message-deleted-p (n state)
1631 (aset rmail-deleted-vector n (if state ?D ?\ )))
1632
1633(defun rmail-delete-message ()
1634 "Delete this message and stay on it."
1635 (interactive)
1636 (rmail-set-attribute "deleted" t))
1637
1638(defun rmail-undelete-previous-message ()
1639 "Back up to deleted message, select it, and undelete it."
1640 (interactive)
1641 (let ((msg rmail-current-message))
1642 (while (and (> msg 0)
1643 (not (rmail-message-deleted-p msg)))
1644 (setq msg (1- msg)))
1645 (if (= msg 0)
1646 (error "No previous deleted message")
1647 (if (/= msg rmail-current-message)
1648 (rmail-show-message msg))
bd1f0f84
RS
1649 (rmail-set-attribute "deleted" nil)
1650 (if (rmail-summary-exists)
1651 (save-excursion
1652 (set-buffer rmail-summary-buffer)
1653 (rmail-summary-mark-undeleted msg)))
1654 (rmail-maybe-display-summary))))
581d7e0b
RM
1655
1656(defun rmail-delete-forward (&optional backward)
1657 "Delete this message and move to next nondeleted one.
1658Deleted messages stay in the file until the \\[rmail-expunge] command is given.
c42722e3
RS
1659With prefix argument, delete and move backward.
1660
1661Returns t if a new message is displayed after the delete, or nil otherwise."
581d7e0b
RM
1662 (interactive "P")
1663 (rmail-set-attribute "deleted" t)
bd1f0f84
RS
1664 (let ((del-msg rmail-current-message))
1665 (if (rmail-summary-exists)
1666 (save-excursion
1667 (set-buffer rmail-summary-buffer)
1668 (rmail-summary-mark-deleted del-msg)))
c42722e3
RS
1669 (prog1 (rmail-next-undeleted-message (if backward -1 1))
1670 (rmail-maybe-display-summary))))
581d7e0b
RM
1671
1672(defun rmail-delete-backward ()
1673 "Delete this message and move to previous nondeleted one.
1674Deleted messages stay in the file until the \\[rmail-expunge] command is given."
1675 (interactive)
1676 (rmail-delete-forward t))
1677
bd1f0f84 1678(defun rmail-only-expunge ()
581d7e0b
RM
1679 "Actually erase all deleted messages in the file."
1680 (interactive)
1681 (message "Expunging deleted messages...")
1682 ;; Discard all undo records for this buffer.
1683 (or (eq buffer-undo-list t)
1684 (setq buffer-undo-list nil))
1685 (rmail-maybe-set-message-counters)
1686 (let* ((omax (- (buffer-size) (point-max)))
1687 (omin (- (buffer-size) (point-min)))
1688 (opoint (if (and (> rmail-current-message 0)
1689 (= ?D (aref rmail-deleted-vector rmail-current-message)))
1690 0 (- (point) (point-min))))
1691 (messages-head (cons (aref rmail-message-vector 0) nil))
1692 (messages-tail messages-head)
1693 ;; Don't make any undo records for the expunging.
1694 (buffer-undo-list t)
1695 (win))
1696 (unwind-protect
1697 (save-excursion
1698 (widen)
1699 (goto-char (point-min))
1700 (let ((counter 0)
1701 (number 1)
1702 (total rmail-total-messages)
1703 (new-message-number rmail-current-message)
1704 (new-summary nil)
1705 (buffer-read-only nil)
1706 (messages rmail-message-vector)
1707 (deleted rmail-deleted-vector)
1708 (summary rmail-summary-vector))
1709 (setq rmail-total-messages nil
1710 rmail-current-message nil
1711 rmail-message-vector nil
1712 rmail-deleted-vector nil
1713 rmail-summary-vector nil)
1714 (while (<= number total)
1715 (if (= (aref deleted number) ?D)
1716 (progn
1717 (delete-region
1718 (marker-position (aref messages number))
1719 (marker-position (aref messages (1+ number))))
1720 (move-marker (aref messages number) nil)
1721 (if (> new-message-number counter)
1722 (setq new-message-number (1- new-message-number))))
1723 (setq counter (1+ counter))
1724 (setq messages-tail
1725 (setcdr messages-tail
1726 (cons (aref messages number) nil)))
1727 (setq new-summary
1728 (cons (if (= counter number) (aref summary (1- number)))
1729 new-summary)))
1730 (if (zerop (% (setq number (1+ number)) 20))
1731 (message "Expunging deleted messages...%d" number)))
1732 (setq messages-tail
1733 (setcdr messages-tail
1734 (cons (aref messages number) nil)))
1735 (setq rmail-current-message new-message-number
1736 rmail-total-messages counter
1737 rmail-message-vector (apply 'vector messages-head)
1738 rmail-deleted-vector (make-string (1+ counter) ?\ )
1739 rmail-summary-vector (vconcat (nreverse new-summary))
1740 win t)))
1741 (message "Expunging deleted messages...done")
1742 (if (not win)
1743 (narrow-to-region (- (buffer-size) omin) (- (buffer-size) omax)))
1744 (rmail-show-message
1745 (if (zerop rmail-current-message) 1 nil))
1746 (forward-char opoint))))
bd1f0f84
RS
1747
1748(defun rmail-expunge ()
1749 "Erase deleted messages from Rmail file and summary buffer."
1750 (interactive)
1751 (rmail-only-expunge)
1752 (if (rmail-summary-exists)
1753 (rmail-select-summary
1754 (rmail-update-summary))))
581d7e0b
RM
1755\f
1756;;;; *** Rmail Mailing Commands ***
1757
94ed51e8 1758(defun rmail-start-mail (&rest args)
c33e95d8 1759 (if (and window-system rmail-mail-new-frame)
b1d9bfa7 1760 (prog1
94ed51e8
RS
1761 (apply 'mail-other-frame args)
1762 (modify-frame-parameters (selected-frame)
1763 '((dedicated . t))))
1764 (apply 'mail-other-window args)))
1765
581d7e0b 1766(defun rmail-mail ()
bd1f0f84
RS
1767 "Send mail in another window.
1768While composing the message, use \\[mail-yank-original] to yank the
1769original message into it."
581d7e0b 1770 (interactive)
94ed51e8 1771 (rmail-start-mail nil nil nil nil nil (current-buffer)))
581d7e0b
RM
1772
1773(defun rmail-continue ()
1774 "Continue composing outgoing message previously being composed."
1775 (interactive)
94ed51e8 1776 (rmail-start-mail t))
581d7e0b
RM
1777
1778(defun rmail-reply (just-sender)
1779 "Reply to the current message.
1780Normally include CC: to all other recipients of original message;
1781prefix argument means ignore them. While composing the reply,
1782use \\[mail-yank-original] to yank the original message into it."
1783 (interactive "P")
1784 (let (from reply-to cc subject date to message-id resent-reply-to)
1785 (save-excursion
1786 (save-restriction
1787 (widen)
1788 (goto-char (rmail-msgbeg rmail-current-message))
1789 (forward-line 1)
1790 (if (= (following-char) ?0)
1791 (narrow-to-region
1792 (progn (forward-line 2)
1793 (point))
1794 (progn (search-forward "\n\n" (rmail-msgend rmail-current-message)
1795 'move)
1796 (point)))
1797 (narrow-to-region (point)
1798 (progn (search-forward "\n*** EOOH ***\n")
1799 (beginning-of-line) (point))))
1800 (setq resent-reply-to (mail-fetch-field "resent-reply-to" t)
1801 from (mail-fetch-field "from")
1802 reply-to (or resent-reply-to
1803 (mail-fetch-field "reply-to" nil t)
1804 from)
1805 cc (cond (just-sender nil)
1806 (resent-reply-to (mail-fetch-field "resent-cc" t))
1807 (t (mail-fetch-field "cc" nil t)))
1808 subject (or (and resent-reply-to
1809 (mail-fetch-field "resent-subject" t))
1810 (mail-fetch-field "subject"))
1f780b79
RS
1811 date (or (and resent-reply-to
1812 (mail-fetch-field "resent-date" t))
1813 (mail-fetch-field "date"))
581d7e0b 1814 to (cond (resent-reply-to
1f780b79 1815 (or (mail-fetch-field "resent-to" t)) "")
581d7e0b
RM
1816 ((mail-fetch-field "to" nil t))
1817 ;((mail-fetch-field "apparently-to")) ack gag barf
1818 (t ""))
1819 message-id (cond (resent-reply-to
1820 (mail-fetch-field "resent-message-id" t))
1821 ((mail-fetch-field "message-id"))))))
bd1f0f84
RS
1822 (and (stringp subject)
1823 (or (string-match (concat "\\`" (regexp-quote rmail-reply-prefix))
1824 subject)
1825 (setq subject (concat rmail-reply-prefix subject))))
94ed51e8 1826 (rmail-start-mail nil
581d7e0b
RM
1827 (mail-strip-quoted-names reply-to)
1828 subject
1829 (rmail-make-in-reply-to-field from date message-id)
1830 (if just-sender
1831 nil
1832 (let* ((cc-list (rmail-dont-reply-to
1833 (mail-strip-quoted-names
1834 (if (null cc) to (concat to ", " cc))))))
1835 (if (string= cc-list "") nil cc-list)))
1836 (current-buffer)
1837 (list (list '(lambda (buf msgnum)
1838 (save-excursion
1839 (set-buffer buf)
1840 (rmail-set-attribute "answered" t msgnum)))
1841 (current-buffer) rmail-current-message)))))
1842
1843(defun rmail-make-in-reply-to-field (from date message-id)
1844 (cond ((not from)
1845 (if message-id
1846 message-id
1847 nil))
1848 (mail-use-rfc822
1849 (require 'rfc822)
1850 (let ((tem (car (rfc822-addresses from))))
1851 (if message-id
1852 (if (string-match
1853 (regexp-quote (if (string-match "@[^@]*\\'" tem)
1854 (substring tem 0 (match-beginning 0))
1855 tem))
1856 message-id)
1857 ;; Message-ID is sufficiently informative
1858 message-id
1859 (concat message-id " (" tem ")"))
1de48e7f
RS
1860 ;; Copy TEM, discarding text properties.
1861 (setq tem (copy-sequence tem))
1862 (set-text-properties 0 (length tem) nil tem)
1863 (setq tem (copy-sequence tem))
1864 ;; Use prin1 to fake RFC822 quoting
1865 (let ((field (prin1-to-string tem)))
1866 (if date
1867 (concat field "'s message of " date)
1868 field)))))
581d7e0b
RM
1869 ((let* ((foo "[^][\000-\037\177-\377()<>@,;:\\\" ]+")
1870 (bar "[^][\000-\037\177-\377()<>@,;:\\\"]+"))
1871 ;; Can't use format because format loses on \000 (unix *^&%*^&%$!!)
1872 (or (string-match (concat "\\`[ \t]*\\(" bar
1873 "\\)\\(<" foo "@" foo ">\\)?[ \t]*\\'")
1874 ;; "Unix Loser <Foo@bar.edu>" => "Unix Loser"
1875 from)
1876 (string-match (concat "\\`[ \t]*<" foo "@" foo ">[ \t]*(\\("
1877 bar "\\))[ \t]*\\'")
1878 ;; "<Bugs@bar.edu>" (Losing Unix) => "Losing Unix"
1879 from)))
1880 (let ((start (match-beginning 1))
1881 (end (match-end 1)))
1882 ;; Trim whitespace which above regexp match allows
1883 (while (and (< start end)
1884 (memq (aref from start) '(?\t ?\ )))
1885 (setq start (1+ start)))
1886 (while (and (< start end)
1887 (memq (aref from (1- end)) '(?\t ?\ )))
1888 (setq end (1- end)))
1889 (let ((field (substring from start end)))
1890 (if date (setq field (concat "message from " field " on " date)))
1891 (if message-id
1892 ;; "<AA259@bar.edu> (message from Unix Loser on 1-Apr-89)"
1893 (concat message-id " (" field ")")
1894 field))))
1895 (t
1896 ;; If we can't kludge it simply, do it correctly
1897 (let ((mail-use-rfc822 t))
1898 (rmail-make-in-reply-to-field from date message-id)))))
1899
8159f4af
RS
1900(defun rmail-forward (resend)
1901 "Forward the current message to another user.
1902With prefix argument, \"resend\" the message instead of forwarding it;
1903see the documentation of `rmail-resend'."
1904 (interactive "P")
1905 (if resend
1906 (call-interactively 'rmail-resend)
1907 (let ((forward-buffer (current-buffer))
1908 (subject (concat "["
1909 (let ((from (or (mail-fetch-field "From")
1910 (mail-fetch-field ">From"))))
1911 (if from
1912 (concat (mail-strip-quoted-names from) ": ")
1913 ""))
1914 (or (mail-fetch-field "Subject") "")
1915 "]")))
65c200c5
RS
1916 ;; If only one window, use it for the mail buffer.
1917 ;; Otherwise, use another window for the mail buffer
1918 ;; so that the Rmail buffer remains visible
1919 ;; and sending the mail will get back to it.
1920 (if (funcall (if (and (not rmail-mail-new-frame) (one-window-p t))
1921 (function mail)
1922 (function rmail-start-mail))
1923 nil nil subject nil nil nil
1924 (list (list (function (lambda (buf msgnum)
1925 (save-excursion
1926 (set-buffer buf)
1927 (rmail-set-attribute
1928 "forwarded" t msgnum))))
1929 (current-buffer)
1930 rmail-current-message)))
b1d9bfa7 1931 (save-excursion
0f0a85b3 1932 ;; Insert after header separator--before signature if any.
760a3528
BF
1933 (goto-char (point-min))
1934 (search-forward-regexp
1935 (concat "^" (regexp-quote mail-header-separator)))
b1d9bfa7 1936 (forward-line 1)
65c200c5 1937 (insert-buffer forward-buffer))))))
581d7e0b
RM
1938
1939(defun rmail-resend (address &optional from comment mail-alias-file)
1940 "Resend current message to ADDRESSES.
d2fc297c 1941ADDRESSES should be a single address, a string consisting of several
581d7e0b
RM
1942addresses separated by commas, or a list of addresses.
1943
1944Optional FROM is the address to resend the message from, and
1945defaults to the username of the person redistributing the message.
1946Optional COMMENT is a string that will be inserted as a comment in the
1947resent message.
1948Optional ALIAS-FILE is alternate aliases file to be used by sendmail,
1949typically for purposes of moderating a list."
1950 (interactive "sResend to: ")
9ad8712e
RS
1951 (require 'sendmail)
1952 (require 'mailalias)
581d7e0b
RM
1953 (if (not from) (setq from (user-login-name)))
1954 (let ((tembuf (generate-new-buffer " sendmail temp"))
1955 (mail-header-separator "")
1956 (case-fold-search nil)
1957 (mailbuf (current-buffer)))
1958 (unwind-protect
1959 (save-excursion
1960 ;;>> Copy message into temp buffer
1961 (set-buffer tembuf)
1962 (insert-buffer-substring mailbuf)
1963 (goto-char (point-min))
6961bfbf 1964 ;; Delete any Sender field, since that's not specifyable.
d2fc297c
RS
1965 ; Only delete Sender fields in the actual header.
1966 (re-search-forward "^$" nil 'move)
1967 ; Using "while" here rather than "if" because some buggy mail
1968 ; software may have inserted multiple Sender fields.
1969 (while (re-search-backward "^Sender:" nil t)
1970 (let (beg)
1971 (setq beg (point))
1972 (forward-line 1)
1973 (while (looking-at "[ \t]")
1974 (forward-line 1))
1975 (delete-region beg (point))))
1976 ; Go back to the beginning of the buffer so the Resent- fields
1977 ; are inserted there.
1978 (goto-char (point-min))
581d7e0b
RM
1979 ;;>> Insert resent-from:
1980 (insert "Resent-From: " from "\n")
bcf12025 1981 (insert "Resent-Date: " (mail-rfc822-date) "\n")
581d7e0b
RM
1982 ;;>> Insert resent-to: and bcc if need be.
1983 (let ((before (point)))
c42722e3
RS
1984 (if mail-self-blind
1985 (insert "Resent-Bcc: " (user-login-name) "\n"))
581d7e0b
RM
1986 (insert "Resent-To: " (if (stringp address)
1987 address
1988 (mapconcat 'identity address ",\n\t"))
1989 "\n")
1990 (expand-mail-aliases before (point)))
1991 ;;>> Set up comment, if any.
1992 (if (and (sequencep comment) (not (zerop (length comment))))
1993 (let ((before (point))
1994 after)
1995 (insert comment)
1996 (or (eolp) (insert "\n"))
1997 (setq after (point))
1998 (goto-char before)
1999 (while (< (point) after)
2000 (insert "Resent-Comment: ")
2001 (forward-line 1))))
2002 ;; Don't expand aliases in the destination fields
2003 ;; of the original message.
2004 (let (mail-aliases)
389e8f11 2005 (funcall send-mail-function)))
8159f4af
RS
2006 (kill-buffer tembuf))
2007 (rmail-set-attribute "resent" t rmail-current-message)))
581d7e0b 2008
72e609d0 2009(defvar mail-unsent-separator
f2da0c68
RS
2010 (concat "^ *---+ +Unsent message follows +---+ *$\\|"
2011 "^ *---+ +Returned message +---+ *$\\|"
db32c193 2012 "^ *---+ +Original message +---+ *$\\|"
487fcdc0 2013 "^ *--+ +begin message +--+ *$\\|"
c42722e3 2014 "^ *---+ +Original message follows +---+ *$\\|"
db32c193 2015 "^|? *---+ +Message text follows: +---+ *|?$"))
581d7e0b
RM
2016
2017(defun rmail-retry-failure ()
2018 "Edit a mail message which is based on the contents of the current message.
2019For a message rejected by the mail system, extract the interesting headers and
d2fc297c 2020the body of the original message."
581d7e0b
RM
2021 (interactive)
2022 (require 'mail-utils)
2023 (let (to subj irp2 cc orig-message)
2024 (save-excursion
2025 ;; Narrow down to just the quoted original message
2026 (rmail-beginning-of-message)
f2da0c68
RS
2027 (let ((case-fold-search t))
2028 (or (re-search-forward mail-unsent-separator nil t)
2029 (error "Cannot parse this as a failure message")))
581d7e0b
RM
2030 (save-restriction
2031 (narrow-to-region (point) (point-max))
2032 ;; Now mail-fetch-field will get from headers of the original message,
2033 ;; not from the headers of the rejection.
2034 (setq to (mail-fetch-field "To")
2035 subj (mail-fetch-field "Subject")
2036 irp2 (mail-fetch-field "In-reply-to")
2037 cc (mail-fetch-field "Cc"))
2038 ;; Get the entire text (not headers) of the original message.
2039 (setq orig-message
2040 (buffer-substring
2041 (progn (search-forward "\n\n") (point))
2042 (point-max)))))
2043 ;; Start sending a new message; default header fields from the original.
854c16c5
RS
2044 ;; Turn off the usual actions for initializing the message body
2045 ;; because we want to get only the text from the failure message.
b30b6e28
RS
2046 (let (mail-signature
2047 (mail-setup-hook rmail-retry-setup-hook))
94ed51e8 2048 (if (rmail-start-mail nil to subj irp2 cc (current-buffer))
854c16c5
RS
2049 ;; Insert original text as initial text of new draft message.
2050 (progn
2051 (goto-char (point-max))
2052 (insert orig-message)
2053 (goto-char (point-min))
2054 (end-of-line))))))
bd1f0f84
RS
2055
2056(defun rmail-bury ()
2057 "Bury current Rmail buffer and its summary buffer."
2058 (interactive)
cf805d5d
RS
2059 ;; This let var was called rmail-buffer, but that interfered
2060 ;; with the buffer-local var used in summary buffers.
2061 (let ((buffer-to-bury (current-buffer)))
bd1f0f84
RS
2062 (if (rmail-summary-exists)
2063 (let (window)
2064 (while (setq window (get-buffer-window rmail-summary-buffer))
b73e2d84 2065 (set-window-buffer window (other-buffer rmail-summary-buffer)))
bd1f0f84
RS
2066 (bury-buffer rmail-summary-buffer)))
2067 (switch-to-buffer (other-buffer (current-buffer)))
cf805d5d 2068 (bury-buffer buffer-to-bury)))
bd1f0f84
RS
2069
2070(defun rmail-summary-exists ()
2071 "Non-nil iff in an RMAIL buffer and an associated summary buffer exists.
90254bb0 2072In fact, the non-nil value returned is the summary buffer itself."
bd1f0f84
RS
2073 (and rmail-summary-buffer (buffer-name rmail-summary-buffer)
2074 rmail-summary-buffer))
2075
2076(defun rmail-summary-displayed ()
2077 "t iff in RMAIL buffer and an associated summary buffer is displayed."
2078 (and rmail-summary-buffer (get-buffer-window rmail-summary-buffer)))
2079
2080(defvar rmail-redisplay-summary nil
2081 "*Non-nil means Rmail should show the summary when it changes.
2082This has an effect only if a summary buffer exists.")
2083
90254bb0
RS
2084(defvar rmail-summary-window-size nil
2085 "*Non-nil means specify the height for an Rmail summary window.")
2086
bd1f0f84
RS
2087;; Put the summary buffer back on the screen, if user wants that.
2088(defun rmail-maybe-display-summary ()
90254bb0
RS
2089 (let ((selected (selected-window))
2090 window)
2091 ;; If requested, make sure the summary is displayed.
2092 (and rmail-summary-buffer (buffer-name rmail-summary-buffer)
2093 rmail-redisplay-summary
2094 (display-buffer rmail-summary-buffer))
2095 ;; If requested, set the height of the summary window.
2096 (and rmail-summary-buffer (buffer-name rmail-summary-buffer)
2097 rmail-summary-window-size
2098 (setq window (get-buffer-window rmail-summary-buffer))
2099 (unwind-protect
2100 (progn
2101 (select-window window)
2102 (enlarge-window (- rmail-summary-window-size
2103 (window-height))))
2104 (select-window selected)))))
581d7e0b
RM
2105\f
2106;;;; *** Rmail Specify Inbox Files ***
2107
2108(autoload 'set-rmail-inbox-list "rmailmsc"
2109 "Set the inbox list of the current RMAIL file to FILE-NAME.
2110This may be a list of file names separated by commas.
2111If FILE-NAME is empty, remove any inbox list."
2112 t)
2113
2114;;;; *** Rmail Commands for Labels ***
2115
2116(autoload 'rmail-add-label "rmailkwd"
2117 "Add LABEL to labels associated with current RMAIL message.
2118Completion is performed over known labels when reading."
2119 t)
2120
2121(autoload 'rmail-kill-label "rmailkwd"
2122 "Remove LABEL from labels associated with current RMAIL message.
2123Completion is performed over known labels when reading."
2124 t)
2125
2126(autoload 'rmail-next-labeled-message "rmailkwd"
2127 "Show next message with LABEL. Defaults to last label used.
2128With prefix argument N moves forward N messages with this label."
2129 t)
2130
2131(autoload 'rmail-previous-labeled-message "rmailkwd"
2132 "Show previous message with LABEL. Defaults to last label used.
2133With prefix argument N moves backward N messages with this label."
2134 t)
2135
bd1f0f84
RS
2136(autoload 'rmail-read-label "rmailkwd"
2137 "PROMPT and read with completion an Rmail message label."
2138 t)
2139
581d7e0b
RM
2140;;;; *** Rmail Edit Mode ***
2141
2142(autoload 'rmail-edit-current-message "rmailedit"
2143 "Edit the contents of the current message"
2144 t)
3bf526cf
RS
2145
2146;;;; *** Rmail Sorting ***
2147
2148(autoload 'rmail-sort-by-date "rmailsort"
2149 "Sort messages of current Rmail file by date.
2150If prefix argument REVERSE is non-nil, sort them in reverse order." t)
2151
2152(autoload 'rmail-sort-by-subject "rmailsort"
2153 "Sort messages of current Rmail file by subject.
2154If prefix argument REVERSE is non-nil, sort them in reverse order." t)
2155
2156(autoload 'rmail-sort-by-author "rmailsort"
2157 "Sort messages of current Rmail file by author.
2158If prefix argument REVERSE is non-nil, sort them in reverse order." t)
2159
2160(autoload 'rmail-sort-by-recipient "rmailsort"
2161 "Sort messages of current Rmail file by recipient.
2162If prefix argument REVERSE is non-nil, sort them in reverse order." t)
2163
2164(autoload 'rmail-sort-by-correspondent "rmailsort"
2165 "Sort messages of current Rmail file by other correspondent.
2166If prefix argument REVERSE is non-nil, sort them in reverse order." t)
2167
2168(autoload 'rmail-sort-by-lines "rmailsort"
2169 "Sort messages of current Rmail file by number of lines.
2170If prefix argument REVERSE is non-nil, sort them in reverse order." t)
9ae6d54a
KH
2171
2172(autoload 'rmail-sort-by-keywords "rmailsort"
2173 "Sort messages of current Rmail file by labels.
2174If prefix argument REVERSE is non-nil, sort them in reverse order.
2175KEYWORDS is a comma-separated list of labels." t)
581d7e0b
RM
2176\f
2177;;;; *** Rmail Summary Mode ***
2178
2179(autoload 'rmail-summary "rmailsum"
2180 "Display a summary of all messages, one line per message."
2181 t)
2182
2183(autoload 'rmail-summary-by-labels "rmailsum"
2184 "Display a summary of all messages with one or more LABELS.
2185LABELS should be a string containing the desired labels, separated by commas."
2186 t)
2187
2188(autoload 'rmail-summary-by-recipients "rmailsum"
2189 "Display a summary of all messages with the given RECIPIENTS.
2190Normally checks the To, From and Cc fields of headers; but if PRIMARY-ONLY
2191is non-nil (prefix arg given), only look in the To and From fields.
bd1f0f84
RS
2192RECIPIENTS is a string of regexps separated by commas."
2193 t)
2194
2195(autoload 'rmail-summary-by-regexp "rmailsum"
2196 "Display a summary of all messages according to regexp REGEXP.
2197If the regular expression is found in the header of the message
2198\(including in the date and other lines, as well as the subject line),
2199Emacs will list the header line in the RMAIL-summary."
2200 t)
2201
2202(autoload 'rmail-summary-by-topic "rmailsum"
2203 "Display a summary of all messages with the given SUBJECT.
2204Normally checks the Subject field of headers;
2205but if WHOLE-MESSAGE is non-nil (prefix arg given),
2206 look in the whole message.
2207SUBJECT is a string of regexps separated by commas."
581d7e0b
RM
2208 t)
2209\f
2210;;;; *** Rmail output messages to files ***
2211
2212(autoload 'rmail-output-to-rmail-file "rmailout"
2213 "Append the current message to an Rmail file named FILE-NAME.
2214If the file does not exist, ask if it should be created.
2215If file is being visited, the message is appended to the Emacs
2216buffer visiting that file."
2217 t)
2218
2219(autoload 'rmail-output "rmailout"
2220 "Append this message to Unix mail file named FILE-NAME."
2221 t)
2222
4139208e
RS
2223(autoload 'rmail-output-menu "rmailout"
2224 "Output current message to another Rmail file, chosen with a menu."
2225 t)
2226
581d7e0b
RM
2227;;;; *** Rmail undigestification ***
2228
2229(autoload 'undigestify-rmail-message "undigest"
2230 "Break up a digest message into its constituent messages.
2231Leaves original message, deleted, before the undigestified messages."
2232 t)
49116ac0
JB
2233
2234(provide 'rmail)
2235
c88ab9ce 2236;;; rmail.el ends here