comparison lisp/mh-e/mh-e.el @ 0:376386a54a3c r19-14

Import from CVS: tag r19-14
author cvs
date Mon, 13 Aug 2007 08:45:50 +0200
parents
children 131b0175ea99
comparison
equal deleted inserted replaced
-1:000000000000 0:376386a54a3c
1 ;;; mh-e.el --- GNU Emacs interface to the MH mail system
2
3 ;;; Copyright (C) 1985,86,87,88,90,92,93,94,95 Free Software Foundation, Inc.
4
5 (defconst mh-e-time-stamp "Time-stamp: <95/10/30 19:14:06 gildea>")
6 (defconst mh-e-version "5.0.2"
7 "Version numbers of this version of mh-e.")
8
9 ;; Maintainer: Stephen Gildea <gildea@lcs.mit.edu>
10 ;; Version: 5.0.2
11 ;; Keywords: mail
12 ;; Bug-reports: include `M-x mh-version' output in any correspondence
13
14 ;; This file is part of mh-e, part of GNU Emacs.
15
16 ;; GNU Emacs is free software; you can redistribute it and/or modify
17 ;; it under the terms of the GNU General Public License as published by
18 ;; the Free Software Foundation; either version 2, or (at your option)
19 ;; any later version.
20
21 ;; GNU Emacs is distributed in the hope that it will be useful,
22 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
23 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 ;; GNU General Public License for more details.
25
26 ;; You should have received a copy of the GNU General Public License
27 ;; along with GNU Emacs; see the file COPYING. If not, write to
28 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
29
30 ;;; Commentary:
31
32 ;;; HOW TO USE:
33 ;;; M-x mh-rmail to read mail. Type C-h m there for a list of commands.
34 ;;; C-u M-x mh-rmail to visit any folder.
35 ;;; M-x mh-smail to send mail. From within the mail reader, "m" works, too.
36
37 ;;; MH (Message Handler) is a powerful mail reader. The MH newsgroup
38 ;;; is comp.mail.mh; the mailing list is mh-users@ics.uci.edu (send to
39 ;;; mh-users-request to be added). See the monthly Frequently Asked
40 ;;; Questions posting there for information on getting MH and mh-e.
41
42 ;;; mh-e is an Emacs interface to the MH mail system.
43 ;;; The mailing list mh-e@x.org is for discussion of mh-e and
44 ;;; announcements of new versions. Send a "subscribe" message to
45 ;;; mh-e-request@x.org to be added. Do not report bugs here; mail
46 ;;; them directly to the author (see top of mh-e.el source).
47 ;;; Include the output of M-x mh-version in any bug report.
48
49 ;;; mh-e works with GNU Emacs 18 or 19, and MH 6.
50
51 ;;; NB. MH must have been compiled with the MHE compiler flag or several
52 ;;; features necessary for mh-e will be missing from MH commands, specifically
53 ;;; the -build switch to repl and forw.
54
55 ;;; Your .emacs might benefit from these bindings:
56 ;;; (global-set-key "\C-cr" 'mh-rmail)
57 ;;; (global-set-key "\C-xm" 'mh-smail)
58 ;;; (global-set-key "\C-x4m" 'mh-smail-other-window)
59
60 ;;; Change Log:
61
62 ;;; Original version for Gosling emacs by Brian Reid, Stanford, 1982.
63 ;;; Modified by James Larus, BBN, July 1984 and UCB, 1984 & 1985.
64 ;;; Rewritten for GNU Emacs, James Larus 1985. larus@ginger.berkeley.edu
65 ;;; Modified by Stephen Gildea 1988. gildea@lcs.mit.edu
66 (defconst mh-e-RCS-id "$Id: mh-e.el,v 1.1.1.1 1996/12/18 03:34:37 steve Exp $")
67
68 ;;; Code:
69
70 (provide 'mh-e)
71 (require 'mh-utils)
72
73
74 ;;; Hooks:
75
76 (defvar mh-folder-mode-hook nil
77 "Invoked in MH-Folder mode on a new folder.")
78
79 (defvar mh-inc-folder-hook nil
80 "Invoked by \\<mh-folder-mode-map>`\\[mh-inc-folder]' after incorporating mail into a folder.")
81
82 (defvar mh-show-hook nil
83 "Invoked after \\<mh-folder-mode-map>`\\[mh-show]' shows a message.")
84
85 (defvar mh-show-mode-hook nil
86 "Invoked in MH-Show mode on each message.")
87
88 (defvar mh-delete-msg-hook nil
89 "Invoked after marking each message for deletion.")
90
91 (defvar mh-refile-msg-hook nil
92 "Invoked after marking each message for refiling.")
93
94 (defvar mh-before-quit-hook nil
95 "Invoked by \\<mh-folder-mode-map>`\\[mh-quit]' before quitting mh-e. See also mh-quit-hook.")
96
97 (defvar mh-quit-hook nil
98 "Invoked after \\<mh-folder-mode-map>`\\[mh-quit]' quits mh-e. See also mh-before-quit-hook.")
99
100
101
102 ;;; Personal preferences:
103
104 (defvar mh-lpr-command-format "lpr -J '%s'"
105 "*Format for Unix command that prints a message.
106 The string should be a Unix command line, with the string '%s' where
107 the job's name (folder and message number) should appear. The formatted
108 message text is piped to this command when you type \\<mh-folder-mode-map>`\\[mh-print-msg]'.")
109
110 (defvar mh-scan-prog "scan"
111 "*Program to run to generate one-line-per-message listing of a folder.
112 Normally \"scan\" or a file name linked to scan. This file is searched
113 for relative to the mh-progs directory unless it is an absolute pathname.
114 Automatically becomes buffer-local when set in any fashion.")
115 (make-variable-buffer-local 'mh-scan-prog)
116
117 (defvar mh-inc-prog "inc"
118 "*Program to run to incorporate new mail into a folder.
119 Normally \"inc\". This file is searched for relative to
120 the mh-progs directory unless it is an absolute pathname.")
121
122 (defvar mh-print-background nil
123 "*Print messages in the background if non-nil.
124 WARNING: do not delete the messages until printing is finished;
125 otherwise, your output may be truncated.")
126
127 (defvar mh-recenter-summary-p nil
128 "*Recenter summary window when the show window is toggled off if non-nil.")
129
130 (defvar mh-do-not-confirm nil
131 "*Non-nil means do not prompt for confirmation before some mh-e commands.
132 Affects non-recoverable commands such as mh-kill-folder and mh-undo-folder.")
133
134 (defvar mh-store-default-directory nil
135 "*Last directory used by \\[mh-store-msg]; default for next store.
136 A directory name string, or nil to use current directory.")
137
138 ;;; Parameterize mh-e to work with different scan formats. The defaults work
139 ;;; with the standard MH scan listings, in which the first 4 characters on
140 ;;; the line are the message number, followed by two places for notations.
141
142 (defvar mh-good-msg-regexp "^....[^D^]"
143 "Regexp specifiying the scan lines that are 'good' messages.")
144
145 (defvar mh-deleted-msg-regexp "^....D"
146 "Regexp matching scan lines of deleted messages.")
147
148 (defvar mh-refiled-msg-regexp "^....\\^"
149 "Regexp matching scan lines of refiled messages.")
150
151 (defvar mh-valid-scan-line "^ *[0-9]"
152 "Regexp matching scan lines for messages (not error messages).")
153
154 (defvar mh-cur-scan-msg-regexp "^....\\+"
155 "Regexp matching scan line for the cur message.")
156
157 (defvar mh-note-deleted "D"
158 "String whose first character is used to notate deleted messages.")
159
160 (defvar mh-note-refiled "^"
161 "String whose first character is used to notate refiled messages.")
162
163 (defvar mh-note-cur "+"
164 "String whose first character is used to notate the current message.")
165
166 (defvar mh-partial-folder-mode-line-annotation "select"
167 "Annotation when displaying part of a folder.
168 The string is displayed after the folder's name. NIL for no annotation.")
169
170
171 ;;; Internal variables:
172
173 (defvar mh-last-destination nil) ;Destination of last refile or write command.
174
175 (defvar mh-folder-mode-map (make-keymap)
176 "Keymap for MH folders.")
177
178 (defvar mh-delete-list nil) ;List of msg numbers to delete.
179
180 (defvar mh-refile-list nil) ;List of folder names in mh-seq-list.
181
182 (defvar mh-next-direction 'forward) ;Direction to move to next message.
183
184 (defvar mh-narrowed-to-seq nil) ;Sequence display is narrowed to or nil if not narrowed.
185
186 (defvar mh-first-msg-num nil) ;Number of first msg in buffer.
187
188 (defvar mh-last-msg-num nil) ;Number of last msg in buffer.
189
190 (defvar mh-mode-line-annotation nil) ;Indiction this is not the full folder.
191
192 ;;; Macros and generic functions:
193
194 (defun mh-mapc (func list)
195 (while list
196 (funcall func (car list))
197 (setq list (cdr list))))
198
199
200
201 ;;; Entry points:
202
203 ;;;###autoload
204 (defun mh-rmail (&optional arg)
205 "Inc(orporate) new mail with MH, or, with arg, scan an MH mail folder.
206 This function is an entry point to mh-e, the Emacs front end
207 to the MH mail system."
208 (interactive "P")
209 (mh-find-path)
210 (if arg
211 (call-interactively 'mh-visit-folder)
212 (mh-inc-folder)))
213
214
215 ;;; mh-smail and mh-smail-other-window have been moved to the new file
216 ;;; mh-comp.el, but Emacs 18 still looks for them here, so provide a
217 ;;; definition here, too, for a while.
218
219 (defun mh-smail ()
220 "Compose and send mail with the MH mail system.
221 This function is an entry point to mh-e, the Emacs front end
222 to the MH mail system."
223 (interactive)
224 (mh-find-path)
225 (require 'mh-comp)
226 (call-interactively 'mh-send))
227
228
229 (defun mh-smail-other-window ()
230 "Compose and send mail in other window with the MH mail system.
231 This function is an entry point to mh-e, the Emacs front end
232 to the MH mail system."
233 (interactive)
234 (mh-find-path)
235 (require 'mh-comp)
236 (call-interactively 'mh-send-other-window))
237
238
239
240 ;;; User executable mh-e commands:
241
242
243 (defun mh-delete-msg (msg-or-seq)
244 "Mark the specified MESSAGE(s) for subsequent deletion and move to the next.
245 Default is the displayed message. If optional prefix argument is
246 given then prompt for the message sequence."
247 (interactive (list (if current-prefix-arg
248 (mh-read-seq-default "Delete" t)
249 (mh-get-msg-num t))))
250 (mh-delete-msg-no-motion msg-or-seq)
251 (mh-next-msg))
252
253
254 (defun mh-delete-msg-no-motion (msg-or-seq)
255 "Mark the specified MESSAGE(s) for subsequent deletion.
256 Default is the displayed message. If optional prefix argument is
257 provided, then prompt for the message sequence."
258 (interactive (list (if current-prefix-arg
259 (mh-read-seq-default "Delete" t)
260 (mh-get-msg-num t))))
261 (if (numberp msg-or-seq)
262 (mh-delete-a-msg msg-or-seq)
263 (mh-map-to-seq-msgs 'mh-delete-a-msg msg-or-seq)))
264
265
266 (defun mh-execute-commands ()
267 "Process outstanding delete and refile requests."
268 (interactive)
269 (if mh-narrowed-to-seq (mh-widen))
270 (mh-process-commands mh-current-folder)
271 (mh-set-scan-mode)
272 (mh-goto-cur-msg) ; after mh-set-scan-mode for efficiency
273 (mh-make-folder-mode-line)
274 t) ; return t for [local-]write-file-hooks
275
276
277 (defun mh-first-msg ()
278 "Move to the first message."
279 (interactive)
280 (goto-char (point-min))
281 (while (and (not (eobp)) (not (looking-at mh-valid-scan-line)))
282 (forward-line 1)))
283
284
285 (defun mh-header-display ()
286 "Show the current message with all its headers.
287 Displays headers that might have been suppressed by setting the
288 variables `mh-clean-message-header' or `mhl-formfile', or by the fallback
289 behavior of scrolling uninteresting headers off the top of the window.
290 Type \"\\[mh-show]\" to show the message normally again."
291 (interactive)
292 (and (not mh-showing-with-headers)
293 (or mhl-formfile mh-clean-message-header)
294 (mh-invalidate-show-buffer))
295 (let ((mhl-formfile nil)
296 (mh-clean-message-header nil))
297 (mh-show-msg nil)
298 (mh-in-show-buffer (mh-show-buffer)
299 (goto-char (point-min))
300 (mh-recenter 0))
301 (setq mh-showing-with-headers t)))
302
303
304 (defun mh-inc-folder (&optional maildrop-name)
305 "Inc(orporate)s new mail into the Inbox folder.
306 Optional prefix argument specifies an alternate maildrop from the default.
307 If the prefix argument is given, incorporates mail into the current
308 folder, otherwise uses the folder named by `mh-inbox'.
309 Runs `mh-inc-folder-hook' after incorporating new mail.
310 Do not call this function from outside mh-e; use \\[mh-rmail] instead."
311 (interactive (list (if current-prefix-arg
312 (expand-file-name
313 (read-file-name "inc mail from file: "
314 mh-user-path)))))
315 (let ((config (current-window-configuration)))
316 (if (not maildrop-name)
317 (cond ((not (get-buffer mh-inbox))
318 (mh-make-folder mh-inbox)
319 (setq mh-previous-window-config config))
320 ((not (eq (current-buffer) (get-buffer mh-inbox)))
321 (switch-to-buffer mh-inbox)
322 (setq mh-previous-window-config config)))))
323 (mh-get-new-mail maildrop-name)
324 (run-hooks 'mh-inc-folder-hook))
325
326
327 (defun mh-last-msg ()
328 "Move to the last message."
329 (interactive)
330 (goto-char (point-max))
331 (while (and (not (bobp)) (looking-at "^$"))
332 (forward-line -1)))
333
334
335 (defun mh-next-undeleted-msg (&optional arg)
336 "Move to the NTH next undeleted message in window."
337 (interactive "p")
338 (setq mh-next-direction 'forward)
339 (forward-line 1)
340 (cond ((re-search-forward mh-good-msg-regexp nil 0 arg)
341 (beginning-of-line)
342 (mh-maybe-show))
343 (t
344 (forward-line -1)
345 (if (get-buffer mh-show-buffer)
346 (delete-windows-on mh-show-buffer)))))
347
348
349 (defun mh-refile-msg (msg-or-seq folder)
350 "Refile MESSAGE(s) (default: displayed message) into FOLDER.
351 If optional prefix argument provided, then prompt for message sequence."
352 (interactive
353 (list (if current-prefix-arg
354 (mh-read-seq-default "Refile" t)
355 (mh-get-msg-num t))
356 (intern
357 (mh-prompt-for-folder
358 "Destination"
359 (or (and mh-default-folder-for-message-function
360 (let ((refile-file (mh-msg-filename (mh-get-msg-num t))))
361 (save-excursion
362 (set-buffer (get-buffer-create mh-temp-buffer))
363 (erase-buffer)
364 (insert-file-contents refile-file)
365 (let ((buffer-file-name refile-file))
366 (funcall mh-default-folder-for-message-function)))))
367 (and (eq 'refile (car mh-last-destination))
368 (symbol-name (cdr mh-last-destination)))
369 "")
370 t))))
371 (setq mh-last-destination (cons 'refile folder))
372 (if (numberp msg-or-seq)
373 (mh-refile-a-msg msg-or-seq folder)
374 (mh-map-to-seq-msgs 'mh-refile-a-msg msg-or-seq folder))
375 (mh-next-msg))
376
377
378 (defun mh-refile-or-write-again (message)
379 "Re-execute the last refile or write command on the given MESSAGE.
380 Default is the displayed message. Use the same folder or file as the
381 previous refile or write command."
382 (interactive (list (mh-get-msg-num t)))
383 (if (null mh-last-destination)
384 (error "No previous refile or write"))
385 (cond ((eq (car mh-last-destination) 'refile)
386 (mh-refile-a-msg message (cdr mh-last-destination))
387 (message "Destination folder: %s" (cdr mh-last-destination)))
388 (t
389 (apply 'mh-write-msg-to-file message (cdr mh-last-destination))
390 (message "Destination: %s" (cdr mh-last-destination))))
391 (mh-next-msg))
392
393
394 (defun mh-quit ()
395 "Quit the current mh-e folder.
396 Start by running mh-before-quit-hook. Restore the previous window
397 configuration, if one exists. Finish by running mh-quit-hook."
398 (interactive)
399 (run-hooks 'mh-before-quit-hook)
400 (mh-update-sequences)
401 (mh-invalidate-show-buffer)
402 (bury-buffer (current-buffer))
403 (if (get-buffer mh-show-buffer)
404 (bury-buffer mh-show-buffer))
405 (if mh-previous-window-config
406 (set-window-configuration mh-previous-window-config))
407 (run-hooks 'mh-quit-hook))
408
409 (defun mh-page-msg (&optional arg)
410 "Page the displayed message forwards.
411 Scrolls ARG lines or a full screen if no argument is supplied."
412 (interactive "P")
413 (scroll-other-window arg))
414
415
416 (defun mh-previous-page (&optional arg)
417 "Page the displayed message backwards.
418 Scrolls ARG lines or a full screen if no argument is supplied."
419 (interactive "P")
420 (mh-in-show-buffer (mh-show-buffer)
421 (scroll-down arg)))
422
423
424 (defun mh-previous-undeleted-msg (&optional arg)
425 "Move to the NTH previous undeleted message in window."
426 (interactive "p")
427 (setq mh-next-direction 'backward)
428 (beginning-of-line)
429 (cond ((re-search-backward mh-good-msg-regexp nil 0 arg)
430 (mh-maybe-show))
431 (t
432 (if (get-buffer mh-show-buffer)
433 (delete-windows-on mh-show-buffer)))))
434
435
436 (defun mh-rescan-folder (&optional range)
437 "Rescan a folder after optionally processing the outstanding commands.
438 If optional prefix argument is provided, prompt for the range of
439 messages to display. Otherwise show the entire folder."
440 (interactive (list (if current-prefix-arg
441 (mh-read-msg-range "Range to scan [all]? ")
442 nil)))
443 (setq mh-next-direction 'forward)
444 (mh-scan-folder mh-current-folder (or range "all")))
445
446
447 (defun mh-write-msg-to-file (msg file no-headers)
448 "Append MESSAGE to the end of a FILE.
449 If NO-HEADERS (prefix argument) is provided, write only the message body.
450 Otherwise send the entire message including the headers."
451 (interactive
452 (list (mh-get-msg-num t)
453 (let ((default-dir (if (eq 'write (car mh-last-destination))
454 (file-name-directory (car (cdr mh-last-destination)))
455 default-directory)))
456 (read-file-name (format "Save message%s in file: "
457 (if current-prefix-arg " body" ""))
458 default-dir
459 (if (eq 'write (car mh-last-destination))
460 (car (cdr mh-last-destination))
461 (expand-file-name "mail.out" default-dir))))
462 current-prefix-arg))
463 (let ((msg-file-to-output (mh-msg-filename msg))
464 (output-file (mh-expand-file-name file)))
465 (setq mh-last-destination (list 'write file (if no-headers 'no-headers)))
466 (save-excursion
467 (set-buffer (get-buffer-create mh-temp-buffer))
468 (erase-buffer)
469 (insert-file-contents msg-file-to-output)
470 (goto-char (point-min))
471 (if no-headers (search-forward "\n\n"))
472 (append-to-file (point) (point-max) output-file))))
473
474
475 (defun mh-toggle-showing ()
476 "Toggle the scanning mode/showing mode of displaying messages."
477 (interactive)
478 (if mh-showing
479 (mh-set-scan-mode)
480 (mh-show)))
481
482
483 (defun mh-undo (msg-or-seq)
484 "Undo the pending deletion or refile of the specified MESSAGE(s).
485 Default is the displayed message. If optional prefix argument is
486 provided, then prompt for the message sequence."
487 (interactive (list (if current-prefix-arg
488 (mh-read-seq-default "Undo" t)
489 (mh-get-msg-num t))))
490 (cond ((numberp msg-or-seq)
491 (let ((original-position (point)))
492 (beginning-of-line)
493 (while (not (or (looking-at mh-deleted-msg-regexp)
494 (looking-at mh-refiled-msg-regexp)
495 (and (eq mh-next-direction 'forward) (bobp))
496 (and (eq mh-next-direction 'backward)
497 (save-excursion (forward-line) (eobp)))))
498 (forward-line (if (eq mh-next-direction 'forward) -1 1)))
499 (if (or (looking-at mh-deleted-msg-regexp)
500 (looking-at mh-refiled-msg-regexp))
501 (progn
502 (mh-undo-msg (mh-get-msg-num t))
503 (mh-maybe-show))
504 (goto-char original-position)
505 (error "Nothing to undo"))))
506 (t
507 (mh-map-to-seq-msgs 'mh-undo-msg msg-or-seq)))
508 ;; update the mh-refile-list so mh-outstanding-commands-p will work
509 (mh-mapc (function
510 (lambda (elt)
511 (if (not (mh-seq-to-msgs elt))
512 (setq mh-refile-list (delq elt mh-refile-list)))))
513 mh-refile-list)
514 (if (not (mh-outstanding-commands-p))
515 (mh-set-folder-modified-p nil)))
516
517
518 ;;;###autoload
519 (defun mh-version ()
520 "Display version information about mh-e and the MH mail handling system."
521 (interactive)
522 (mh-find-progs)
523 (set-buffer (get-buffer-create mh-temp-buffer))
524 (erase-buffer)
525 (insert " mh-e info:\n\nversion: " mh-e-version "\n" mh-e-time-stamp
526 "\nEmacs: " emacs-version " on " (symbol-name system-type) " ")
527 (condition-case ()
528 (call-process "uname" nil t nil "-a")
529 (file-error))
530 (insert "\n\n MH info:\n\n" (expand-file-name "inc" mh-progs) ":\n")
531 (let ((help-start (point)))
532 (condition-case err-data
533 (mh-exec-cmd-output "inc" nil "-help")
534 (file-error (insert (mapconcat 'concat (cdr err-data) ": "))))
535 (goto-char help-start)
536 (search-forward "version: " nil t)
537 (beginning-of-line)
538 (delete-region help-start (point))
539 (goto-char (point-min)))
540 (display-buffer mh-temp-buffer))
541
542
543 (defun mh-visit-folder (folder &optional range)
544 "Visit FOLDER and display RANGE of messages.
545 Do not call this function from outside mh-e; see \\[mh-rmail] instead."
546 (interactive (list (mh-prompt-for-folder "Visit" mh-inbox t)
547 (mh-read-msg-range "Range [all]? ")))
548 (let ((config (current-window-configuration)))
549 (mh-scan-folder folder (or range "all"))
550 (setq mh-previous-window-config config))
551 nil)
552
553
554 (defun mh-compat-quit ()
555 "The \"b\" key is obsolescent; will assume you want \"\\[mh-quit]\" ..."
556 ;; Was going to make it run mh-burst-digest, but got complaint that
557 ;; 'b' should mean 'back', as it does in info, less, and rn.
558 ;; This is a temporary compatibility function.
559 (interactive)
560 (message "%s" (documentation this-command))
561 (sit-for 1)
562 (call-interactively 'mh-quit))
563
564
565 (defun mh-update-sequences ()
566 "Update MH's Unseen sequence and current folder and message.
567 Flush mh-e's state out to MH. The message at the cursor becomes current."
568 (interactive)
569 ;; mh-update-sequences is the opposite of mh-read-folder-sequences,
570 ;; which updates mh-e's state from MH.
571 (let ((folder-set (mh-update-unseen))
572 (new-cur (mh-get-msg-num nil)))
573 (if new-cur
574 (let ((seq-entry (mh-find-seq 'cur)))
575 (mh-remove-cur-notation)
576 (setcdr seq-entry (list new-cur)) ;delete-seq-locally, add-msgs-to-seq
577 (mh-define-sequence 'cur (list new-cur))
578 (beginning-of-line)
579 (if (looking-at mh-good-msg-regexp)
580 (mh-notate nil mh-note-cur mh-cmd-note)))
581 (or folder-set
582 (save-excursion
583 (mh-exec-cmd-quiet t "folder" mh-current-folder "-fast"))))))
584
585
586
587
588 ;;; Support routines.
589
590 (defun mh-delete-a-msg (msg)
591 ;; Delete the MESSAGE.
592 (save-excursion
593 (mh-goto-msg msg nil t)
594 (if (looking-at mh-refiled-msg-regexp)
595 (error "Message %d is refiled. Undo refile before deleting." msg))
596 (if (looking-at mh-deleted-msg-regexp)
597 nil
598 (mh-set-folder-modified-p t)
599 (setq mh-delete-list (cons msg mh-delete-list))
600 (mh-add-msgs-to-seq msg 'deleted t)
601 (mh-notate msg mh-note-deleted mh-cmd-note)
602 (run-hooks 'mh-delete-msg-hook))))
603
604 (defun mh-refile-a-msg (msg destination)
605 ;; Refile MESSAGE in FOLDER. FOLDER is a symbol, not a string.
606 (save-excursion
607 (mh-goto-msg msg nil t)
608 (cond ((looking-at mh-deleted-msg-regexp)
609 (error "Message %d is deleted. Undo delete before moving." msg))
610 ((looking-at mh-refiled-msg-regexp)
611 (if (y-or-n-p
612 (format "Message %d already refiled. Copy to %s as well? "
613 msg destination))
614 (mh-exec-cmd "refile" (mh-get-msg-num t) "-link"
615 "-src" mh-current-folder
616 (symbol-name destination))
617 (message "Message not copied.")))
618 (t
619 (mh-set-folder-modified-p t)
620 (if (not (memq destination mh-refile-list))
621 (setq mh-refile-list (cons destination mh-refile-list)))
622 (if (not (memq msg (mh-seq-to-msgs destination)))
623 (mh-add-msgs-to-seq msg destination t))
624 (mh-notate msg mh-note-refiled mh-cmd-note)
625 (run-hooks 'mh-refile-msg-hook)))))
626
627
628 (defun mh-next-msg ()
629 ;; Move backward or forward to the next undeleted message in the buffer.
630 (if (eq mh-next-direction 'forward)
631 (mh-next-undeleted-msg 1)
632 (mh-previous-undeleted-msg 1)))
633
634
635 (defun mh-set-scan-mode ()
636 ;; Display the scan listing buffer, but do not show a message.
637 (if (get-buffer mh-show-buffer)
638 (delete-windows-on mh-show-buffer))
639 (setq mh-showing nil)
640 (set-buffer-modified-p (buffer-modified-p)) ;force mode line update
641 (if mh-recenter-summary-p
642 (mh-recenter nil)))
643
644
645 (defun mh-undo-msg (msg)
646 ;; Undo the deletion or refile of one MESSAGE.
647 (cond ((memq msg mh-delete-list)
648 (setq mh-delete-list (delq msg mh-delete-list))
649 (mh-delete-msg-from-seq msg 'deleted t))
650 (t
651 (mh-mapc (function (lambda (dest)
652 (mh-delete-msg-from-seq msg dest t)))
653 mh-refile-list)))
654 (mh-notate msg ? mh-cmd-note))
655
656
657
658
659 ;;; The folder data abstraction.
660
661 (defun mh-make-folder (name)
662 ;; Create and initialize a new mail folder called NAME and make it the
663 ;; current folder.
664 (switch-to-buffer name)
665 (setq buffer-read-only nil)
666 (erase-buffer)
667 (setq buffer-read-only t)
668 (mh-folder-mode)
669 (mh-set-folder-modified-p nil)
670 (setq buffer-file-name mh-folder-filename)
671 (mh-make-folder-mode-line))
672
673
674 ;;; Ensure new buffers won't get this mode if default-major-mode is nil.
675 (put 'mh-folder-mode 'mode-class 'special)
676
677 (defun mh-folder-mode ()
678 "Major mh-e mode for \"editing\" an MH folder scan listing.\\<mh-folder-mode-map>
679 You can show the message the cursor is pointing to, and step through the
680 messages. Messages can be marked for deletion or refiling into another
681 folder; these commands are executed all at once with a separate command.
682
683 A prefix argument (\\[universal-argument]) to delete, refile, list, or undo
684 applies the action to a message sequence.
685
686 Here is a list of the standard keys for mh-e commands, grouped by function.
687 This list is purposefully not customized; mh-e has a long history, and many
688 alternate key bindings as a result. This list is to encourage users to use
689 standard keys so the other keys can perhaps someday be put to new uses.
690
691 t toggle show or scan-only mode
692 RET show message, or back to top if already showing
693
694 SPC page message forward
695 DEL page message back
696
697 n next message
698 p previous message
699 g go to message by number
700
701 d mark for deletion
702 o, ^ mark for output (refile) to another folder
703 ? show folder of pending refile
704 u undo delete or refile marking
705
706 x execute marked deletes and refiles
707 i incorporate new mail
708
709 m mail a new message
710 r reply to a message
711 f forward a message
712
713 q quit mh-e
714
715 M-f visit new folder
716 M-r rescan this folder
717
718 Here are all the commands with their current binding, listed in key order:
719 \\{mh-folder-mode-map}
720
721 Variables controlling mh-e operation are (defaults in parentheses):
722
723 mh-recursive-folders (nil)
724 Non-nil means commands which operate on folders do so recursively.
725
726 mh-bury-show-buffer (t)
727 Non-nil means that the buffer used to display message is buried.
728 It will never be offered as the default other buffer.
729
730 mh-clean-message-header (nil)
731 Non-nil means remove header lines matching the regular expression
732 specified in mh-invisible-headers from messages.
733
734 mh-visible-headers (nil)
735 If non-nil, it contains a regexp specifying the headers that are shown in
736 a message if mh-clean-message-header is non-nil. Setting this variable
737 overrides mh-invisible-headers.
738
739 mh-do-not-confirm (nil)
740 Non-nil means do not prompt for confirmation before executing some
741 non-recoverable commands such as mh-kill-folder and mh-undo-folder.
742
743 mhl-formfile (nil)
744 Name of format file to be used by mhl to show messages.
745 A value of T means use the default format file.
746 Nil means don't use mhl to format messages.
747
748 mh-lpr-command-format (\"lpr -p -J '%s'\")
749 Format for command used to print a message on a system printer.
750
751 mh-scan-prog (\"scan\")
752 Program to run to generate one-line-per-message listing of a folder.
753 Normally \"scan\" or a file name linked to scan. This file is searched
754 for relative to the mh-progs directory unless it is an absolute pathname.
755 Automatically becomes buffer-local when set in any fashion.
756
757 mh-print-background (nil)
758 Print messages in the background if non-nil.
759 WARNING: do not delete the messages until printing is finished;
760 otherwise, your output may be truncated.
761
762 mh-recenter-summary-p (nil)
763 If non-nil, then the scan listing is recentered when the window displaying
764 a messages is toggled off.
765
766 mh-summary-height (4)
767 Number of lines in the summary window including the mode line.
768
769 The value of mh-folder-mode-hook is called when a new folder is set up."
770
771 (kill-all-local-variables)
772 (use-local-map mh-folder-mode-map)
773 (setq major-mode 'mh-folder-mode)
774 (mh-set-mode-name "MH-Folder")
775 (mh-make-local-vars
776 'mh-current-folder (buffer-name) ; Name of folder, a string
777 'mh-show-buffer (format "show-%s" (buffer-name)) ; Buffer that displays msgs
778 'mh-folder-filename ; e.g. "/usr/foobar/Mail/inbox/"
779 (file-name-as-directory (mh-expand-file-name (buffer-name)))
780 'mh-showing nil ; Show message also?
781 'mh-delete-list nil ; List of msgs nums to delete
782 'mh-refile-list nil ; List of folder names in mh-seq-list
783 'mh-seq-list nil ; Alist of (seq . msgs) nums
784 'mh-seen-list nil ; List of displayed messages
785 'mh-next-direction 'forward ; Direction to move to next message
786 'mh-narrowed-to-seq nil ; Sequence display is narrowed to
787 'mh-first-msg-num nil ; Number of first msg in buffer
788 'mh-last-msg-num nil ; Number of last msg in buffer
789 'mh-msg-count nil ; Number of msgs in buffer
790 'mh-mode-line-annotation nil ; Indiction this is not the full folder
791 'mh-previous-window-config nil) ; Previous window configuration
792 (setq truncate-lines t)
793 (auto-save-mode -1)
794 (setq buffer-offer-save t)
795 ;; XEmacs change
796 (if (featurep 'scrollbar)
797 (set-specifier scrollbar-height (cons (current-buffer) 0)))
798 (if (boundp 'local-write-file-hooks)
799 (setq local-write-file-hooks '(mh-execute-commands)) ;Emacs 19
800 (make-local-variable 'write-file-hooks)
801 (setq write-file-hooks '(mh-execute-commands))) ;Emacs 18
802 (make-local-variable 'revert-buffer-function)
803 (setq revert-buffer-function 'mh-undo-folder)
804 (or (assq 'mh-showing minor-mode-alist)
805 (setq minor-mode-alist
806 (cons '(mh-showing " Show") minor-mode-alist)))
807 (run-hooks 'mh-folder-mode-hook))
808
809
810 (defun mh-make-local-vars (&rest pairs)
811 ;; Take VARIABLE-VALUE pairs and make local variables initialized to the
812 ;; value.
813 (while pairs
814 (make-variable-buffer-local (car pairs))
815 (set (car pairs) (car (cdr pairs)))
816 (setq pairs (cdr (cdr pairs)))))
817
818
819 (defun mh-scan-folder (folder range)
820 ;; Scan the FOLDER over the RANGE. Return in the folder's buffer.
821 (cond ((null (get-buffer folder))
822 (mh-make-folder folder))
823 (t
824 (mh-process-or-undo-commands folder)
825 (switch-to-buffer folder)))
826 (mh-regenerate-headers range)
827 (cond ((zerop (buffer-size))
828 (if (equal range "all")
829 (message "Folder %s is empty" folder)
830 (message "No messages in %s, range %s" folder range))
831 (sit-for 5)))
832 (mh-goto-cur-msg))
833
834
835 (defun mh-regenerate-headers (range &optional update)
836 ;; scan folder over range RANGE.
837 ;; If UPDATE, append the scan lines, otherwise replace.
838 (let ((folder mh-current-folder)
839 scan-start)
840 (message "Scanning %s..." folder)
841 (with-mh-folder-updating (nil)
842 (if update
843 (goto-char (point-max))
844 (erase-buffer))
845 (setq scan-start (point))
846 (mh-exec-cmd-output mh-scan-prog nil
847 "-noclear" "-noheader"
848 "-width" (window-width)
849 folder range)
850 (goto-char scan-start)
851 (cond ((looking-at "scan: no messages in")
852 (keep-lines mh-valid-scan-line)) ; Flush random scan lines
853 ((looking-at "scan: ")) ; Keep error messages
854 (t
855 (keep-lines mh-valid-scan-line))) ; Flush random scan lines
856 (setq mh-seq-list (mh-read-folder-sequences folder nil))
857 (mh-notate-user-sequences)
858 (or update
859 (setq mh-mode-line-annotation
860 (if (equal range "all")
861 nil
862 mh-partial-folder-mode-line-annotation)))
863 (mh-make-folder-mode-line))
864 (message "Scanning %s...done" folder)))
865
866
867 (defun mh-get-new-mail (maildrop-name)
868 ;; Read new mail from a maildrop into the current buffer.
869 ;; Return in the current buffer.
870 (let ((point-before-inc (point))
871 (folder mh-current-folder)
872 (new-mail-p nil))
873 (with-mh-folder-updating (t)
874 (message (if maildrop-name
875 (format "inc %s -file %s..." folder maildrop-name)
876 (format "inc %s..." folder)))
877 (setq mh-next-direction 'forward)
878 (goto-char (point-max))
879 (let ((start-of-inc (point)))
880 (if maildrop-name
881 ;; I think MH 5 used "-ms-file" instead of "-file",
882 ;; which would make inc'ing from maildrops fail.
883 (mh-exec-cmd-output mh-inc-prog nil folder
884 "-file" (expand-file-name maildrop-name)
885 "-width" (window-width)
886 "-truncate")
887 (mh-exec-cmd-output mh-inc-prog nil
888 "-width" (window-width)))
889 (message
890 (if maildrop-name
891 (format "inc %s -file %s...done" folder maildrop-name)
892 (format "inc %s...done" folder)))
893 (goto-char start-of-inc)
894 (cond ((save-excursion
895 (re-search-forward "^inc: no mail" nil t))
896 (message "No new mail%s%s" (if maildrop-name " in " "")
897 (if maildrop-name maildrop-name "")))
898 ((re-search-forward "^inc:" nil t) ; Error messages
899 (error "inc error"))
900 (t
901 (mh-remove-cur-notation)
902 (setq new-mail-p t)))
903 (keep-lines mh-valid-scan-line) ; Flush random scan lines
904 (setq mh-seq-list (mh-read-folder-sequences folder t))
905 (mh-notate-user-sequences)
906 (if new-mail-p
907 (progn
908 (mh-make-folder-mode-line)
909 (mh-goto-cur-msg))
910 (goto-char point-before-inc))))))
911
912
913 (defun mh-make-folder-mode-line (&optional ignored)
914 ;; Set the fields of the mode line for a folder buffer.
915 ;; The optional argument is now obsolete. It used to be used to pass
916 ;; in what is now stored in the buffer-local variable
917 ;; mh-mode-line-annotation.
918 (save-excursion
919 (mh-first-msg)
920 (setq mh-first-msg-num (mh-get-msg-num nil))
921 (mh-last-msg)
922 (setq mh-last-msg-num (mh-get-msg-num nil))
923 (setq mh-msg-count (count-lines (point-min) (point-max)))
924 (setq mode-line-buffer-identification
925 (list (format "{%%b%s} %d msg%s"
926 (if mh-mode-line-annotation
927 (format "/%s" mh-mode-line-annotation)
928 "")
929 mh-msg-count
930 (if (zerop mh-msg-count)
931 "s"
932 (if (> mh-msg-count 1)
933 (format "s (%d-%d)" mh-first-msg-num
934 mh-last-msg-num)
935 (format " (%d)" mh-first-msg-num))))))))
936
937
938 (defun mh-unmark-all-headers (remove-all-flags)
939 ;; Remove all '+' flags from the headers, and if called with a non-nil
940 ;; argument, remove all 'D', '^' and '%' flags too.
941 ;; Optimized for speed (i.e., no regular expressions).
942 (save-excursion
943 (let ((case-fold-search nil)
944 (last-line (1- (point-max)))
945 char)
946 (mh-first-msg)
947 (while (<= (point) last-line)
948 (forward-char mh-cmd-note)
949 (setq char (following-char))
950 (if (or (and remove-all-flags
951 (or (eql char (aref mh-note-deleted 0))
952 (eql char (aref mh-note-refiled 0))))
953 (eql char (aref mh-note-cur 0)))
954 (progn
955 (delete-char 1)
956 (insert " ")))
957 (if remove-all-flags
958 (progn
959 (forward-char 1)
960 (if (eql (following-char) (aref mh-note-seq 0))
961 (progn
962 (delete-char 1)
963 (insert " ")))))
964 (forward-line)))))
965
966
967 (defun mh-remove-cur-notation ()
968 ;; Remove old cur notation (cf mh-goto-cur-msg code).
969 (let ((cur-msg (car (mh-seq-to-msgs 'cur))))
970 (save-excursion
971 (and cur-msg
972 (mh-goto-msg cur-msg t t)
973 (looking-at mh-cur-scan-msg-regexp)
974 (mh-notate nil ? mh-cmd-note)))))
975
976 (defun mh-goto-cur-msg ()
977 ;; Position the cursor at the current message.
978 (let ((cur-msg (car (mh-seq-to-msgs 'cur))))
979 (cond ((and cur-msg
980 (mh-goto-msg cur-msg t t))
981 (mh-notate nil mh-note-cur mh-cmd-note)
982 (mh-recenter 0)
983 (mh-maybe-show cur-msg))
984 (t
985 (mh-last-msg)
986 (message "No current message")))))
987
988
989 (defun mh-process-or-undo-commands (folder)
990 ;; If FOLDER has outstanding commands, then either process or discard them.
991 ;; Called by functions like mh-sort-folder, so also invalidate show buffer.
992 (set-buffer folder)
993 (if (mh-outstanding-commands-p)
994 (if (or mh-do-not-confirm
995 (y-or-n-p
996 "Process outstanding deletes and refiles (or lose them)? "))
997 (mh-process-commands folder)
998 (mh-undo-folder)))
999 (mh-update-unseen)
1000 (mh-invalidate-show-buffer))
1001
1002
1003 (defun mh-process-commands (folder)
1004 ;; Process outstanding commands for the folder FOLDER.
1005 (message "Processing deletes and refiles for %s..." folder)
1006 (set-buffer folder)
1007 (with-mh-folder-updating (nil)
1008 ;; Update the unseen sequence if it exists
1009 (mh-update-unseen)
1010
1011 ;; Then refile messages
1012 (mh-mapc
1013 (function
1014 (lambda (dest)
1015 (let ((msgs (mh-seq-to-msgs dest)))
1016 (cond (msgs
1017 (apply 'mh-exec-cmd "refile"
1018 "-src" folder (symbol-name dest)
1019 (mh-coalesce-msg-list msgs))
1020 (mh-delete-scan-msgs msgs))))))
1021 mh-refile-list)
1022 (setq mh-refile-list nil)
1023
1024 ;; Now delete messages
1025 (cond (mh-delete-list
1026 (apply 'mh-exec-cmd "rmm" folder
1027 (mh-coalesce-msg-list mh-delete-list))
1028 (mh-delete-scan-msgs mh-delete-list)
1029 (setq mh-delete-list nil)))
1030
1031 ;; Don't need to remove sequences since delete and refile do so.
1032
1033 ;; Mark cur message
1034 (if (> (buffer-size) 0)
1035 (mh-define-sequence 'cur (list (or (mh-get-msg-num nil) "last"))))
1036
1037 (and (buffer-file-name (get-buffer mh-show-buffer))
1038 (not (file-exists-p (buffer-file-name (get-buffer mh-show-buffer))))
1039 ;; If "inc" were to put a new msg in this file,
1040 ;; we would not notice, so mark it invalid now.
1041 (mh-invalidate-show-buffer))
1042
1043 (setq mh-seq-list (mh-read-folder-sequences mh-current-folder nil))
1044 (mh-unmark-all-headers t)
1045 (mh-notate-user-sequences)
1046 (message "Processing deletes and refiles for %s...done" folder)))
1047
1048
1049 (defun mh-update-unseen ()
1050 ;; Flush updates to the Unseen sequence out to MH.
1051 ;; Return non-NIL iff set the MH folder.
1052 (if mh-seen-list
1053 (let* ((unseen-seq (mh-find-seq mh-unseen-seq))
1054 (unseen-msgs (mh-seq-msgs unseen-seq)))
1055 (if unseen-msgs
1056 (progn
1057 (mh-undefine-sequence mh-unseen-seq mh-seen-list)
1058 (while mh-seen-list
1059 (setq unseen-msgs (delq (car mh-seen-list) unseen-msgs))
1060 (setq mh-seen-list (cdr mh-seen-list)))
1061 (setcdr unseen-seq unseen-msgs)
1062 t) ;since we set the folder
1063 (setq mh-seen-list nil)))))
1064
1065
1066 (defun mh-delete-scan-msgs (msgs)
1067 ;; Delete the scan listing lines for each of the msgs in the LIST.
1068 (save-excursion
1069 (while msgs
1070 (if (mh-goto-msg (car msgs) t t)
1071 (mh-delete-line 1))
1072 (setq msgs (cdr msgs)))))
1073
1074
1075 (defun mh-outstanding-commands-p ()
1076 ;; Returns non-nil if there are outstanding deletes or refiles.
1077 (or mh-delete-list mh-refile-list))
1078
1079
1080 (defun mh-coalesce-msg-list (messages)
1081 ;; Give a list of MESSAGES, return a list of message number ranges.
1082 ;; Sort of the opposite of mh-read-msg-list, which expands ranges.
1083 ;; Message lists passed to MH programs go through this so
1084 ;; command line arguments won't exceed system limits.
1085 (let ((msgs (sort (copy-sequence messages) 'mh-greaterp))
1086 (range-high nil)
1087 (prev -1)
1088 (ranges nil))
1089 (while prev
1090 (if range-high
1091 (if (or (not (numberp prev))
1092 (not (eql (car msgs) (1- prev))))
1093 (progn ;non-sequential, flush old range
1094 (if (eql prev range-high)
1095 (setq ranges (cons range-high ranges))
1096 (setq ranges (cons (format "%s-%s" prev range-high) ranges)))
1097 (setq range-high nil))))
1098 (or range-high
1099 (setq range-high (car msgs))) ;start new or first range
1100 (setq prev (car msgs))
1101 (setq msgs (cdr msgs)))
1102 ranges))
1103
1104 (defun mh-greaterp (msg1 msg2)
1105 ;; Sort two message indicators. Strings are "smaller" than numbers.
1106 ;; Legal values are things like "cur", "last", 1, and 1820.
1107 (if (numberp msg1)
1108 (if (numberp msg2)
1109 (> msg1 msg2)
1110 t)
1111 (if (numberp msg2)
1112 nil
1113 (string-lessp msg2 msg1))))
1114
1115
1116
1117 ;;; Basic sequence handling
1118
1119 (defun mh-delete-seq-locally (seq)
1120 ;; Remove mh-e's record of SEQUENCE.
1121 (let ((entry (mh-find-seq seq)))
1122 (setq mh-seq-list (delq entry mh-seq-list))))
1123
1124 (defun mh-read-folder-sequences (folder save-refiles)
1125 ;; Read and return the predefined sequences for a FOLDER.
1126 ;; If SAVE-REFILES is non-nil, then keep the sequences
1127 ;; that note messages to be refiled.
1128 (let ((seqs ()))
1129 (cond (save-refiles
1130 (mh-mapc (function (lambda (seq) ; Save the refiling sequences
1131 (if (mh-folder-name-p (mh-seq-name seq))
1132 (setq seqs (cons seq seqs)))))
1133 mh-seq-list)))
1134 (save-excursion
1135 (if (eq 0 (mh-exec-cmd-quiet nil "mark" folder "-list"))
1136 (progn
1137 ;; look for name in line of form "cur: 4" or "myseq (private): 23"
1138 (while (re-search-forward "^[^: ]+" nil t)
1139 (setq seqs (cons (mh-make-seq (intern (buffer-substring
1140 (match-beginning 0)
1141 (match-end 0)))
1142 (mh-read-msg-list))
1143 seqs)))
1144 (delete-region (point-min) (point))))) ; avoid race with mh-process-daemon
1145 seqs))
1146
1147 (defun mh-read-msg-list ()
1148 ;; Return a list of message numbers from the current point to the end of
1149 ;; the line. Expands ranges into set of individual numbers.
1150 (let ((msgs ())
1151 (end-of-line (save-excursion (end-of-line) (point)))
1152 num)
1153 (while (re-search-forward "[0-9]+" end-of-line t)
1154 (setq num (string-to-int (buffer-substring (match-beginning 0)
1155 (match-end 0))))
1156 (cond ((looking-at "-") ; Message range
1157 (forward-char 1)
1158 (re-search-forward "[0-9]+" end-of-line t)
1159 (let ((num2 (string-to-int (buffer-substring (match-beginning 0)
1160 (match-end 0)))))
1161 (if (< num2 num)
1162 (error "Bad message range: %d-%d" num num2))
1163 (while (<= num num2)
1164 (setq msgs (cons num msgs))
1165 (setq num (1+ num)))))
1166 ((not (zerop num)) ;"pick" outputs "0" to mean no match
1167 (setq msgs (cons num msgs)))))
1168 msgs))
1169
1170 (defun mh-notate-user-sequences ()
1171 ;; Mark the scan listing of all messages in user-defined sequences.
1172 (let ((seqs mh-seq-list)
1173 name)
1174 (while seqs
1175 (setq name (mh-seq-name (car seqs)))
1176 (if (not (mh-internal-seq name))
1177 (mh-notate-seq name mh-note-seq (1+ mh-cmd-note)))
1178 (setq seqs (cdr seqs)))))
1179
1180
1181 (defun mh-internal-seq (name)
1182 ;; Return non-NIL if NAME is the name of an internal mh-e sequence.
1183 (or (memq name '(answered cur deleted forwarded printed))
1184 (eq name mh-unseen-seq)
1185 (eq name mh-previous-seq)
1186 (mh-folder-name-p name)))
1187
1188
1189 (defun mh-delete-msg-from-seq (message sequence &optional internal-flag)
1190 "Delete MESSAGE from SEQUENCE. MESSAGE defaults to displayed message.
1191 From Lisp, optional third arg INTERNAL-FLAG non-nil means do not
1192 inform MH of the change."
1193 (interactive (list (mh-get-msg-num t)
1194 (mh-read-seq-default "Delete from" t)
1195 nil))
1196 (let ((entry (mh-find-seq sequence)))
1197 (cond (entry
1198 (mh-notate-if-in-one-seq message ? (1+ mh-cmd-note) sequence)
1199 (if (not internal-flag)
1200 (mh-undefine-sequence sequence (list message)))
1201 (setcdr entry (delq message (mh-seq-msgs entry)))))))
1202
1203
1204 (defun mh-undefine-sequence (seq msgs)
1205 ;; Remove from the SEQUENCE the list of MSGS.
1206 (mh-exec-cmd "mark" mh-current-folder "-delete"
1207 "-sequence" (symbol-name seq)
1208 (mh-coalesce-msg-list msgs)))
1209
1210
1211 (defun mh-define-sequence (seq msgs)
1212 ;; Define the SEQUENCE to contain the list of MSGS.
1213 ;; Do not mark pseudo-sequences or empty sequences.
1214 ;; Signals an error if SEQUENCE is an illegal name.
1215 (if (and msgs
1216 (not (mh-folder-name-p seq)))
1217 (save-excursion
1218 (mh-exec-cmd-error nil "mark" mh-current-folder "-add" "-zero"
1219 "-sequence" (symbol-name seq)
1220 (mh-coalesce-msg-list msgs)))))
1221
1222
1223 (defun mh-map-over-seqs (func seq-list)
1224 ;; Apply the FUNCTION to each element in the list of SEQUENCES,
1225 ;; passing the sequence name and the list of messages as arguments.
1226 (while seq-list
1227 (funcall func (mh-seq-name (car seq-list)) (mh-seq-msgs (car seq-list)))
1228 (setq seq-list (cdr seq-list))))
1229
1230
1231 (defun mh-notate-if-in-one-seq (msg notation offset seq)
1232 ;; If the MESSAGE is in only the SEQUENCE, then mark the scan listing of the
1233 ;; message with the CHARACTER at the given OFFSET from the beginning of the
1234 ;; listing line.
1235 (let ((in-seqs (mh-seq-containing-msg msg nil)))
1236 (if (and (eq seq (car in-seqs)) (null (cdr in-seqs)))
1237 (mh-notate msg notation offset))))
1238
1239
1240 (defun mh-seq-containing-msg (msg &optional include-internal-p)
1241 ;; Return a list of the sequences containing MESSAGE.
1242 ;; If INCLUDE-INTERNAL-P non-nil, include mh-e internal sequences in list.
1243 (let ((l mh-seq-list)
1244 (seqs ()))
1245 (while l
1246 (and (memq msg (mh-seq-msgs (car l)))
1247 (or include-internal-p
1248 (not (mh-internal-seq (mh-seq-name (car l)))))
1249 (setq seqs (cons (mh-seq-name (car l)) seqs)))
1250 (setq l (cdr l)))
1251 seqs))
1252
1253
1254
1255
1256 ;;; User prompting commands.
1257
1258
1259 (defun mh-read-msg-range (prompt)
1260 ;; Read a list of blank-separated items.
1261 (let* ((buf (read-string prompt))
1262 (buf-size (length buf))
1263 (start 0)
1264 (input ()))
1265 (while (< start buf-size)
1266 (let ((next (read-from-string buf start buf-size)))
1267 (setq input (cons (car next) input))
1268 (setq start (cdr next))))
1269 (nreverse input)))
1270
1271
1272
1273 ;;; Build the folder-mode keymap:
1274
1275 (suppress-keymap mh-folder-mode-map)
1276 (define-key mh-folder-mode-map "q" 'mh-quit)
1277 (define-key mh-folder-mode-map "b" 'mh-compat-quit)
1278 (define-key mh-folder-mode-map "?" 'mh-msg-is-in-seq)
1279 (define-key mh-folder-mode-map "%" 'mh-put-msg-in-seq)
1280 (define-key mh-folder-mode-map "|" 'mh-pipe-msg)
1281 (define-key mh-folder-mode-map "\ea" 'mh-edit-again)
1282 (define-key mh-folder-mode-map "\e%" 'mh-delete-msg-from-seq)
1283 (define-key mh-folder-mode-map "\e#" 'mh-delete-seq)
1284 (define-key mh-folder-mode-map "\C-xn" 'mh-narrow-to-seq)
1285 (define-key mh-folder-mode-map "\C-xw" 'mh-widen)
1286 (define-key mh-folder-mode-map "\eb" 'mh-burst-digest)
1287 (define-key mh-folder-mode-map "\eu" 'mh-undo-folder)
1288 (define-key mh-folder-mode-map "\e " 'mh-page-digest)
1289 (define-key mh-folder-mode-map "\e\177" 'mh-page-digest-backwards)
1290 (define-key mh-folder-mode-map "\ed" 'mh-redistribute)
1291 (define-key mh-folder-mode-map "\ee" 'mh-extract-rejected-mail)
1292 (define-key mh-folder-mode-map "\ef" 'mh-visit-folder)
1293 (define-key mh-folder-mode-map "\ek" 'mh-kill-folder)
1294 (define-key mh-folder-mode-map "\el" 'mh-list-folders)
1295 (define-key mh-folder-mode-map "\en" 'mh-store-msg)
1296 (define-key mh-folder-mode-map "\ep" 'mh-pack-folder)
1297 (define-key mh-folder-mode-map "\eq" 'mh-list-sequences)
1298 (define-key mh-folder-mode-map "\es" 'mh-search-folder)
1299 (define-key mh-folder-mode-map "\er" 'mh-rescan-folder)
1300 (define-key mh-folder-mode-map "l" 'mh-print-msg)
1301 (define-key mh-folder-mode-map "t" 'mh-toggle-showing)
1302 (define-key mh-folder-mode-map "c" 'mh-copy-msg)
1303 (define-key mh-folder-mode-map "i" 'mh-inc-folder)
1304 (define-key mh-folder-mode-map "x" 'mh-execute-commands)
1305 (define-key mh-folder-mode-map "e" 'mh-execute-commands)
1306 (define-key mh-folder-mode-map "f" 'mh-forward)
1307 (define-key mh-folder-mode-map "m" 'mh-send)
1308 (define-key mh-folder-mode-map "s" 'mh-send)
1309 (define-key mh-folder-mode-map "r" 'mh-reply)
1310 (define-key mh-folder-mode-map "a" 'mh-reply)
1311 (define-key mh-folder-mode-map "j" 'mh-goto-msg)
1312 (define-key mh-folder-mode-map "g" 'mh-goto-msg)
1313 (define-key mh-folder-mode-map "\e<" 'mh-first-msg)
1314 (define-key mh-folder-mode-map "\e>" 'mh-last-msg)
1315 (define-key mh-folder-mode-map "\177" 'mh-previous-page)
1316 (define-key mh-folder-mode-map " " 'mh-page-msg)
1317 (define-key mh-folder-mode-map "\r" 'mh-show)
1318 (define-key mh-folder-mode-map "." 'mh-show)
1319 (define-key mh-folder-mode-map "," 'mh-header-display)
1320 (define-key mh-folder-mode-map "u" 'mh-undo)
1321 (define-key mh-folder-mode-map "d" 'mh-delete-msg)
1322 (define-key mh-folder-mode-map "\C-d" 'mh-delete-msg-no-motion)
1323 (define-key mh-folder-mode-map "p" 'mh-previous-undeleted-msg)
1324 (define-key mh-folder-mode-map "n" 'mh-next-undeleted-msg)
1325 (define-key mh-folder-mode-map "o" 'mh-refile-msg)
1326 (define-key mh-folder-mode-map "^" 'mh-refile-msg)
1327 (define-key mh-folder-mode-map "\C-o" 'mh-write-msg-to-file)
1328 (define-key mh-folder-mode-map ">" 'mh-write-msg-to-file)
1329 (define-key mh-folder-mode-map "!" 'mh-refile-or-write-again)
1330
1331 ;; "C-c /" prefix is used in mh-folder-mode by pgp.el and mailcrypt
1332
1333
1334
1335 ;;;autoload the other mh-e parts
1336
1337 ;;; mh-comp
1338
1339 (autoload 'mh-smail "mh-comp"
1340 "Compose and send mail with the MH mail system.
1341 This function is an entry point to mh-e, the Emacs front end
1342 to the MH mail system.
1343 See documentation of `\\[mh-send]' for more details on composing mail." t)
1344
1345 (autoload 'mh-smail-other-window "mh-comp"
1346 "Compose and send mail in other window with the MH mail system.
1347 This function is an entry point to mh-e, the Emacs front end
1348 to the MH mail system.
1349 See documentation of `\\[mh-send]' for more details on composing mail." t)
1350
1351 (autoload 'mh-edit-again "mh-comp"
1352 "Clean-up a draft or a message previously sent and make it resendable.
1353 Default is the current message.
1354 The variable mh-new-draft-cleaned-headers specifies the headers to remove.
1355 See also documentation for `\\[mh-send]' function." t)
1356
1357 (autoload 'mh-extract-rejected-mail "mh-comp"
1358 "Extract a letter returned by the mail system and make it resendable.
1359 Default is the current message. The variable mh-new-draft-cleaned-headers
1360 gives the headers to clean out of the original message.
1361 See also documentation for `\\[mh-send]' function." t)
1362
1363 (autoload 'mh-forward "mh-comp"
1364 "Forward a message or message sequence. Defaults to displayed message.
1365 If optional prefix argument provided, then prompt for the message sequence.
1366 See also documentation for `\\[mh-send]' function." t)
1367
1368 (autoload 'mh-redistribute "mh-comp"
1369 "Redistribute a letter.
1370 Depending on how your copy of MH was compiled, you may need to change the
1371 setting of the variable mh-redist-full-contents. See its documentation." t)
1372
1373 (autoload 'mh-reply "mh-comp"
1374 "Reply to a MESSAGE (default: displayed message).
1375 If optional prefix argument INCLUDEP provided, then include the message
1376 in the reply using filter mhl.reply in your MH directory.
1377 Prompts for type of addresses to reply to:
1378 from sender only,
1379 to sender and primary recipients,
1380 cc/all sender and all recipients.
1381 If the file named by `mh-repl-formfile' exists, it is used as a skeleton
1382 for the reply. See also documentation for `\\[mh-send]' function." t)
1383
1384 (autoload 'mh-send "mh-comp"
1385 "Compose and send a letter.
1386 The file named by `mh-comp-formfile' will be used as the form.
1387 Do not call this function from outside mh-e; use \\[mh-smail] instead.
1388 The letter is composed in mh-letter-mode; see its documentation for more
1389 details. If `mh-compose-letter-function' is defined, it is called on the
1390 draft and passed three arguments: to, subject, and cc." t)
1391
1392 (autoload 'mh-send-other-window "mh-comp"
1393 "Compose and send a letter in another window.
1394 Do not call this function from outside mh-e;
1395 use \\[mh-smail-other-window] instead.
1396 See also documentation for `\\[mh-send]' function." t)
1397
1398 (autoload 'mh-letter-mode "mh-comp"
1399 "Mode for composing letters in mh-e.
1400 For more details, type \\[describe-mode] while in MH-Letter mode." t)
1401
1402
1403 ;;; mh-funcs
1404
1405 (autoload 'mh-burst-digest "mh-funcs"
1406 "Burst apart the current message, which should be a digest.
1407 The message is replaced by its table of contents and the messages from the
1408 digest are inserted into the folder after that message." t)
1409
1410 (autoload 'mh-copy-msg "mh-funcs"
1411 "Copy to another FOLDER the specified MESSAGE(s) without deleting them.
1412 Default is the displayed message. If optional prefix argument is
1413 provided, then prompt for the message sequence." t)
1414
1415 (autoload 'mh-kill-folder "mh-funcs"
1416 "Remove the current folder." t)
1417
1418 (autoload 'mh-list-folders "mh-funcs"
1419 "List mail folders." t)
1420
1421 (autoload 'mh-pack-folder "mh-funcs"
1422 "Renumber the messages of a folder to be 1..n.
1423 First, offer to execute any outstanding commands for the current folder.
1424 If optional prefix argument provided, prompt for the range of messages
1425 to display after packing. Otherwise, show the entire folder." t)
1426
1427 (autoload 'mh-pipe-msg "mh-funcs"
1428 "Pipe the current message through the given shell COMMAND.
1429 If INCLUDE-HEADERS (prefix argument) is provided, send the entire message.
1430 Otherwise just send the message's body without the headers." t)
1431
1432 (autoload 'mh-page-digest "mh-funcs"
1433 "Advance displayed message to next digested message." t)
1434
1435 (autoload 'mh-page-digest-backwards "mh-funcs"
1436 "Back up displayed message to previous digested message." t)
1437
1438 (autoload 'mh-print-msg "mh-funcs"
1439 "Print MESSAGE(s) (default: displayed message) on printer.
1440 If optional prefix argument provided, then prompt for the message sequence.
1441 The variable mh-lpr-command-format is used to generate the print command.
1442 The messages are formatted by mhl. See the variable mhl-formfile." t)
1443
1444 (autoload 'mh-sort-folder "mh-funcs"
1445 "Sort the messages in the current folder by date.
1446 Calls the MH program sortm to do the work.
1447 The arguments in the list mh-sortm-args are passed to sortm
1448 if this function is passed an argument." t)
1449
1450 (autoload 'mh-undo-folder "mh-funcs"
1451 "Undo all commands in current folder." t)
1452
1453 (autoload 'mh-store-msg "mh-funcs"
1454 "Store the file(s) contained in the current message into DIRECTORY.
1455 The message can contain a shar file or uuencoded file.
1456 Default directory is the last directory used, or initially the value of
1457 mh-store-default-directory or the current directory." t)
1458
1459 (autoload 'mh-store-buffer "mh-funcs"
1460 "Store the file(s) contained in the current buffer into DIRECTORY.
1461 The buffer can contain a shar file or uuencoded file.
1462 Default directory is the last directory used, or initially the value of
1463 `mh-store-default-directory' or the current directory." t)
1464
1465
1466 ;;; mh-pick
1467
1468 (autoload 'mh-search-folder "mh-pick"
1469 "Search FOLDER for messages matching a pattern.
1470 Add the messages found to the sequence named `search'." t)
1471
1472 ;;; mh-seq
1473
1474 (autoload 'mh-delete-seq "mh-seq"
1475 "Delete the SEQUENCE." t)
1476 (autoload 'mh-list-sequences "mh-seq"
1477 "List the sequences defined in FOLDER." t)
1478 (autoload 'mh-msg-is-in-seq "mh-seq"
1479 "Display the sequences that contain MESSAGE (default: displayed message)." t)
1480 (autoload 'mh-narrow-to-seq "mh-seq"
1481 "Restrict display of this folder to just messages in SEQUENCE
1482 Use \\[mh-widen] to undo this command." t)
1483 (autoload 'mh-put-msg-in-seq "mh-seq"
1484 "Add MESSAGE(s) (default: displayed message) to SEQUENCE.
1485 If optional prefix argument provided, then prompt for the message sequence." t)
1486 (autoload 'mh-widen "mh-seq"
1487 "Remove restrictions from current folder, thereby showing all messages." t)
1488 (autoload 'mh-rename-seq "mh-seq"
1489 "Rename SEQUENCE to have NEW-NAME." t)
1490
1491 ;;; mh-e.el ends here