1 ;;; mh-e.el --- GNU Emacs interface to the MH mail system
3 ;; Copyright (C) 1985, 1986, 1987, 1988,
4 ;; 1990, 1992, 1993, 1994, 1995, 1997, 1999,
5 ;; 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
7 ;; Author: Bill Wohler <wohler@newt.com>
8 ;; Maintainer: Bill Wohler <wohler@newt.com>
12 ;; This file is part of GNU Emacs.
14 ;; GNU Emacs is free software; you can redistribute it and/or modify
15 ;; it under the terms of the GNU General Public License as published by
16 ;; the Free Software Foundation; either version 2, or (at your option)
19 ;; GNU Emacs is distributed in the hope that it will be useful,
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 ;; GNU General Public License for more details.
24 ;; You should have received a copy of the GNU General Public License
25 ;; along with GNU Emacs; see the file COPYING. If not, write to the
26 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
27 ;; Boston, MA 02110-1301, USA.
31 ;; MH-E is an Emacs interface to the MH mail system.
33 ;; MH-E is supported by GNU Emacs 21 and 22, as well as XEmacs 21
34 ;; (except for versions 21.5.9-21.5.16). It is compatible with MH
35 ;; versions 6.8.4 and higher, all versions of nmh, and GNU mailutils
38 ;; MH (Message Handler) is a powerful mail reader. See
39 ;; http://rand-mh.sourceforge.net/.
41 ;; N.B. MH must have been compiled with the MHE compiler flag or several
42 ;; features necessary for MH-E will be missing from MH commands, specifically
43 ;; the -build switch to repl and forw.
46 ;; M-x mh-rmail to read mail. Type C-h m there for a list of commands.
47 ;; C-u M-x mh-rmail to visit any folder.
48 ;; M-x mh-smail to send mail. From within the mail reader, "s" works, too.
50 ;; Your .emacs might benefit from these bindings:
51 ;; (global-set-key "\C-cr" 'mh-rmail)
52 ;; (global-set-key "\C-xm" 'mh-smail)
53 ;; (global-set-key "\C-x4m" 'mh-smail-other-window)
55 ;; If Emacs can't find mh-rmail or mh-smail, add the following to ~/.emacs:
56 ;; (require 'mh-autoloads)
58 ;; If you want to customize MH-E before explicitly loading it, add this:
59 ;; (require 'mh-cus-load)
62 ;; mh-e-users@lists.sourceforge.net
63 ;; mh-e-announce@lists.sourceforge.net
64 ;; mh-e-devel@lists.sourceforge.net
66 ;; Subscribe by sending a "subscribe" message to
67 ;; <list>-request@lists.sourceforge.net, or by using the web interface at
68 ;; https://sourceforge.net/mail/?group_id=13357
71 ;; https://sourceforge.net/tracker/?group_id=13357&atid=113357
72 ;; Include the output of M-x mh-version in the bug report unless
73 ;; you're 110% sure we won't ask for it.
76 ;; https://sourceforge.net/tracker/?group_id=13357&atid=363357
79 ;; https://sourceforge.net/tracker/?group_id=13357&atid=213357
83 ;; Original version for Gosling emacs by Brian Reid, Stanford, 1982.
84 ;; Modified by James Larus, BBN, July 1984 and UCB, 1984 & 1985.
85 ;; Rewritten for GNU Emacs, James Larus, 1985.
86 ;; Modified by Stephen Gildea, 1988.
87 ;; Maintenance picked up by Bill Wohler and the
88 ;; SourceForge Crew <http://mh-e.sourceforge.net/>, 2001.
92 ;; Provide functions to the rest of MH-E. However, mh-e.el must not
93 ;; use any definitions in files that require mh-e from mh-loaddefs,
94 ;; for if it does it will introduce a require loop.
95 (require 'mh-loaddefs)
103 (defvar mh-xemacs-flag (featurep 'xemacs)
104 "Non-nil means the current Emacs is XEmacs."))
107 (require 'mh-xemacs))
109 (mh-font-lock-add-keywords
113 ;; Function declarations (use font-lock-function-name-face).
114 "\\(def\\(un\\|macro\\)-mh\\)\\|"
115 ;; Variable declarations (use font-lock-variable-name-face).
116 "\\(def\\(custom\\|face\\)-mh\\)\\|"
117 ;; Group declarations (use font-lock-type-face).
120 ;; Any whitespace and defined object.
122 "\\(setf[ \t]+\\sw+)\\|\\sw+\\)?")
123 (1 font-lock-keyword-face)
124 (7 (cond ((match-beginning 2) font-lock-function-name-face)
125 ((match-beginning 4) font-lock-variable-name-face)
126 (t font-lock-type-face))
133 ;; Try to keep variables local to a single file. Provide accessors if
134 ;; variables are shared. Use this section as a last resort.
136 (defconst mh-version "8.0.2" "Version number of MH-E.")
141 '("/usr/local/nmh/bin" ; nmh default
144 "/usr/bin/mh/" ; Ultrix 4.2, Linux
145 "/usr/new/mh/" ; Ultrix < 4.2
146 "/usr/contrib/mh/bin/" ; BSDI
147 "/usr/pkg/bin/" ; NetBSD
149 "/usr/local/bin/mu-mh/" ; GNU mailutils - default
150 "/usr/bin/mu-mh/") ; GNU mailutils - packaged
151 "List of directories to search for variants of the MH variant.
152 The list `exec-path' is searched in addition to this list.
153 There's no need for users to modify this list. Instead add extra
154 directories to the customizable variable `mh-path'.")
156 (defvar mh-variants nil
157 "List describing known MH variants.
158 Do not access this variable directly as it may not have yet been initialized.
159 Use the function `mh-variants' instead.")
161 (defvar mh-variant-in-use nil
162 "The MH variant currently in use; a string with variant and version number.
163 This differs from `mh-variant' when the latter is set to
167 "Directory containing MH commands, such as inc, repl, and rmm.")
170 (put 'mh-progs 'risky-local-variable t)
173 "Directory containing the MH library.
174 This directory contains, among other things, the components file.")
177 (put 'mh-lib 'risky-local-variable t)
179 (defvar mh-lib-progs nil
180 "Directory containing MH helper programs.
181 This directory contains, among other things, the mhl program.")
184 (put 'mh-lib-progs 'risky-local-variable t)
186 ;; Profile Components
188 (defvar mh-draft-folder nil
189 "Cached value of the \"Draft-Folder:\" MH profile component.
190 Name of folder containing draft messages.
191 Do not use a draft folder if nil.")
194 "Cached value of the \"Inbox:\" MH profile component.
195 Set to \"+inbox\" if no such component.
196 Name of the Inbox folder.")
198 (defvar mh-user-path nil
199 "Cached value of the \"Path:\" MH profile component.
200 User's mail folder directory.")
202 ;; Maps declared here so that they can be used in docstrings.
204 (defvar mh-folder-mode-map (make-keymap)
205 "Keymap for MH-Folder mode.")
207 (defvar mh-folder-seq-tool-bar-map nil
208 "Keymap for MH-Folder tool bar.")
210 (defvar mh-folder-tool-bar-map nil
211 "Keymap for MH-Folder tool bar.")
213 (defvar mh-inc-spool-map (make-sparse-keymap)
214 "Keymap for MH-E's mh-inc-spool commands.")
216 (defvar mh-letter-mode-map (copy-keymap text-mode-map)
217 "Keymap for MH-Letter mode.")
219 (defvar mh-letter-tool-bar-map nil
220 "Keymap for MH-Letter tool bar.")
222 (defvar mh-search-mode-map (make-sparse-keymap)
223 "Keymap for MH-Search mode.")
225 (defvar mh-show-mode-map (make-sparse-keymap)
226 "Keymap MH-Show mode.")
228 (defvar mh-show-seq-tool-bar-map nil
229 "Keymap for MH-Show tool bar.")
231 (defvar mh-show-tool-bar-map nil
232 "Keymap for MH-Show tool bar.")
234 ;; MH-Folder Locals (alphabetical)
236 (defvar mh-arrow-marker nil
237 "Marker for arrow display in fringe.")
239 (defvar mh-colors-available-flag nil
240 "Non-nil means colors are available.")
242 (defvar mh-current-folder nil
243 "Name of current folder, a string.")
245 (defvar mh-delete-list nil
246 "List of message numbers to delete.
247 This variable can be used by
248 `mh-before-commands-processed-hook'.")
250 (defvar mh-folder-view-stack nil
251 "Stack of previous folder views.")
253 (defvar mh-index-data nil
254 "Info about index search results.")
256 (defvar mh-index-previous-search nil)
258 (defvar mh-index-msg-checksum-map nil)
260 (defvar mh-index-checksum-origin-map nil)
262 (defvar mh-index-sequence-search-flag nil)
264 (defvar mh-mode-line-annotation nil
265 "Message range displayed in buffer.")
267 (defvar mh-next-direction 'forward
268 "Direction to move to next message.")
270 (defvar mh-previous-window-config nil
271 "Window configuration before MH-E command.")
273 (defvar mh-refile-list nil
274 "List of folder names in `mh-seq-list'.
275 This variable can be used by
276 `mh-before-commands-processed-hook'.")
278 (defvar mh-seen-list nil
279 "List of displayed messages to be removed from the \"Unseen\" sequence.")
281 (defvar mh-seq-list nil
282 "Alist of this folder's sequences.
283 Elements have the form (SEQUENCE . MESSAGES).")
285 (defvar mh-sequence-notation-history nil
286 "Remember original notation that is overwritten by `mh-note-seq'.")
288 (defvar mh-show-buffer nil
289 "Buffer that displays message for this folder.")
291 (defvar mh-showing-mode nil
292 "If non-nil, show the message in a separate window.")
294 (defvar mh-view-ops nil
295 "Stack of operations that change the folder view.
296 These operations include narrowing or threading.")
298 ;; MH-Show Locals (alphabetical)
300 (defvar mh-globals-hash (make-hash-table)
301 "Keeps track of MIME data on a per buffer basis.")
303 (defvar mh-show-folder-buffer nil
304 "Keeps track of folder whose message is being displayed.")
308 (defvar mh-folders-changed nil
309 "Lists which folders were affected by deletes and refiles.
310 This list will always include the current folder
311 `mh-current-folder'. This variable can be used by
312 `mh-after-commands-processed-hook'.")
314 (defvar mh-mail-header-separator "--------"
315 "*Line used by MH to separate headers from text in messages being composed.
317 This variable should not be used directly in programs. Programs
318 should use `mail-header-separator' instead.
319 `mail-header-separator' is initialized to
320 `mh-mail-header-separator' in `mh-letter-mode'; in other
321 contexts, you may have to perform this initialization yourself.
323 Do not make this a regular expression as it may be the argument
324 to `insert' and it is passed through `regexp-quote' before being
325 used by functions like `re-search-forward'.")
327 (defvar mh-sent-from-folder nil
328 "Folder of msg assoc with this letter.")
330 (defvar mh-sent-from-msg nil
331 "Number of msg assoc with this letter.")
335 (defvar mh-unseen-seq nil
336 "Cached value of the \"Unseen-Sequence:\" MH profile component.
337 Name of the Unseen sequence.")
339 (defvar mh-previous-seq nil
340 "Cached value of the \"Previous-Sequence:\" MH profile component.
341 Name of the Previous sequence.")
343 ;; Etc. (alphabetical)
345 (defvar mh-flists-present-flag nil
346 "Non-nil means that we have \"flists\".")
348 (defvar mh-index-data-file ".mhe_index"
349 "MH-E specific file where index seach info is stored.")
351 (defvar mh-letter-header-field-regexp "^\\([A-Za-z][A-Za-z0-9-]*\\):")
353 (defvar mh-page-to-next-msg-flag nil
354 "Non-nil means next SPC or whatever goes to next undeleted message.")
356 (defvar mh-pgp-support-flag (not (not (locate-library "mml2015")))
357 "Non-nil means PGP support is available.")
359 (defvar mh-signature-separator "-- \n"
360 "Text of a signature separator.
362 A signature separator is used to separate the body of a message
363 from the signature. This can be used by user agents such as MH-E
364 to render the signature differently or to suppress the inclusion
365 of the signature in a reply. Use `mh-signature-separator-regexp'
366 when searching for a separator.")
368 (defvar mh-signature-separator-regexp "^-- $"
369 "This regular expression matches the signature separator.
370 See `mh-signature-separator'.")
372 (defvar mh-thread-scan-line-map nil
373 "Map of message index to various parts of the scan line.")
374 (make-variable-buffer-local 'mh-thread-scan-line-map)
376 (defvar mh-thread-scan-line-map-stack nil
377 "Old map of message index to various parts of the scan line.
378 This is the original map that is stored when the folder is
380 (make-variable-buffer-local 'mh-thread-scan-line-map-stack)
382 (defvar mh-x-mailer-string nil
383 "*String containing the contents of the X-Mailer header field.
384 If nil, this variable is initialized to show the version of MH-E,
385 Emacs, and MH the first time a message is composed.")
389 ;;; MH-E Entry Points
391 (eval-when-compile (require 'gnus))
393 (defmacro mh-macro-expansion-time-gnus-version ()
394 "Return Gnus version available at macro expansion time.
395 The macro evaluates the Gnus version at macro expansion time. If
396 MH-E was compiled then macro expansion happens at compile time."
399 (defun mh-run-time-gnus-version ()
400 "Return Gnus version available at run time."
406 "Display version information about MH-E and the MH mail handling system."
408 (set-buffer (get-buffer-create mh-info-buffer))
411 (insert "MH-E " mh-version "\n\n")
412 ;; MH-E compilation details.
413 (insert "MH-E compilation details:\n")
414 (let* ((compiled-mhe (byte-code-function-p (symbol-function 'mh-version)))
415 (gnus-compiled-version (if compiled-mhe
416 (mh-macro-expansion-time-gnus-version)
418 (insert " Byte compiled:\t\t" (if compiled-mhe "yes" "no") "\n"
419 " Gnus (compile-time):\t" gnus-compiled-version "\n"
420 " Gnus (run-time):\t" (mh-run-time-gnus-version) "\n\n"))
422 (insert (emacs-version) "\n\n")
424 (if mh-variant-in-use
425 (insert mh-variant-in-use "\n"
426 " mh-progs:\t" mh-progs "\n"
427 " mh-lib:\t" mh-lib "\n"
428 " mh-lib-progs:\t" mh-lib-progs "\n\n")
429 (insert "No MH variant detected\n"))
432 (call-process "uname" nil t nil "-a")
434 (goto-char (point-min))
435 (display-buffer mh-info-buffer))
441 (defun mh-list-to-string (l)
442 "Flatten the list L and make every element of the new list into a string."
443 (nreverse (mh-list-to-string-1 l)))
445 (defun mh-list-to-string-1 (l)
446 "Flatten the list L and make every element of the new list into a string."
449 (cond ((null element))
451 (push (symbol-name element) new-list))
453 (push (int-to-string element) new-list))
456 (push element new-list))
458 (setq new-list (nconc (mh-list-to-string-1 element) new-list)))
460 (error "Bad element: %s" element))))
465 ;;; MH-E Process Support
467 (defvar mh-index-max-cmdline-args 500
468 "Maximum number of command line args.")
470 (defun mh-xargs (cmd &rest args)
471 "Partial imitation of xargs.
472 The current buffer contains a list of strings, one on each line.
473 The function will execute CMD with ARGS and pass the first
474 `mh-index-max-cmdline-args' strings to it. This is repeated till
475 all the strings have been used."
476 (goto-char (point-min))
477 (let ((current-buffer (current-buffer)))
479 (let ((out (current-buffer)))
480 (set-buffer current-buffer)
482 (let ((arg-list (reverse args))
484 (while (and (not (eobp)) (< count mh-index-max-cmdline-args))
485 (push (buffer-substring-no-properties (point)
486 (mh-line-end-position))
490 (apply #'call-process cmd nil (list out nil) nil
491 (nreverse arg-list))))
493 (insert-buffer-substring out)))))
495 ;; XXX This should be applied anywhere MH-E calls out to /bin/sh.
496 (defun mh-quote-for-shell (string)
497 "Quote STRING for /bin/sh.
498 Adds double-quotes around entire string and quotes the characters
499 \\, `, and $ with a backslash."
501 (loop for x across string
502 concat (format (if (memq x '(?\\ ?` ?$)) "\\%c" "%c") x))
505 (defun mh-exec-cmd (command &rest args)
506 "Execute mh-command COMMAND with ARGS.
507 The side effects are what is desired. Any output is assumed to be
508 an error and is shown to the user. The output is not read or
511 (set-buffer (get-buffer-create mh-log-buffer))
512 (let* ((initial-size (mh-truncate-log-buffer))
514 (args (mh-list-to-string args)))
515 (apply 'call-process (expand-file-name command mh-progs) nil t nil args)
516 (when (> (buffer-size) initial-size)
519 (insert "Errors when executing: " command)
520 (loop for arg in args do (insert " " arg))
522 (save-window-excursion
523 (switch-to-buffer-other-window mh-log-buffer)
526 (defun mh-exec-cmd-error (env command &rest args)
527 "In environment ENV, execute mh-command COMMAND with ARGS.
528 ENV is nil or a string of space-separated \"var=value\" elements.
529 Signals an error if process does not complete successfully."
531 (set-buffer (get-buffer-create mh-temp-buffer))
533 (let ((process-environment process-environment))
534 ;; XXX: We should purge the list that split-string returns of empty
535 ;; strings. This can happen in XEmacs if leading or trailing spaces
537 (dolist (elem (if (stringp env) (split-string env " ") ()))
538 (push elem process-environment))
539 (mh-handle-process-error
540 command (apply #'call-process (expand-file-name command mh-progs)
541 nil t nil (mh-list-to-string args))))))
543 (defun mh-exec-cmd-daemon (command filter &rest args)
544 "Execute MH command COMMAND in the background.
546 If FILTER is non-nil then it is used to process the output
547 otherwise the default filter `mh-process-daemon' is used. See
548 `set-process-filter' for more details of FILTER.
550 ARGS are passed to COMMAND as command line arguments."
552 (set-buffer (get-buffer-create mh-log-buffer))
553 (mh-truncate-log-buffer))
554 (let* ((process-connection-type nil)
555 (process (apply 'start-process
557 (expand-file-name command mh-progs)
558 (mh-list-to-string args))))
559 (set-process-filter process (or filter 'mh-process-daemon))
562 (defun mh-exec-cmd-env-daemon (env command filter &rest args)
563 "In ennvironment ENV, execute mh-command COMMAND in the background.
565 ENV is nil or a string of space-separated \"var=value\" elements.
566 Signals an error if process does not complete successfully.
568 If FILTER is non-nil then it is used to process the output
569 otherwise the default filter `mh-process-daemon' is used. See
570 `set-process-filter' for more details of FILTER.
572 ARGS are passed to COMMAND as command line arguments."
573 (let ((process-environment process-environment))
574 (dolist (elem (if (stringp env) (split-string env " ") ()))
575 (push elem process-environment))
576 (apply #'mh-exec-cmd-daemon command filter args)))
578 (defun mh-process-daemon (process output)
579 "PROCESS daemon that puts OUTPUT into a temporary buffer.
580 Any output from the process is displayed in an asynchronous
582 (with-current-buffer (get-buffer-create mh-log-buffer)
583 (insert-before-markers output)
584 (display-buffer mh-log-buffer)))
586 (defun mh-exec-cmd-quiet (raise-error command &rest args)
587 "Signal RAISE-ERROR if COMMAND with ARGS fails.
588 Execute MH command COMMAND with ARGS. ARGS is a list of strings.
589 Return at start of mh-temp buffer, where output can be parsed and
591 Returns value of `call-process', which is 0 for success, unless
592 RAISE-ERROR is non-nil, in which case an error is signaled if
593 `call-process' returns non-0."
594 (set-buffer (get-buffer-create mh-temp-buffer))
598 (expand-file-name command mh-progs) nil t nil
600 (goto-char (point-min))
602 (mh-handle-process-error command value)
605 (defun mh-exec-cmd-output (command display &rest args)
606 "Execute MH command COMMAND with DISPLAY flag and ARGS.
607 Put the output into buffer after point.
608 Set mark after inserted text.
609 Output is expected to be shown to user, not parsed by MH-E."
610 (push-mark (point) t)
612 (expand-file-name command mh-progs) nil t display
613 (mh-list-to-string args))
615 ;; The following is used instead of 'exchange-point-and-mark because the
616 ;; latter activates the current region (between point and mark), which
617 ;; turns on highlighting. So prior to this bug fix, doing "inc" would
618 ;; highlight a region containing the new messages, which is undesirable.
619 ;; The bug wasn't seen in emacs21 but still occurred in XEmacs21.4.
620 (mh-exchange-point-and-mark-preserving-active-mark))
623 (defvar mark-active) ; XEmacs
625 (defun mh-exchange-point-and-mark-preserving-active-mark ()
626 "Put the mark where point is now, and point where the mark is now.
627 This command works even when the mark is not active, and
628 preserves whether the mark is active or not."
630 (let ((is-active (and (boundp 'mark-active) mark-active)))
631 (let ((omark (mark t)))
633 (error "No mark set in this buffer"))
636 (if (boundp 'mark-active)
637 (setq mark-active is-active))
640 (defun mh-exec-lib-cmd-output (command &rest args)
641 "Execute MH library command COMMAND with ARGS.
642 Put the output into buffer after point.
643 Set mark after inserted text."
644 (apply 'mh-exec-cmd-output (expand-file-name command mh-lib-progs) nil args))
646 (defun mh-handle-process-error (command status)
647 "Raise error if COMMAND returned non-zero STATUS, otherwise return STATUS."
650 (goto-char (point-min))
651 (insert (if (integerp status)
652 (format "%s: exit code %d\n" command status)
653 (format "%s: %s\n" command status)))
655 (let ((error-message (buffer-substring (point-min) (point-max))))
656 (set-buffer (get-buffer-create mh-log-buffer))
657 (mh-truncate-log-buffer)
658 (insert error-message)))
659 (error "%s failed, check buffer %s for error message"
660 command mh-log-buffer)))
664 ;;; MH-E Customization Support Routines
666 ;; Shush compiler (Emacs 21 and XEmacs).
667 (defvar customize-package-emacs-version-alist)
669 ;; Temporary function and data structure used customization.
670 ;; These will be unbound after the options are defined.
671 (defmacro mh-strip-package-version (args)
672 "Strip :package-version keyword and its value from ARGS.
673 In Emacs versions that support the :package-version keyword,
674 ARGS is returned unchanged."
675 `(if (boundp 'customize-package-emacs-version-alist)
678 (loop for keyword in ,args
679 if (cond ((eq keyword ':package-version) (setq seen t) nil)
680 (seen (setq seen nil) nil)
684 (defmacro defgroup-mh (symbol members doc &rest args)
685 "Declare SYMBOL as a customization group containing MEMBERS.
686 See documentation for `defgroup' for a description of the arguments
687 SYMBOL, MEMBERS, DOC and ARGS.
688 This macro is used by Emacs versions that lack the :package-version
689 keyword, introduced in Emacs 22."
690 (declare (doc-string 3))
691 `(defgroup ,symbol ,members ,doc ,@(mh-strip-package-version args)))
692 (put 'defgroup-mh 'lisp-indent-function 'defun)
694 (defmacro defcustom-mh (symbol value doc &rest args)
695 "Declare SYMBOL as a customizable variable that defaults to VALUE.
696 See documentation for `defcustom' for a description of the arguments
697 SYMBOL, VALUE, DOC and ARGS.
698 This macro is used by Emacs versions that lack the :package-version
699 keyword, introduced in Emacs 22."
700 (declare (doc-string 3))
701 `(defcustom ,symbol ,value ,doc ,@(mh-strip-package-version args)))
702 (put 'defcustom-mh 'lisp-indent-function 'defun)
704 (defmacro defface-mh (face spec doc &rest args)
705 "Declare FACE as a customizable face that defaults to SPEC.
706 See documentation for `defface' for a description of the arguments
707 FACE, SPEC, DOC and ARGS.
708 This macro is used by Emacs versions that lack the :package-version
709 keyword, introduced in Emacs 22."
710 (declare (doc-string 3))
711 `(defface ,face ,spec ,doc ,@(mh-strip-package-version args)))
712 (put 'defface-mh 'lisp-indent-function 'defun)
718 (defcustom-mh mh-path nil
719 "*Additional list of directories to search for MH.
722 :type '(repeat (directory))
723 :package-version '(MH-E "8.0"))
725 (defun mh-variants ()
726 "Return a list of installed variants of MH on the system.
727 This function looks for MH in `mh-sys-path', `mh-path' and
728 `exec-path'. The format of the list of variants that is returned
729 is described by the variable `mh-variants'."
733 ;; Make a unique list of directories, keeping the given order.
734 ;; We don't want the same MH variant to be listed multiple times.
735 (loop for dir in (append mh-path mh-sys-path exec-path) do
736 (setq dir (file-chase-links (directory-file-name dir)))
737 (add-to-list 'list-unique dir))
738 (loop for dir in (nreverse list-unique) do
739 (when (and dir (file-directory-p dir) (file-readable-p dir))
740 (let ((variant (mh-variant-info dir)))
742 (add-to-list 'mh-variants variant)))))
745 (defun mh-variant-info (dir)
746 "Return MH variant found in DIR, or nil if none present."
748 (let ((tmp-buffer (get-buffer-create mh-temp-buffer)))
749 (set-buffer tmp-buffer)
751 ((mh-variant-mh-info dir))
752 ((mh-variant-nmh-info dir))
753 ((mh-variant-mu-mh-info dir))))))
755 (defun mh-variant-mh-info (dir)
756 "Return info for MH variant in DIR assuming a temporary buffer is setup."
757 ;; MH does not have the -version option.
758 ;; Its version number is included in the output of "-help" as:
760 ;; version: MH 6.8.4 #2[UCI] (burrito) of Fri Jan 15 20:01:39 EST 1999
761 ;; options: [ATHENA] [BIND] [DUMB] [LIBLOCKFILE] [LOCALE] [MAILGROUP] [MHE]
762 ;; [MHRC] [MIME] [MORE='"/usr/bin/sensible-pager"'] [NLINK_HACK]
763 ;; [NORUSERPASS] [OVERHEAD] [POP] [POPSERVICE='"pop-3"'] [RENAME]
764 ;; [RFC1342] [RPATHS] [RPOP] [SENDMTS] [SMTP] [SOCKETS]
765 ;; [SPRINTFTYPE=int] [SVR4] [SYS5] [SYS5DIR] [TERMINFO]
766 ;; [TYPESIG=void] [UNISTD] [UTK] [VSPRINTF]
767 (let ((mhparam (expand-file-name "mhparam" dir)))
768 (when (mh-file-command-p mhparam)
770 (call-process mhparam nil '(t nil) nil "-help")
771 (goto-char (point-min))
772 (when (search-forward-regexp "version: MH \\(\\S +\\)" nil t)
773 (let ((version (format "MH %s" (match-string 1))))
775 (call-process mhparam nil '(t nil) nil "libdir")
776 (goto-char (point-min))
777 (when (search-forward-regexp "^.*$" nil t)
778 (let ((libdir (match-string 0)))
781 (mh-lib-progs ,libdir)
786 (defun mh-variant-mu-mh-info (dir)
787 "Return info for GNU mailutils variant in DIR.
788 This assumes that a temporary buffer is setup."
789 ;; 'mhparam -version' output:
790 ;; mhparam (GNU mailutils 0.3.2)
791 (let ((mhparam (expand-file-name "mhparam" dir)))
792 (when (mh-file-command-p mhparam)
794 (call-process mhparam nil '(t nil) nil "-version")
795 (goto-char (point-min))
796 (when (search-forward-regexp "mhparam (\\(GNU [Mm]ailutils \\S +\\))"
798 (let ((version (match-string 1))
802 (mh-lib-progs ,(mh-profile-component "libdir"))
803 (mh-lib ,(mh-profile-component "etcdir"))
805 (flists ,(file-exists-p
806 (expand-file-name "flists" dir)))))))))
808 (defun mh-variant-nmh-info (dir)
809 "Return info for nmh variant in DIR assuming a temporary buffer is setup."
810 ;; `mhparam -version' outputs:
811 ;; mhparam -- nmh-1.1-RC1 [compiled on chaak at Fri Jun 20 11:03:28 PDT 2003]
812 (let ((mhparam (expand-file-name "mhparam" dir)))
813 (when (mh-file-command-p mhparam)
815 (call-process mhparam nil '(t nil) nil "-version")
816 (goto-char (point-min))
817 (when (search-forward-regexp "mhparam -- nmh-\\(\\S +\\)" nil t)
818 (let ((version (format "nmh %s" (match-string 1)))
822 (mh-lib-progs ,(mh-profile-component "libdir"))
823 (mh-lib ,(mh-profile-component "etcdir"))
825 (flists ,(file-exists-p
826 (expand-file-name "flists" dir)))))))))
828 (defun mh-file-command-p (file)
829 "Return t if file FILE is the name of a executable regular file."
830 (and (file-regular-p file) (file-executable-p file)))
832 (defun mh-variant-set-variant (variant)
833 "Setup the system variables for the MH variant named VARIANT.
834 If VARIANT is a string, use that key in the alist returned by the
835 function `mh-variants'.
836 If VARIANT is a symbol, select the first entry that matches that
839 ((stringp variant) ;e.g. "nmh 1.1-RC1"
840 (when (assoc variant (mh-variants))
841 (let* ((alist (cdr (assoc variant (mh-variants))))
842 (lib-progs (cadr (assoc 'mh-lib-progs alist)))
843 (lib (cadr (assoc 'mh-lib alist)))
844 (progs (cadr (assoc 'mh-progs alist)))
845 (flists (cadr (assoc 'flists alist))))
846 ;;(set-default mh-variant variant)
847 (setq mh-x-mailer-string nil
848 mh-flists-present-flag flists
849 mh-lib-progs lib-progs
852 mh-variant-in-use variant))))
853 ((symbolp variant) ;e.g. 'nmh (pick the first match)
854 (loop for variant-list in (mh-variants)
855 when (eq variant (cadr (assoc 'variant (cdr variant-list))))
856 return (let* ((version (car variant-list))
857 (alist (cdr variant-list))
858 (lib-progs (cadr (assoc 'mh-lib-progs alist)))
859 (lib (cadr (assoc 'mh-lib alist)))
860 (progs (cadr (assoc 'mh-progs alist)))
861 (flists (cadr (assoc 'flists alist))))
862 ;;(set-default mh-variant flavor)
863 (setq mh-x-mailer-string nil
864 mh-flists-present-flag flists
865 mh-lib-progs lib-progs
868 mh-variant-in-use version)
871 (defun mh-variant-p (&rest variants)
872 "Return t if variant is any of VARIANTS.
873 Currently known variants are 'MH, 'nmh, and 'mu-mh."
874 (let ((variant-in-use
875 (cadr (assoc 'variant (assoc mh-variant-in-use (mh-variants))))))
876 (not (null (member variant-in-use variants)))))
878 (defun mh-profile-component (component)
879 "Return COMPONENT value from mhparam, or nil if unset."
881 ;; MH and nmh use -components, Mailutils uses -component. Since MH
882 ;; and nmh work with an unambiguous prefix, the `s' is dropped here.
883 (mh-exec-cmd-quiet nil "mhparam" "-component" component)
884 (mh-profile-component-value component)))
886 (defun mh-profile-component-value (component)
887 "Find and return the value of COMPONENT in the current buffer.
888 Returns nil if the component is not in the buffer."
889 (let ((case-fold-search t))
890 (goto-char (point-min))
891 (cond ((not (re-search-forward (format "^%s:" component) nil t)) nil)
892 ((looking-at "[\t ]*$") nil)
894 (re-search-forward "[\t ]*\\([^\t \n].*\\)$" nil t)
895 (let ((start (match-beginning 1)))
897 (buffer-substring start (point)))))))
899 (defun mh-variant-set (variant)
900 "Set the MH variant to VARIANT.
901 Sets `mh-progs', `mh-lib', `mh-lib-progs' and
902 `mh-flists-present-flag'.
903 If the VARIANT is \"autodetect\", then first try nmh, then MH and
904 finally GNU mailutils."
906 (list (completing-read
908 (mapcar (lambda (x) (list (car x))) (mh-variants))
910 (let ((valid-list (mapcar (lambda (x) (car x)) (mh-variants))))
913 ((eq variant 'autodetect)
915 ((mh-variant-set-variant 'nmh)
916 (message "%s installed as MH variant" mh-variant-in-use))
917 ((mh-variant-set-variant 'mh)
918 (message "%s installed as MH variant" mh-variant-in-use))
919 ((mh-variant-set-variant 'mu-mh)
920 (message "%s installed as MH variant" mh-variant-in-use))
922 (message "No MH variant found on the system"))))
923 ((member variant valid-list)
924 (when (not (mh-variant-set-variant variant))
925 (message "Warning: %s variant not found. Autodetecting..." variant)
926 (mh-variant-set 'autodetect)))
928 (message "Unknown variant; use %s"
929 (mapconcat '(lambda (x) (format "%s" (car x)))
930 (mh-variants) " or "))))))
932 (defcustom-mh mh-variant 'autodetect
933 "*Specifies the variant used by MH-E.
935 The default setting of this option is \"Auto-detect\" which means
936 that MH-E will automatically choose the first of nmh, MH, or GNU
937 mailutils that it finds in the directories listed in
938 `mh-path' (which you can customize), `mh-sys-path', and
939 `exec-path'. If MH-E can't find MH at all, you may have to
940 customize `mh-path' and add the directory in which the command
941 \"mhparam\" is located. If, on the other hand, you have both nmh
942 and mailutils installed (for example) and `mh-variant-in-use' was
943 initialized to nmh but you want to use mailutils, then you can
944 set this option to \"mailutils\".
946 When this variable is changed, MH-E resets `mh-progs', `mh-lib',
947 `mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
948 accordingly. Prior to version 8, it was often necessary to set
949 some of these variables in \"~/.emacs\"; now it is no longer
950 necessary and can actually cause problems."
952 (const :tag "Auto-detect" autodetect)
953 ,@(mapcar (lambda (x) `(const ,(car x))) (mh-variants)))
954 :set (lambda (symbol value)
955 (set-default symbol value) ;Done in mh-variant-set-variant!
956 (mh-variant-set value))
958 :package-version '(MH-E "8.0"))
962 ;;; MH-E Customization
964 ;; All of the defgroups, defcustoms, and deffaces in MH-E are found
965 ;; here. This makes it possible to customize modules that aren't
966 ;; loaded yet. It also makes it easier to organize the customization
969 ;; This section contains the following sub-sections:
971 ;; 1. MH-E Customization Groups
973 ;; These are the customization group definitions. Every group has a
974 ;; associated manual node. The ordering is alphabetical, except for
975 ;; the groups mh-faces and mh-hooks which are last .
977 ;; 2. MH-E Customization
979 ;; These are the actual customization variables. There is a
980 ;; sub-section for each group in the MH-E Customization Groups
981 ;; section, in the same order, separated by page breaks. Within
982 ;; each section, variables are sorted alphabetically.
986 ;; All hooks must be placed in the mh-hook group; in addition, add
987 ;; the group associated with the manual node in which the hook is
988 ;; described. Since the mh-hook group appears near the end of this
989 ;; section, the hooks will appear at the end of these other groups.
993 ;; All faces must be placed in the mh-faces group; in addition, add
994 ;; the group associated with the manual node in which the face is
995 ;; described. Since the mh-faces group appears near the end of this
996 ;; section, the faces will appear at the end of these other groups.
998 (defun mh-customize (&optional delete-other-windows-flag)
999 "Customize MH-E variables.
1000 If optional argument DELETE-OTHER-WINDOWS-FLAG is non-nil, other
1001 windows in the frame are removed."
1003 (customize-group 'mh-e)
1004 (when delete-other-windows-flag
1005 (delete-other-windows)))
1007 (if (boundp 'customize-package-emacs-version-alist)
1008 (add-to-list 'customize-package-emacs-version-alist
1009 '(MH-E ("6.0" . "22.1") ("6.1" . "22.1") ("7.0" . "22.1")
1010 ("7.1" . "22.1") ("7.2" . "22.1") ("7.3" . "22.1")
1011 ("7.4" . "22.1") ("8.0" . "22.1"))))
1015 ;;; MH-E Customization Groups
1017 (defgroup-mh mh-e nil
1018 "Emacs interface to the MH mail system.
1019 MH is the Rand Mail Handler. Other implementations include nmh
1021 :link '(custom-manual "(mh-e)Top")
1023 :package-version '(MH-E . "8.0"))
1025 (defgroup-mh mh-alias nil
1027 :link '(custom-manual "(mh-e)Aliases")
1030 :package-version '(MH-E . "7.1"))
1032 (defgroup-mh mh-folder nil
1033 "Organizing your mail with folders."
1035 :link '(custom-manual "(mh-e)Folders")
1037 :package-version '(MH-E . "7.1"))
1039 (defgroup-mh mh-folder-selection nil
1042 :link '(custom-manual "(mh-e)Folder Selection")
1044 :package-version '(MH-E . "8.0"))
1046 (defgroup-mh mh-identity nil
1048 :link '(custom-manual "(mh-e)Identities")
1049 :prefix "mh-identity-"
1051 :package-version '(MH-E . "7.1"))
1053 (defgroup-mh mh-inc nil
1054 "Incorporating your mail."
1056 :link '(custom-manual "(mh-e)Incorporating Mail")
1058 :package-version '(MH-E . "8.0"))
1060 (defgroup-mh mh-junk nil
1061 "Dealing with junk mail."
1062 :link '(custom-manual "(mh-e)Junk")
1065 :package-version '(MH-E . "7.3"))
1067 (defgroup-mh mh-letter nil
1070 :link '(custom-manual "(mh-e)Editing Drafts")
1072 :package-version '(MH-E . "7.1"))
1074 (defgroup-mh mh-ranges nil
1077 :link '(custom-manual "(mh-e)Ranges")
1079 :package-version '(MH-E . "8.0"))
1081 (defgroup-mh mh-scan-line-formats nil
1082 "Scan line formats."
1083 :link '(custom-manual "(mh-e)Scan Line Formats")
1086 :package-version '(MH-E . "8.0"))
1088 (defgroup-mh mh-search nil
1090 :link '(custom-manual "(mh-e)Searching")
1091 :prefix "mh-search-"
1093 :package-version '(MH-E . "8.0"))
1095 (defgroup-mh mh-sending-mail nil
1098 :link '(custom-manual "(mh-e)Sending Mail")
1100 :package-version '(MH-E . "8.0"))
1102 (defgroup-mh mh-sequences nil
1105 :link '(custom-manual "(mh-e)Sequences")
1107 :package-version '(MH-E . "8.0"))
1109 (defgroup-mh mh-show nil
1110 "Reading your mail."
1112 :link '(custom-manual "(mh-e)Reading Mail")
1114 :package-version '(MH-E . "7.1"))
1116 (defgroup-mh mh-speedbar nil
1119 :link '(custom-manual "(mh-e)Speedbar")
1121 :package-version '(MH-E . "8.0"))
1123 (defgroup-mh mh-thread nil
1125 :prefix "mh-thread-"
1126 :link '(custom-manual "(mh-e)Threading")
1128 :package-version '(MH-E . "8.0"))
1130 (defgroup-mh mh-tool-bar nil
1132 :link '(custom-manual "(mh-e)Tool Bar")
1135 :package-version '(MH-E . "8.0"))
1137 (defgroup-mh mh-hooks nil
1139 :link '(custom-manual "(mh-e)Top")
1142 :package-version '(MH-E . "7.1"))
1144 (defgroup-mh mh-faces nil
1145 "Faces used in MH-E."
1146 :link '(custom-manual "(mh-e)Top")
1150 :package-version '(MH-E . "7.1"))
1154 ;;; MH-E Customization
1156 ;; See Variant Support, above, for mh-e group.
1158 ;;; Aliases (:group 'mh-alias)
1160 (defcustom-mh mh-alias-completion-ignore-case-flag t
1161 "*Non-nil means don't consider case significant in MH alias completion.
1163 As MH ignores case in the aliases, so too does MH-E. However, you
1164 may turn off this option to make case significant which can be
1165 used to segregate completion of your aliases. You might use
1166 lowercase for mailing lists and uppercase for people."
1169 :package-version '(MH-E . "7.1"))
1171 (defcustom-mh mh-alias-expand-aliases-flag nil
1172 "*Non-nil means to expand aliases entered in the minibuffer.
1174 In other words, aliases entered in the minibuffer will be
1175 expanded to the full address in the message draft. By default,
1176 this expansion is not performed."
1179 :package-version '(MH-E . "7.1"))
1181 (defcustom-mh mh-alias-flash-on-comma t
1182 "*Specify whether to flash address or warn on translation.
1184 This option controls the behavior when a [comma] is pressed while
1185 entering aliases or addresses. The default setting flashes the
1186 address associated with an address in the minibuffer briefly, but
1187 does not display a warning if the alias is not found."
1188 :type '(choice (const :tag "Flash but Don't Warn If No Alias" t)
1189 (const :tag "Flash and Warn If No Alias" 1)
1190 (const :tag "Don't Flash Nor Warn If No Alias" nil))
1192 :package-version '(MH-E . "7.1"))
1194 (defcustom-mh mh-alias-insert-file nil
1195 "*Filename used to store a new MH-E alias.
1197 The default setting of this option is \"Use Aliasfile Profile
1198 Component\". This option can also hold the name of a file or a
1199 list a file names. If this option is set to a list of file names,
1200 or the \"Aliasfile:\" profile component contains more than one file
1201 name, MH-E will prompt for one of them when MH-E adds an alias."
1202 :type '(choice (const :tag "Use Aliasfile Profile Component" nil)
1203 (file :tag "Alias File")
1204 (repeat :tag "List of Alias Files" file))
1206 :package-version '(MH-E . "7.1"))
1208 (defcustom-mh mh-alias-insertion-location 'sorted
1209 "Specifies where new aliases are entered in alias files.
1211 This option is set to \"Alphabetical\" by default. If you organize
1212 your alias file in other ways, then adding aliases to the \"Top\"
1213 or \"Bottom\" of your alias file might be more appropriate."
1214 :type '(choice (const :tag "Alphabetical" sorted)
1215 (const :tag "Top" top)
1216 (const :tag "Bottom" bottom))
1218 :package-version '(MH-E . "7.1"))
1220 (defcustom-mh mh-alias-local-users t
1221 "*If on, local users are added to alias completion.
1223 Aliases are created from \"/etc/passwd\" entries with a user ID
1224 larger than a magical number, typically 200. This can be a handy
1225 tool on a machine where you and co-workers exchange messages.
1226 These aliases have the form \"local.first.last\" if a real name is
1227 present in the password file. Otherwise, the alias will have the
1228 form \"local.login\".
1230 If you're on a system with thousands of users you don't know, and
1231 the loading of local aliases slows MH-E down noticeably, then
1232 turn this option off.
1234 This option also takes a string which is executed to generate the
1235 password file. For example, use \"ypcat passwd\" to obtain the
1237 :type '(choice (boolean) (string))
1239 :package-version '(MH-E . "7.1"))
1241 (defcustom-mh mh-alias-local-users-prefix "local."
1242 "*String prefixed to the real names of users from the password file.
1243 This option can also be set to \"Use Login\".
1245 For example, consider the following password file entry:
1247 psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh
1249 The following settings of this option will produce the associated
1252 \"local.\" local.peter.galbraith
1253 \"\" peter.galbraith
1256 This option has no effect if variable `mh-alias-local-users' is
1258 :type '(choice (const :tag "Use Login" nil)
1261 :package-version '(MH-E . "7.4"))
1263 (defcustom-mh mh-alias-passwd-gecos-comma-separator-flag t
1264 "*Non-nil means the gecos field in the password file uses a comma separator.
1266 In the example in `mh-alias-local-users-prefix', commas are used
1267 to separate different values within the so-called gecos field.
1268 This is a fairly common usage. However, in the rare case that the
1269 gecos field in your password file is not separated by commas and
1270 whose contents may contain commas, you can turn this option off."
1273 :package-version '(MH-E . "7.4"))
1275 ;;; Organizing Your Mail with Folders (:group 'mh-folder)
1277 (defcustom-mh mh-new-messages-folders t
1278 "Folders searched for the \"unseen\" sequence.
1280 Set this option to \"Inbox\" to search the \"+inbox\" folder or
1281 \"All\" to search all of the top level folders. Otherwise, list
1282 the folders that should be searched with the \"Choose Folders\"
1285 See also `mh-recursive-folders-flag'."
1286 :type '(choice (const :tag "Inbox" t)
1287 (const :tag "All" nil)
1288 (repeat :tag "Choose Folders" (string :tag "Folder")))
1290 :package-version '(MH-E . "8.0"))
1292 (defcustom-mh mh-ticked-messages-folders t
1293 "Folders searched for `mh-tick-seq'.
1295 Set this option to \"Inbox\" to search the \"+inbox\" folder or
1296 \"All\" to search all of the top level folders. Otherwise, list
1297 the folders that should be searched with the \"Choose Folders\"
1300 See also `mh-recursive-folders-flag'."
1301 :type '(choice (const :tag "Inbox" t)
1302 (const :tag "All" nil)
1303 (repeat :tag "Choose Folders" (string :tag "Folder")))
1305 :package-version '(MH-E . "8.0"))
1307 (defcustom-mh mh-large-folder 200
1308 "The number of messages that indicates a large folder.
1310 If a folder is deemed to be large, that is the number of messages
1311 in it exceed this value, then confirmation is needed when it is
1312 visited. Even when `mh-show-threads-flag' is non-nil, the folder
1313 is not automatically threaded, if it is large. If set to nil all
1314 folders are treated as if they are small."
1315 :type '(choice (const :tag "No Limit") integer)
1317 :package-version '(MH-E . "7.0"))
1319 (defcustom-mh mh-recenter-summary-flag nil
1320 "*Non-nil means to recenter the summary window.
1322 If this option is turned on, recenter the summary window when the
1323 show window is toggled off."
1326 :package-version '(MH-E . "7.0"))
1328 (defcustom-mh mh-recursive-folders-flag nil
1329 "*Non-nil means that commands which operate on folders do so recursively."
1332 :package-version '(MH-E . "7.0"))
1334 (defcustom-mh mh-sortm-args nil
1335 "*Additional arguments for \"sortm\"\\<mh-folder-mode-map>.
1337 This option is consulted when a prefix argument is used with
1338 \\[mh-sort-folder]. Normally default arguments to \"sortm\" are
1339 specified in the MH profile. This option may be used to provide
1340 an alternate view. For example, \"'(\"-nolimit\" \"-textfield\"
1341 \"subject\")\" is a useful setting."
1344 :package-version '(MH-E . "8.0"))
1346 ;;; Folder Selection (:group 'mh-folder-selection)
1348 (defcustom-mh mh-default-folder-for-message-function nil
1349 "Function to select a default folder for refiling or \"Fcc:\".
1351 When this function is called, the current buffer contains the message
1352 being refiled and point is at the start of the message. This function
1353 should return the default folder as a string with a leading \"+\"
1354 sign. It can also return nil so that the last folder name is used as
1355 the default, or an empty string to suppress the default entirely."
1357 :group 'mh-folder-selection
1358 :package-version '(MH-E . "8.0"))
1360 (defcustom-mh mh-default-folder-list nil
1361 "*List of addresses and folders.
1363 The folder name associated with the first address found in this
1364 list is used as the default for `mh-refile-msg' and similar
1365 functions. Each element in this list contains a \"Check Recipient\"
1366 item. If this item is turned on, then the address is checked
1367 against the recipient instead of the sender. This is useful for
1370 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1371 for more information."
1372 :type '(repeat (list (regexp :tag "Address")
1373 (string :tag "Folder")
1374 (boolean :tag "Check Recipient")))
1375 :group 'mh-folder-selection
1376 :package-version '(MH-E . "7.2"))
1378 (defcustom-mh mh-default-folder-must-exist-flag t
1379 "*Non-nil means guessed folder name must exist to be used.
1381 If the derived folder does not exist, and this option is on, then
1382 the last folder name used is suggested. This is useful if you get
1383 mail from various people for whom you have an alias, but file
1384 them all in the same project folder.
1386 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1387 for more information."
1389 :group 'mh-folder-selection
1390 :package-version '(MH-E . "7.2"))
1392 (defcustom-mh mh-default-folder-prefix ""
1393 "*Prefix used for folder names generated from aliases.
1394 The prefix is used to prevent clutter in your mail directory.
1396 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1397 for more information."
1399 :group 'mh-folder-selection
1400 :package-version '(MH-E . "7.2"))
1402 ;;; Identities (:group 'mh-identity)
1405 (unless (fboundp 'mh-identity-make-menu-no-autoload)
1406 (defun mh-identity-make-menu-no-autoload ()
1407 "Temporary definition.
1408 Real definition will take effect when mh-identity is loaded."
1411 (defcustom-mh mh-identity-list nil
1412 "*List of identities.
1414 To customize this option, click on the \"INS\" button and enter a label
1415 such as \"Home\" or \"Work\". Then click on the \"INS\" button with the
1416 label \"Add at least one item below\". Then choose one of the items in
1419 You can specify an alternate \"From:\" header field using the \"From
1420 Field\" menu item. You must include a valid email address. A standard
1421 format is \"First Last <login@@host.domain>\". If you use an initial
1422 with a period, then you must quote your name as in '\"First I. Last\"
1423 <login@@host.domain>'. People usually list the name of the company
1424 where they work using the \"Organization Field\" menu item. Set any
1425 arbitrary header field and value in the \"Other Field\" menu item.
1426 Unless the header field is a standard one, precede the name of your
1427 field's label with \"X-\", as in \"X-Fruit-of-the-Day:\". The value of
1428 \"Attribution Verb\" overrides the setting of
1429 `mh-extract-from-attribution-verb'. Set your signature with the
1430 \"Signature\" menu item. You can specify the contents of
1431 `mh-signature-file-name', a file, or a function. Specify a different
1432 key to sign or encrypt messages with the \"GPG Key ID\" menu item.
1434 You can select the identities you have added via the menu called
1435 \"Identity\" in the MH-Letter buffer. You can also use
1436 \\[mh-insert-identity]. To clear the fields and signature added by the
1437 identity, select the \"None\" identity.
1439 The \"Identity\" menu contains two other items to save you from having
1440 to set the identity on every message. The menu item \"Set Default for
1441 Session\" can be used to set the default identity to the current
1442 identity until you exit Emacs. The menu item \"Save as Default\" sets
1443 the option `mh-identity-default' to the current identity setting. You
1444 can also customize the `mh-identity-default' option in the usual
1446 :type '(repeat (list :tag ""
1447 (string :tag "Label")
1448 (repeat :tag "Add at least one item below"
1450 (cons :tag "From Field"
1452 (string :tag "Value"))
1453 (cons :tag "Organization Field"
1454 (const "Organization")
1455 (string :tag "Value"))
1456 (cons :tag "Other Field"
1457 (string :tag "Field")
1458 (string :tag "Value"))
1459 (cons :tag "Attribution Verb"
1460 (const ":attribution-verb")
1461 (string :tag "Value"))
1462 (cons :tag "Signature"
1463 (const :tag "Signature"
1466 (const :tag "mh-signature-file-name"
1470 (cons :tag "GPG Key ID"
1471 (const :tag "GPG Key ID"
1472 ":pgg-default-user-id")
1473 (string :tag "Value"))))))
1474 :set (lambda (symbol value)
1475 (set-default symbol value)
1476 (mh-identity-make-menu-no-autoload))
1478 :package-version '(MH-E . "7.1"))
1480 (defcustom-mh mh-auto-fields-list nil
1481 "List of recipients for which header lines are automatically inserted.
1483 This option can be used to set the identity depending on the
1484 recipient. To customize this option, click on the \"INS\" button and
1485 enter a regular expression for the recipient's address. Click on the
1486 \"INS\" button with the \"Add at least one item below\" label. Then choose
1487 one of the items in the \"Value Menu\".
1489 The \"Identity\" menu item is used to select an identity from those
1490 configured in `mh-identity-list'. All of the information for that
1491 identity will be added if the recipient matches. The \"Fcc Field\" menu
1492 item is used to select a folder that is used in the \"Fcc:\" header.
1493 When you send the message, MH will put a copy of your message in this
1494 folder. The \"Mail-Followup-To Field\" menu item is used to insert an
1495 \"Mail-Followup-To:\" header field with the recipients you provide. If
1496 the recipient's mail user agent supports this header field (as nmh
1497 does), then their replies will go to the addresses listed. This is
1498 useful if their replies go both to the list and to you and you don't
1499 have a mechanism to suppress duplicates. If you reply to someone not
1500 on the list, you must either remove the \"Mail-Followup-To:\" field, or
1501 ensure the recipient is also listed there so that he receives replies
1502 to your reply. Other header fields may be added using the \"Other
1505 These fields can only be added after the recipient is known. Once the
1506 header contains one or more recipients, run the
1507 \\[mh-insert-auto-fields] command or choose the \"Identity -> Insert
1508 Auto Fields\" menu item to insert these fields manually. However, you
1509 can just send the message and the fields will be added automatically.
1510 You are given a chance to see these fields and to confirm them before
1511 the message is actually sent. You can do away with this confirmation
1512 by turning off the option `mh-auto-fields-prompt-flag'.
1514 You should avoid using the same header field in `mh-auto-fields-list'
1515 and `mh-identity-list' definitions that may apply to the same message
1516 as the result is undefined."
1519 (string :tag "Recipient")
1520 (repeat :tag "Add at least one item below"
1522 (cons :tag "Identity"
1527 (function (lambda (arg) `(const ,arg)))
1528 (mapcar 'car mh-identity-list))))
1529 (cons :tag "Fcc Field"
1531 (string :tag "Value"))
1532 (cons :tag "Mail-Followup-To Field"
1533 (const "Mail-Followup-To")
1534 (string :tag "Value"))
1535 (cons :tag "Other Field"
1536 (string :tag "Field")
1537 (string :tag "Value"))))))
1539 :package-version '(MH-E . "7.3"))
1541 (defcustom-mh mh-auto-fields-prompt-flag t
1542 "*Non-nil means to prompt before sending if fields inserted.
1543 See `mh-auto-fields-list'."
1546 :package-version '(MH-E . "8.0"))
1548 (defcustom-mh mh-identity-default nil
1549 "Default identity to use when `mh-letter-mode' is called.
1550 See `mh-identity-list'."
1553 (cons '(const :tag "None" nil)
1554 (mapcar (function (lambda (arg) `(const ,arg)))
1555 (mapcar 'car mh-identity-list))))
1557 :package-version '(MH-E . "7.1"))
1559 (defcustom-mh mh-identity-handlers
1560 '(("From" . mh-identity-handler-top)
1561 (":default" . mh-identity-handler-bottom)
1562 (":attribution-verb" . mh-identity-handler-attribution-verb)
1563 (":signature" . mh-identity-handler-signature)
1564 (":pgg-default-user-id" . mh-identity-handler-gpg-identity))
1565 "Handler functions for fields in `mh-identity-list'.
1567 This option is used to change the way that fields, signatures,
1568 and attributions in `mh-identity-list' are added. To customize
1569 `mh-identity-handlers', replace the name of an existing handler
1570 function associated with the field you want to change with the
1571 name of a function you have written. You can also click on an
1572 \"INS\" button and insert a field of your choice and the name of
1573 the function you have written to handle it.
1575 The \"Field\" field can be any field that you've used in your
1576 `mh-identity-list'. The special fields \":attribution-verb\",
1577 \":signature\", or \":pgg-default-user-id\" are used for the
1578 `mh-identity-list' choices \"Attribution Verb\", \"Signature\", and
1579 \"GPG Key ID\" respectively.
1581 The handler associated with the \":default\" field is used when no
1582 other field matches.
1584 The handler functions are passed two or three arguments: the
1585 FIELD itself (for example, \"From\"), or one of the special
1586 fields (for example, \":signature\"), and the ACTION 'remove or
1587 'add. If the action is 'add, an additional argument
1588 containing the VALUE for the field is given."
1589 :type '(repeat (cons (string :tag "Field") function))
1591 :package-version '(MH-E . "8.0"))
1593 ;;; Incorporating Your Mail (:group 'mh-inc)
1595 (defcustom-mh mh-inc-prog "inc"
1596 "*Program to incorporate new mail into a folder.
1598 This program generates a one-line summary for each of the new
1599 messages. Unless it is an absolute pathname, the file is assumed
1600 to be in the `mh-progs' directory. You may also link a file to
1601 \"inc\" that uses a different format. You'll then need to modify
1602 several scan line format variables appropriately."
1605 :package-version '(MH-E . "6.0"))
1608 (unless (fboundp 'mh-inc-spool-make-no-autoload)
1609 (defun mh-inc-spool-make-no-autoload ()
1610 "Temporary definition.
1611 Real definition will take effect when mh-inc is loaded."
1614 (defcustom-mh mh-inc-spool-list nil
1615 "*Alternate spool files.
1617 You can use the `mh-inc-spool-list' variable to direct MH-E to
1618 retrieve mail from arbitrary spool files other than your system
1619 mailbox, file it in folders other than your \"+inbox\", and assign
1620 key bindings to incorporate this mail.
1622 Suppose you are subscribed to the \"mh-e-devel\" mailing list and
1623 you use \"procmail\" to filter this mail into \"~/mail/mh-e\" with
1624 the following recipe in \".procmailrc\":
1628 * ^From mh-e-devel-admin@stop.mail-abuse.org
1631 In order to incorporate \"~/mail/mh-e\" into \"+mh-e\" with an
1632 \"I m\" (mh-inc-spool-mh-e) command, customize this option, and click
1633 on the \"INS\" button. Enter a \"Spool File\" of \"~/mail/mh-e\", a
1634 \"Folder\" of \"mh-e\", and a \"Key Binding\" of \"m\".
1636 You can use \"xbuffy\" to automate the incorporation of this mail
1637 using the Emacs 22 command \"emacsclient\" as follows:
1644 command emacsclient --eval '(mh-inc-spool-mh-e)'
1646 In XEmacs, the command \"gnuclient\" is used in a similar
1648 :type '(repeat (list (file :tag "Spool File")
1649 (string :tag "Folder")
1650 (character :tag "Key Binding")))
1651 :set (lambda (symbol value)
1652 (set-default symbol value)
1653 (mh-inc-spool-make-no-autoload))
1655 :package-version '(MH-E . "7.3"))
1657 ;;; Dealing with Junk Mail (:group 'mh-junk)
1659 (defvar mh-junk-choice nil
1660 "Chosen spam fighting program.")
1662 ;; Available spam filter interfaces
1663 (defvar mh-junk-function-alist
1664 '((spamassassin mh-spamassassin-blacklist mh-spamassassin-whitelist)
1665 (bogofilter mh-bogofilter-blacklist mh-bogofilter-whitelist)
1666 (spamprobe mh-spamprobe-blacklist mh-spamprobe-whitelist))
1667 "Available choices of spam programs to use.
1669 This is an alist. For each element there are functions that
1670 blacklist a message as spam and whitelist a message incorrectly
1671 classified as spam.")
1673 (defun mh-junk-choose (symbol value)
1674 "Choose spam program to use.
1676 The function is always called with SYMBOL bound to
1677 `mh-junk-program' and VALUE bound to the new value of
1678 `mh-junk-program'. The function sets the variable
1679 `mh-junk-choice' in addition to `mh-junk-program'."
1680 (set symbol value) ;XXX shouldn't this be set-default?
1681 (setq mh-junk-choice
1683 (loop for element in mh-junk-function-alist
1684 until (executable-find (symbol-name (car element)))
1685 finally return (car element)))))
1687 (defcustom-mh mh-junk-background nil
1688 "If on, spam programs are run in background.
1690 By default, the programs are run in the foreground, but this can
1691 be slow when junking large numbers of messages. If you have
1692 enough memory or don't junk that many messages at the same time,
1693 you might try turning on this option (that is, setting its value to 0).
1694 If the value is t, the programs' output is saved in the MH-E log buffer;
1695 this may be useful for debugging."
1696 :type '(choice (const :tag "Off" nil)
1697 (const :tag "On" 0))
1699 :package-version '(MH-E . "8.0"))
1701 (defcustom-mh mh-junk-disposition nil
1702 "Disposition of junk mail."
1703 :type '(choice (const :tag "Delete Spam" nil)
1704 (string :tag "Spam Folder"))
1706 :package-version '(MH-E . "8.0"))
1708 (defcustom-mh mh-junk-program nil
1709 "Spam program that MH-E should use.
1711 The default setting of this option is \"Auto-detect\" which means
1712 that MH-E will automatically choose one of SpamAssassin,
1713 bogofilter, or SpamProbe in that order. If, for example, you have
1714 both SpamAssassin and bogofilter installed and you want to use
1715 bogofilter, then you can set this option to \"Bogofilter\"."
1716 :type '(choice (const :tag "Auto-detect" nil)
1717 (const :tag "SpamAssassin" spamassassin)
1718 (const :tag "Bogofilter" bogofilter)
1719 (const :tag "SpamProbe" spamprobe))
1720 :set 'mh-junk-choose
1722 :package-version '(MH-E . "7.3"))
1724 ;;; Editing a Draft (:group 'mh-letter)
1726 (defcustom-mh mh-compose-insertion (if (locate-library "mml") 'mml 'mh)
1727 "Type of tags used when composing MIME messages.
1729 In addition to MH-style directives, MH-E also supports MML (MIME
1730 Meta Language) tags. (see Info node `(emacs-mime)Composing').
1731 This option can be used to choose between them. By default, this
1732 option is set to \"MML\" if it is supported since it provides a
1733 lot more functionality. This option can also be set to \"MH\" if
1734 MH-style directives are preferred."
1735 :type '(choice (const :tag "MML" mml)
1736 (const :tag "MH" mh))
1738 :package-version '(MH-E . "7.0"))
1740 (defcustom-mh mh-compose-skipped-header-fields
1741 '("From" "Organization" "References" "In-Reply-To"
1742 "X-Face" "Face" "X-Image-URL" "X-Mailer")
1743 "List of header fields to skip over when navigating in draft."
1744 :type '(repeat (string :tag "Field"))
1746 :package-version '(MH-E . "7.4"))
1748 (defcustom-mh mh-compose-space-does-completion-flag nil
1749 "*Non-nil means \\<mh-letter-mode-map>\\[mh-letter-complete-or-space] does completion in message header."
1752 :package-version '(MH-E . "7.4"))
1754 (defcustom-mh mh-delete-yanked-msg-window-flag nil
1755 "*Non-nil means delete any window displaying the message.
1757 This deletes the window containing the original message after
1758 yanking it with \\<mh-letter-mode-map>\\[mh-yank-cur-msg] to make
1759 more room on your screen for your reply."
1762 :package-version '(MH-E . "7.0"))
1764 (defcustom-mh mh-extract-from-attribution-verb "wrote:"
1765 "*Verb to use for attribution when a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg].
1767 The attribution consists of the sender's name and email address
1768 followed by the content of this option. This option can be set to
1769 \"wrote:\", \"a écrit:\", and \"schrieb:\". You can also use the
1770 \"Custom String\" menu item to enter your own verb."
1771 :type '(choice (const "wrote:")
1774 (string :tag "Custom String"))
1776 :package-version '(MH-E . "7.0"))
1778 (defcustom-mh mh-ins-buf-prefix "> "
1779 "*String to put before each line of a yanked or inserted message.
1781 The prefix \"> \" is the default setting of this option. I
1782 suggest that you not modify this option since it is used by many
1783 mailers and news readers: messages are far easier to read if
1784 several included messages have all been indented by the same
1787 This prefix is not inserted if you use one of the supercite
1788 flavors of `mh-yank-behavior' or you have added a
1789 `mail-citation-hook'."
1792 :package-version '(MH-E . "6.0"))
1794 (defcustom-mh mh-letter-complete-function 'ispell-complete-word
1795 "*Function to call when completing outside of address or folder fields.
1797 In the body of the message,
1798 \\<mh-letter-mode-map>\\[mh-letter-complete] runs this function,
1799 which is set to \"ispell-complete-word\" by default."
1800 :type '(choice function (const nil))
1802 :package-version '(MH-E . "7.1"))
1804 (defcustom-mh mh-letter-fill-column 72
1805 "*Fill column to use in MH Letter mode.
1807 By default, this option is 72 to allow others to quote your
1808 message without line wrapping."
1811 :package-version '(MH-E . "6.0"))
1813 (defcustom-mh mh-mml-method-default (if mh-pgp-support-flag "pgpmime" "none")
1814 "Default method to use in security tags.
1816 This option is used to select between a variety of mail security
1817 mechanisms. The default is \"PGP (MIME)\" if it is supported\;
1818 otherwise, the default is \"None\". Other mechanisms include
1819 vanilla \"PGP\" and \"S/MIME\".
1821 The `pgg' customization group may have some settings which may
1822 interest you (see Info node `(pgg)').
1824 In particular, I turn on the option `pgg-encrypt-for-me' so that
1825 all messages I encrypt are encrypted with my public key as well.
1826 If you keep a copy of all of your outgoing mail with a \"Fcc:\"
1827 header field, this setting is vital so that you can read the mail
1829 :type '(choice (const :tag "PGP (MIME)" "pgpmime")
1830 (const :tag "PGP" "pgp")
1831 (const :tag "S/MIME" "smime")
1832 (const :tag "None" "none"))
1834 :package-version '(MH-E . "8.0"))
1836 (defcustom-mh mh-signature-file-name "~/.signature"
1837 "*Source of user's signature.
1839 By default, the text of your signature is taken from the file
1840 \"~/.signature\". You can read from other sources by changing this
1841 option. This file may contain a vCard in which case an attachment is
1842 added with the vCard.
1844 This option may also be a symbol, in which case that function is
1845 called. You may not want a signature separator to be added for you;
1846 instead you may want to insert one yourself. Options that you may find
1847 useful to do this include `mh-signature-separator' (when inserting a
1848 signature separator) and `mh-signature-separator-regexp' (for finding
1849 said separator). The function `mh-signature-separator-p', which
1850 reports t if the buffer contains a separator, may be useful as well.
1852 The signature is inserted into your message with the command
1853 \\<mh-letter-mode-map>\\[mh-insert-signature] or with the option
1854 `mh-identity-list'."
1857 :package-version '(MH-E . "6.0"))
1859 (defcustom-mh mh-signature-separator-flag t
1860 "*Non-nil means a signature separator should be inserted.
1862 It is not recommended that you change this option since various
1863 mail user agents, including MH-E, use the separator to present
1864 the signature differently, and to suppress the signature when
1865 replying or yanking a letter into a draft."
1868 :package-version '(MH-E . "8.0"))
1870 (defcustom-mh mh-x-face-file "~/.face"
1871 "*File containing face header field to insert in outgoing mail.
1873 If the file starts with either of the strings \"X-Face:\", \"Face:\"
1874 or \"X-Image-URL:\" then the contents are added to the message header
1875 verbatim. Otherwise it is assumed that the file contains the value of
1876 the \"X-Face:\" header field.
1878 The \"X-Face:\" header field, which is a low-resolution, black and
1879 white image, can be generated using the \"compface\" command (see URL
1880 `ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.Z'). The
1881 \"Online X-Face Converter\" is a useful resource for quick conversion
1882 of images into \"X-Face:\" header fields (see URL
1883 `http://www.dairiki.org/xface/').
1885 Use the \"make-face\" script to convert a JPEG image to the higher
1886 resolution, color, \"Face:\" header field (see URL
1887 `http://quimby.gnus.org/circus/face/make-face').
1889 The URL of any image can be used for the \"X-Image-URL:\" field and no
1890 processing of the image is required.
1892 To prevent the setting of any of these header fields, either set
1893 `mh-x-face-file' to nil, or simply ensure that the file defined by
1894 this option doesn't exist."
1897 :package-version '(MH-E . "7.0"))
1899 (defcustom-mh mh-yank-behavior 'attribution
1900 "*Controls which part of a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg].
1902 To include the entire message, including the entire header, use
1903 \"Body and Header\". Use \"Body\" to yank just the body without
1904 the header. To yank only the portion of the message following the
1905 point, set this option to \"Below Point\".
1907 Choose \"Invoke supercite\" to pass the entire message and header
1910 If the \"Body With Attribution\" setting is used, then the
1911 message minus the header is yanked and a simple attribution line
1912 is added at the top using the value of the option
1913 `mh-extract-from-attribution-verb'. This is the default.
1915 If the \"Invoke supercite\" or \"Body With Attribution\" settings
1916 are used, the \"-noformat\" argument is passed to the \"repl\"
1917 program to override a \"-filter\" or \"-format\" argument. These
1918 settings also have \"Automatically\" variants that perform the
1919 action automatically when you reply so that you don't need to use
1920 \\[mh-yank-cur-msg] at all. Note that this automatic action is
1921 only performed if the show buffer matches the message being
1922 replied to. People who use the automatic variants tend to turn on
1923 the option `mh-delete-yanked-msg-window-flag' as well so that the
1924 show window is never displayed.
1926 If the show buffer has a region, the option `mh-yank-behavior' is
1927 ignored unless its value is one of Attribution variants in which
1928 case the attribution is added to the yanked region.
1930 If this option is set to one of the supercite flavors, the hook
1931 `mail-citation-hook' is ignored and `mh-ins-buf-prefix' is not
1933 :type '(choice (const :tag "Body and Header" t)
1934 (const :tag "Body" body)
1935 (const :tag "Below Point" nil)
1936 (const :tag "Invoke supercite" supercite)
1937 (const :tag "Invoke supercite, Automatically" autosupercite)
1938 (const :tag "Body With Attribution" attribution)
1939 (const :tag "Body With Attribution, Automatically"
1942 :package-version '(MH-E . "8.0"))
1944 ;;; Ranges (:group 'mh-ranges)
1946 (defcustom-mh mh-interpret-number-as-range-flag t
1947 "*Non-nil means interpret a number as a range.
1949 Since one of the most frequent ranges used is \"last:N\", MH-E
1950 will interpret input such as \"200\" as \"last:200\" if this
1951 option is on (which is the default). If you need to scan just the
1952 message 200, then use the range \"200:200\"."
1955 :package-version '(MH-E . "7.4"))
1957 ;;; Scan Line Formats (:group 'mh-scan-line-formats)
1960 (unless (fboundp 'mh-adaptive-cmd-note-flag-check)
1961 (defun mh-adaptive-cmd-note-flag-check (symbol value)
1962 "Temporary definition.
1963 Real definition, below, uses variables that aren't defined yet."
1964 (set-default symbol value))))
1966 (defcustom-mh mh-adaptive-cmd-note-flag t
1967 "*Non-nil means that the message number width is determined dynamically.
1969 If you've created your own format to handle long message numbers,
1970 you'll be pleased to know you no longer need it since MH-E adapts its
1971 internal format based upon the largest message number if this option
1972 is on (the default). This option may only be turned on when
1973 `mh-scan-format-file' is set to \"Use MH-E scan Format\".
1975 If you prefer fixed-width message numbers, turn off this option and
1976 call `mh-set-cmd-note' with the width specified by your format file
1977 \(see `mh-scan-format-file'). For example, the default width is 4, so
1978 you would use \"(mh-set-cmd-note 4)\"."
1980 :group 'mh-scan-line-formats
1981 :set 'mh-adaptive-cmd-note-flag-check
1982 :package-version '(MH-E . "7.0"))
1984 (defun mh-scan-format-file-check (symbol value)
1985 "Check if desired setting is legal.
1986 Throw an error if user tries to set `mh-scan-format-file' to
1987 anything but t when `mh-adaptive-cmd-note-flag' is on. Otherwise,
1988 set SYMBOL to VALUE."
1989 (if (and (not (eq value t))
1990 mh-adaptive-cmd-note-flag)
1991 (error "%s %s" "You must turn off `mh-adaptive-cmd-note-flag'"
1992 "unless you use \"Use MH-E scan Format\"")
1993 (set-default symbol value)))
1995 (defcustom-mh mh-scan-format-file t
1996 "Specifies the format file to pass to the scan program.
1998 The default setting for this option is \"Use MH-E scan Format\". This
1999 means that the format string will be taken from the either
2000 `mh-scan-format-mh' or `mh-scan-format-nmh' depending on whether MH or
2001 nmh (or GNU mailutils) is in use. This setting also enables you to
2002 turn on the `mh-adaptive-cmd-note-flag' option.
2004 You can also set this option to \"Use Default scan Format\" to get the
2005 same output as you would get if you ran \"scan\" from the shell. If
2006 you have a format file that you want MH-E to use but not MH, you can
2007 set this option to \"Specify a scan Format File\" and enter the name
2008 of your format file.
2010 If you change the format of the scan lines you'll need to tell MH-E
2011 how to parse the new format. As you will see, quite a lot of variables
2012 are involved to do that. Use \"\\[apropos] RET mh-scan.*regexp\" to
2013 obtain a list of these variables. You will also have to call
2014 `mh-set-cmd-note' if your notations are not in column 4 (columns in
2015 Emacs start with 0)."
2016 :type '(choice (const :tag "Use MH-E scan Format" t)
2017 (const :tag "Use Default scan Format" nil)
2018 (file :tag "Specify a scan Format File"))
2019 :group 'mh-scan-line-formats
2020 :set 'mh-scan-format-file-check
2021 :package-version '(MH-E . "6.0"))
2023 (defun mh-adaptive-cmd-note-flag-check (symbol value)
2024 "Check if desired setting is legal.
2025 Throw an error if user tries to turn on
2026 `mh-adaptive-cmd-note-flag' when `mh-scan-format-file' isn't t.
2027 Otherwise, set SYMBOL to VALUE."
2029 (not (eq mh-scan-format-file t)))
2030 (error "%s %s" "Can't turn on unless `mh-scan-format-file'"
2031 "is set to \"Use MH-E scan Format\"")
2032 (set-default symbol value)))
2034 (defcustom-mh mh-scan-prog "scan"
2035 "*Program used to scan messages.
2037 The name of the program that generates a listing of one line per
2038 message is held in this option. Unless this variable contains an
2039 absolute pathname, it is assumed to be in the `mh-progs'
2040 directory. You may link another program to `scan' (see
2041 \"mh-profile(5)\") to produce a different type of listing."
2043 :group 'mh-scan-line-formats
2044 :package-version '(MH-E . "6.0"))
2045 (make-variable-buffer-local 'mh-scan-prog)
2047 ;;; Searching (:group 'mh-search)
2049 (defcustom-mh mh-search-program nil
2050 "Search program that MH-E shall use.
2052 The default setting of this option is \"Auto-detect\" which means
2053 that MH-E will automatically choose one of swish++, swish-e,
2054 mairix, namazu, pick and grep in that order. If, for example, you
2055 have both swish++ and mairix installed and you want to use
2056 mairix, then you can set this option to \"mairix\".
2058 More information about setting up an indexing program to use with
2059 MH-E can be found in the documentation of `mh-search'."
2060 :type '(choice (const :tag "Auto-detect" nil)
2061 (const :tag "swish++" swish++)
2062 (const :tag "swish-e" swish)
2063 (const :tag "mairix" mairix)
2064 (const :tag "namazu" namazu)
2065 (const :tag "pick" pick)
2066 (const :tag "grep" grep))
2068 :package-version '(MH-E . "8.0"))
2070 ;;; Sending Mail (:group 'mh-sending-mail)
2072 (defcustom-mh mh-compose-forward-as-mime-flag t
2073 "*Non-nil means that messages are forwarded as attachments.
2075 By default, this option is on which means that the forwarded
2076 messages are included as attachments. If you would prefer to
2077 forward your messages verbatim (as text, inline), then turn off
2078 this option. Forwarding messages verbatim works well for short,
2079 textual messages, but your recipient won't be able to view any
2080 non-textual attachments that were in the forwarded message. Be
2081 aware that if you have \"forw: -mime\" in your MH profile, then
2082 forwarded messages will always be included as attachments
2083 regardless of the settings of this option."
2085 :group 'mh-sending-mail
2086 :package-version '(MH-E . "8.0"))
2088 (defcustom-mh mh-compose-letter-function nil
2089 "Invoked when starting a new draft.
2091 However, it is the last function called before you edit your
2092 message. The consequence of this is that you can write a function
2093 to write and send the message for you. This function is passed
2094 three arguments: the contents of the TO, SUBJECT, and CC header
2096 :type '(choice (const nil) function)
2097 :group 'mh-sending-mail
2098 :package-version '(MH-E . "6.0"))
2100 (defcustom-mh mh-compose-prompt-flag nil
2101 "*Non-nil means prompt for header fields when composing a new draft."
2103 :group 'mh-sending-mail
2104 :package-version '(MH-E . "7.4"))
2106 (defcustom-mh mh-forward-subject-format "%s: %s"
2107 "*Format string for forwarded message subject.
2109 This option is a string which includes two escapes (\"%s\"). The
2110 first \"%s\" is replaced with the sender of the original message,
2111 and the second one is replaced with the original \"Subject:\"."
2113 :group 'mh-sending-mail
2114 :package-version '(MH-E . "6.0"))
2116 (defcustom-mh mh-insert-x-mailer-flag t
2117 "*Non-nil means append an \"X-Mailer:\" header field to the header.
2119 This header field includes the version of MH-E and Emacs that you
2120 are using. If you don't want to participate in our marketing, you
2121 can turn this option off."
2123 :group 'mh-sending-mail
2124 :package-version '(MH-E . "7.0"))
2126 (defcustom-mh mh-redist-full-contents-flag nil
2127 "*Non-nil means the \"dist\" command needs entire letter for redistribution.
2129 This option must be turned on if \"dist\" requires the whole
2130 letter for redistribution, which is the case if \"send\" is
2131 compiled with the BERK option (which many people abhor). If you
2132 find that MH will not allow you to redistribute a message that
2133 has been redistributed before, turn off this option."
2135 :group 'mh-sending-mail
2136 :package-version '(MH-E . "8.0"))
2138 (defcustom-mh mh-reply-default-reply-to nil
2139 "*Sets the person or persons to whom a reply will be sent.
2141 This option is set to \"Prompt\" by default so that you are
2142 prompted for the recipient of a reply. If you find that most of
2143 the time that you specify \"cc\" when you reply to a message, set
2144 this option to \"cc\". Other choices include \"from\", \"to\", or
2145 \"all\". You can always edit the recipients in the draft."
2146 :type '(choice (const :tag "Prompt" nil)
2151 :group 'mh-sending-mail
2152 :package-version '(MH-E . "6.0"))
2154 (defcustom-mh mh-reply-show-message-flag t
2155 "*Non-nil means the MH-Show buffer is displayed when replying.
2157 If you include the message automatically, you can hide the
2158 MH-Show buffer by turning off this option.
2160 See also `mh-reply'."
2162 :group 'mh-sending-mail
2163 :package-version '(MH-E . "7.0"))
2165 ;;; Sequences (:group 'mh-sequences)
2167 ;; If `mh-unpropagated-sequences' becomes a defcustom, add the following to
2168 ;; the docstring: "Additional sequences that should not to be preserved can be
2169 ;; specified by setting `mh-unpropagated-sequences' appropriately." XXX
2171 (defcustom-mh mh-refile-preserves-sequences-flag t
2172 "*Non-nil means that sequences are preserved when messages are refiled.
2174 If a message is in any sequence (except \"Previous-Sequence:\"
2175 and \"cur\") when it is refiled, then it will still be in those
2176 sequences in the destination folder. If this behavior is not
2177 desired, then turn off this option."
2179 :group 'mh-sequences
2180 :package-version '(MH-E . "7.4"))
2182 (defcustom-mh mh-tick-seq 'tick
2183 "The name of the MH sequence for ticked messages.
2185 You can customize this option if you already use the \"tick\"
2186 sequence for your own use. You can also disable all of the
2187 ticking functions by choosing the \"Disable Ticking\" item but
2188 there isn't much advantage to that."
2189 :type '(choice (const :tag "Disable Ticking" nil)
2191 :group 'mh-sequences
2192 :package-version '(MH-E . "7.3"))
2194 (defcustom-mh mh-update-sequences-after-mh-show-flag t
2195 "*Non-nil means flush MH sequences to disk after message is shown\\<mh-folder-mode-map>.
2197 Three sequences are maintained internally by MH-E and pushed out
2198 to MH when a message is shown. They include the sequence
2199 specified by your \"Unseen-Sequence:\" profile entry, \"cur\",
2200 and the sequence listed by the option `mh-tick-seq' which is
2201 \"tick\" by default. If you do not like this behavior, turn off
2202 this option. You can then update the state manually with the
2203 \\[mh-execute-commands], \\[mh-quit], or \\[mh-update-sequences]
2206 :group 'mh-sequences
2207 :package-version '(MH-E . "7.0"))
2209 ;;; Reading Your Mail (:group 'mh-show)
2211 (defcustom-mh mh-bury-show-buffer-flag t
2212 "*Non-nil means show buffer is buried.
2214 One advantage of not burying the show buffer is that one can
2215 delete the show buffer more easily in an electric buffer list
2216 because of its proximity to its associated MH-Folder buffer. Try
2217 running \\[electric-buffer-list] to see what I mean."
2220 :package-version '(MH-E . "7.0"))
2222 (defcustom-mh mh-clean-message-header-flag t
2223 "*Non-nil means remove extraneous header fields.
2225 See also `mh-invisible-header-fields-default' and
2226 `mh-invisible-header-fields'."
2229 :package-version '(MH-E . "7.0"))
2231 (defcustom-mh mh-decode-mime-flag (not (not (locate-library "mm-decode")))
2232 "*Non-nil means attachments are handled\\<mh-folder-mode-map>.
2234 MH-E can handle attachments as well if the Gnus `mm-decode'
2235 library is present. If so, this option will be on. Otherwise,
2236 you'll see the MIME body parts rather than text or attachments.
2237 There isn't much point in turning off this option; however, you
2238 can inspect it if it appears that the body parts are not being
2239 interpreted correctly or toggle it with the command
2240 \\[mh-toggle-mh-decode-mime-flag] to view the raw message.
2242 This option also controls the display of quoted-printable
2243 messages and other graphical widgets. See the options
2244 `mh-graphical-smileys-flag' and `mh-graphical-emphasis-flag'."
2247 :package-version '(MH-E . "7.0"))
2249 (defcustom-mh mh-display-buttons-for-alternatives-flag nil
2250 "*Non-nil means display buttons for all alternative attachments.
2252 Sometimes, a mail program will produce multiple alternatives of
2253 the attachment in increasing degree of faithfulness to the
2254 original content. By default, only the preferred alternative is
2255 displayed. If this option is on, then the preferred part is shown
2256 inline and buttons are shown for each of the other alternatives."
2259 :package-version '(MH-E . "7.4"))
2261 (defcustom-mh mh-display-buttons-for-inline-parts-flag nil
2262 "*Non-nil means display buttons for all inline attachments\\<mh-folder-mode-map>.
2264 The sender can request that attachments should be viewed inline so
2265 that they do not really appear like an attachment at all to the
2266 reader. Most of the time, this is desirable, so by default MH-E
2267 suppresses the buttons for inline attachments. On the other hand, you
2268 may receive code or HTML which the sender has added to his message as
2269 inline attachments so that you can read them in MH-E. In this case, it
2270 is useful to see the buttons so that you know you don't have to cut
2271 and paste the code into a file; you can simply save the attachment.
2273 If you want to make the buttons visible for inline attachments, you
2274 can use the command \\[mh-toggle-mime-buttons] to toggle the
2275 visibility of these buttons. You can turn on these buttons permanently
2276 by turning on this option.
2278 MH-E cannot display all attachments inline however. It can display
2279 text (including HTML) and images."
2282 :package-version '(MH-E . "7.0"))
2284 (defcustom-mh mh-do-not-confirm-flag nil
2285 "*Non-nil means non-reversible commands do not prompt for confirmation.
2287 Commands such as `mh-pack-folder' prompt to confirm whether to
2288 process outstanding moves and deletes or not before continuing.
2289 Turning on this option means that these actions will be
2290 performed--which is usually desired but cannot be
2291 retracted--without question."
2294 :package-version '(MH-E . "7.0"))
2296 (defcustom-mh mh-fetch-x-image-url nil
2297 "*Control fetching of \"X-Image-URL:\" header field image.
2299 Ths option controls the fetching of the \"X-Image-URL:\" header
2300 field image with the following values:
2303 You are prompted before the image is fetched. MH-E will
2304 remember your reply and will either use the already fetched
2305 image the next time the same URL is encountered or silently
2306 skip it if you didn't fetch it the first time. This is a
2310 Images are never fetched and only displayed if they are
2311 already present in the cache. This is the default.
2313 There isn't a value of \"Always Fetch\" for privacy and DOS (denial of
2314 service) reasons. For example, fetching a URL can tip off a spammer
2315 that you've read his email (which is why you shouldn't blindly answer
2316 yes if you've set this option to \"Ask Before Fetching\"). Someone may
2317 also flood your network and fill your disk drive by sending a torrent
2318 of messages, each specifying a unique URL to a very large file.
2320 The cache of images is found in the directory \".mhe-x-image-cache\"
2321 within your MH directory. You can add your own face to the \"From:\"
2322 field too. See Info node `(mh-e)Picture'.
2324 This setting only has effect if the option `mh-show-use-xface-flag' is
2327 :type '(choice (const :tag "Ask Before Fetching" ask)
2328 (const :tag "Never Fetch" nil))
2330 :package-version '(MH-E . "7.3"))
2332 (defcustom-mh mh-graphical-smileys-flag t
2333 "*Non-nil means graphical smileys are displayed.
2335 It is a long standing custom to inject body language using a
2336 cornucopia of punctuation, also known as the \"smileys\". MH-E
2337 can render these as graphical widgets if this option is turned
2338 on, which it is by default. Smileys include patterns such as :-)
2341 This option is disabled if the option `mh-decode-mime-flag' is
2345 :package-version '(MH-E . "7.0"))
2347 (defcustom-mh mh-graphical-emphasis-flag t
2348 "*Non-nil means graphical emphasis is displayed.
2350 A few typesetting features are indicated in ASCII text with
2351 certain characters. If your terminal supports it, MH-E can render
2352 these typesetting directives naturally if this option is turned
2353 on, which it is by default. For example, _underline_ will be
2354 underlined, *bold* will appear in bold, /italics/ will appear in
2355 italics, and so on. See the option `gnus-emphasis-alist' for the
2358 This option is disabled if the option `mh-decode-mime-flag' is
2362 :package-version '(MH-E . "7.0"))
2364 (defcustom-mh mh-highlight-citation-style 'gnus
2365 "Style for highlighting citations.
2367 If the sender of the message has cited other messages in his
2368 message, then MH-E will highlight these citations to emphasize
2369 the sender's actual response. This option can be customized to
2370 change the highlighting style. The \"Multicolor\" method uses a
2371 different color for each indentation while the \"Monochrome\"
2372 method highlights all citations in red. To disable highlighting
2373 of citations entirely, choose \"None\"."
2374 :type '(choice (const :tag "Multicolor" gnus)
2375 (const :tag "Monochrome" font-lock)
2376 (const :tag "None" nil))
2378 :package-version '(MH-E . "8.0"))
2380 ;; Keep fields alphabetized. Mention source, if known.
2381 (defvar mh-invisible-header-fields-internal
2385 "Cancel-Lock:" ; NNTP posts
2386 "Content-" ; RFC 2045
2387 "Delivered-To:" ; Egroups/yahoogroups mailing list manager
2388 "Delivery-Date:" ; MH
2390 "DomainKey-Signature:" ;http://antispam.yahoo.com/domainkeys
2394 "Face:" ; Gnus Face header
2397 "Importance:" ; MS Outlook
2400 "List-" ; Mailman mailing list manager
2401 "List-" ; Unknown mailing list managers
2402 "List-Subscribe:" ; Unknown mailing list managers
2403 "List-Unsubscribe:" ; Unknown mailing list managers
2405 "Mailing-List:" ; Egroups/yahoogroups mailing list manager
2406 "Message-Id:" ; RFC 822
2407 "Mime-Version" ; RFC 2045
2410 "Original-Encoded-Information-Types:" ; X400
2411 "Original-Lines:" ; mail to news
2412 "Original-NNTP-" ; mail to news
2413 "Original-Newsgroups:" ; mail to news
2414 "Original-Path:" ; mail to news
2415 "Original-Received:" ; mail to news
2416 "Original-To:" ; mail to news
2417 "Original-X-" ; mail to news
2419 "P1-Content-Type:" ; X400
2420 "P1-Message-Id:" ; X400
2421 "P1-Recipient:" ; X400
2426 "Received:" ; RFC 822
2427 "Received-SPF:" ; Gmail
2432 "Return-Path:" ; RFC 822
2433 "Sensitivity:" ; MS Outlook
2434 "Status:" ; sendmail
2436 "Ua-Content-Id:" ; X400
2437 ;; "User-Agent:" ; Similar to X-Mailer, so display it.
2439 "X-AOL-IP:" ; AOL WebMail
2442 "X-Accept-Language:"
2443 "X-Accept-Language:" ; Netscape/Mozilla
2445 "X-Administrivia-To:"
2446 "X-AntiAbuse:" ; cPanel
2447 "X-Apparently-From:" ; MS Outlook
2448 "X-Apparently-To:" ; Egroups/yahoogroups mailing list manager
2449 "X-Authenticated-Sender:" ; AT&T Message Center (webmail)
2450 "X-Authentication-Warning:" ; sendmail
2451 "X-Barracuda-" ; Barracuda spam scores
2452 "X-Beenthere:" ; Mailman mailing list manager
2453 "X-Bogosity:" ; bogofilter
2454 "X-BrightmailFiltered:" ; Brightmail
2455 "X-Brightmail-Tracker:" ; Brightmail
2456 "X-Bugzilla-" ; Bugzilla
2458 "X-ContentStamp:" ; NetZero
2462 "X-EFL-Spamscore:" ; MIT alumni spam filtering
2463 "X-ELNK-Trace:" ; Earthlink mailer
2464 "X-Envelope-Date:" ; GNU mailutils
2466 "X-Envelope-Sender:"
2468 "X-Evolution:" ; Evolution mail client
2473 "X-Gnus-Mail-Source:" ; gnus
2474 "X-Greylist:" ; milter-greylist-1.2.1
2475 "X-Habeas-SWE-1:" ; Spam
2476 "X-Habeas-SWE-2:" ; Spam
2477 "X-Habeas-SWE-3:" ; Spam
2478 "X-Habeas-SWE-4:" ; Spam
2479 "X-Habeas-SWE-5:" ; Spam
2480 "X-Habeas-SWE-6:" ; Spam
2481 "X-Habeas-SWE-7:" ; Spam
2482 "X-Habeas-SWE-8:" ; Spam
2483 "X-Habeas-SWE-9:" ; Spam
2484 "X-Hashcash:" ; hashcash
2486 "X-IronPort-AV:" ; IronPort AV
2488 "X-List-Host:" ; Unknown mailing list managers
2489 "X-List-Subscribe:" ; Unknown mailing list managers
2490 "X-List-Unsubscribe:" ; Unknown mailing list managers
2491 "X-Listprocessor-" ; ListProc(tm) by CREN
2492 "X-Listserver:" ; Unknown mailing list managers
2493 "X-Loop:" ; Unknown mailing list managers
2494 "X-Lumos-SenderID:" ; Roving ConstantContact
2495 "X-MAIL-INFO:" ; NetZero
2496 "X-MB-Message-" ; AOL WebMail
2497 "X-MHE-Checksum:" ; Checksum added during index search
2498 "X-MIME-Autoconverted:" ; sendmail
2500 "X-MS-" ; MS Outlook
2501 "X-Mail-from:" ; fastmail.fm
2502 "X-MailScanner" ; ListProc(tm) by CREN
2503 "X-Mailing-List:" ; Unknown mailing list managers
2504 "X-Mailman-Approved-At:" ; Mailman mailing list manager
2505 "X-Mailman-Version:" ; Mailman mailing list manager
2506 "X-Majordomo:" ; Majordomo mailing list manager
2508 "X-MessageWall-Score:" ; Unknown mailing list manager, AUC TeX
2509 "X-MimeOLE:" ; MS Outlook
2510 "X-Mms-" ; T-Mobile pictures
2511 "X-Mozilla-Status:" ; Netscape/Mozilla
2512 "X-Msmail-" ; MS Outlook
2513 "X-NAI-Spam-" ; Network Associates Inc. SpamKiller
2516 "X-Notes-Item:" ; Lotus Notes Domino structured header
2517 "X-OperatingSystem:"
2518 ;;"X-Operator:" ; Similar to X-Mailer, so display it
2519 "X-Orcl-Content-Type:"
2520 "X-Original-Complaints-To:"
2521 "X-Original-Date:" ; SourceForge mailing list manager
2524 "X-OriginalArrivalTime:" ; Hotmail
2525 "X-Originating-IP:" ; Hotmail
2527 "X-Priority:" ; MS Outlook
2529 "X-Qotd-" ; User added
2534 "X-Resolved-to:" ; fastmail.fm
2535 "X-Return-Path-Hint:" ; Roving ConstantContact
2536 "X-Roving-" ; Roving ConstantContact
2537 "X-SA-Exim-" ; Exim SpamAssassin
2543 "X-Sasl-enc:" ; Apple Mail
2548 "X-Sieve:" ; Sieve filtering
2550 "X-Spam-" ; Spamassassin
2551 "X-SpamBouncer:" ; Spam
2559 "X-USANET-" ; usa.net
2561 "X-VSMLoop:" ; NTMail
2562 "X-Virus-Scanned" ; amavisd-new
2564 "X-WebTV-Signature:"
2565 "X-Wss-Id:" ; Worldtalk gateways
2567 "X-eGroups-" ; Egroups/yahoogroups mailing list manager
2569 "X-submission-address:"
2572 "List of default header fields that are not to be shown.
2574 Do not alter this variable directly. Instead, add entries from
2575 here that you would like to be displayed in
2576 `mh-invisible-header-fields-default' and add entries to hide in
2577 `mh-invisible-header-fields'.")
2580 (unless (fboundp 'mh-invisible-headers)
2581 (defun mh-invisible-headers ()
2582 "Temporary definition.
2583 Real definition, below, uses variables that aren't defined yet."
2586 (defvar mh-delay-invisible-header-generation-flag t
2587 "Non-nil means to delay the generation of invisible header fields.
2588 Because the function `mh-invisible-headers' uses both
2589 `mh-invisible-header-fields' and `mh-invisible-header-fields', it
2590 cannot be run until both variables have been initialized.")
2592 (defcustom-mh mh-invisible-header-fields nil
2593 "*Additional header fields to hide.
2595 Header fields that you would like to hide that aren't listed in
2596 `mh-invisible-header-fields-default' can be added to this option
2597 with a couple of caveats. Regular expressions are not allowed.
2598 Unique fields should have a \":\" suffix; otherwise, the element
2599 can be used to render invisible an entire class of fields that
2600 start with the same prefix. If you think a header field should be
2601 generally ignored, report a bug (see URL
2602 `https://sourceforge.net/tracker/?group_id=13357&atid=113357').
2604 See also `mh-clean-message-header-flag'."
2606 :type '(repeat (string :tag "Header field"))
2607 :set (lambda (symbol value)
2608 (set-default symbol value)
2609 (mh-invisible-headers))
2611 :package-version '(MH-E . "7.1"))
2613 (defcustom-mh mh-invisible-header-fields-default nil
2614 "*List of hidden header fields.
2616 The header fields listed in this option are hidden, although you
2617 can check off any field that you would like to see.
2619 Header fields that you would like to hide that aren't listed can
2620 be added to the option `mh-invisible-header-fields'.
2622 See also `mh-clean-message-header-flag'."
2623 :type `(set ,@(mapcar (lambda (x) `(const ,x))
2624 mh-invisible-header-fields-internal))
2625 :set (lambda (symbol value)
2626 (set-default symbol value)
2627 (mh-invisible-headers))
2629 :package-version '(MH-E . "8.0"))
2631 (defvar mh-invisible-header-fields-compiled nil
2632 "*Regexp matching lines in a message header that are not to be shown.
2633 Do not alter this variable directly. Instead, customize
2634 `mh-invisible-header-fields-default' checking for fields normally
2635 hidden that you wish to display, and add extra entries to hide in
2636 `mh-invisible-header-fields'.")
2638 (defun mh-invisible-headers ()
2639 "Make or remake the variable `mh-invisible-header-fields-compiled'.
2640 Done using `mh-invisible-header-fields-internal' as input, from
2641 which entries from `mh-invisible-header-fields-default' are
2642 removed and entries from `mh-invisible-header-fields' are added."
2643 (let ((fields mh-invisible-header-fields-internal))
2644 (when mh-invisible-header-fields-default
2645 ;; Remove entries from `mh-invisible-header-fields-default'
2647 (loop for x in fields
2648 unless (member x mh-invisible-header-fields-default)
2650 (when (and (boundp 'mh-invisible-header-fields)
2651 mh-invisible-header-fields)
2652 (dolist (x mh-invisible-header-fields)
2653 (unless (member x fields) (setq fields (cons x fields)))))
2655 (setq mh-invisible-header-fields-compiled
2658 ;; workaround for insufficient default
2659 (let ((max-specpdl-size 1000))
2660 (regexp-opt fields t))))
2661 (setq mh-invisible-header-fields-compiled nil))))
2663 ;; Compile invisible header fields.
2664 (mh-invisible-headers)
2666 (defcustom-mh mh-lpr-command-format "lpr -J '%s'"
2667 "*Command used to print\\<mh-folder-mode-map>.
2669 This option contains the Unix command line which performs the
2670 actual printing for the \\[mh-print-msg] command. The string can
2671 contain one escape, \"%s\", which is replaced by the name of the
2672 folder and the message number and is useful for print job names.
2673 I use \"mpage -h'%s' -b Letter -H1of -mlrtb -P\" which produces a
2674 nice header and adds a bit of margin so the text fits within my
2677 This options is not used by the commands \\[mh-ps-print-msg] or
2678 \\[mh-ps-print-msg-file]."
2681 :package-version '(MH-E . "6.0"))
2683 (defcustom-mh mh-max-inline-image-height nil
2684 "*Maximum inline image height if \"Content-Disposition:\" is not present.
2686 Some older mail programs do not insert this needed plumbing to
2687 tell MH-E whether to display the attachments inline or not. If
2688 this is the case, MH-E will display these images inline if they
2689 are smaller than the window. However, you might want to allow
2690 larger images to be displayed inline. To do this, you can change
2691 the options `mh-max-inline-image-width' and
2692 `mh-max-inline-image-height' from their default value of zero to
2693 a large number. The size of your screen is a good choice for
2695 :type '(choice (const nil) integer)
2697 :package-version '(MH-E . "7.0"))
2699 (defcustom-mh mh-max-inline-image-width nil
2700 "*Maximum inline image width if \"Content-Disposition:\" is not present.
2702 Some older mail programs do not insert this needed plumbing to
2703 tell MH-E whether to display the attachments inline or not. If
2704 this is the case, MH-E will display these images inline if they
2705 are smaller than the window. However, you might want to allow
2706 larger images to be displayed inline. To do this, you can change
2707 the options `mh-max-inline-image-width' and
2708 `mh-max-inline-image-height' from their default value of zero to
2709 a large number. The size of your screen is a good choice for
2711 :type '(choice (const nil) integer)
2713 :package-version '(MH-E . "7.0"))
2715 (defcustom-mh mh-mhl-format-file nil
2716 "*Specifies the format file to pass to the \"mhl\" program.
2718 Normally MH-E takes care of displaying messages itself (rather than
2719 calling an MH program to do the work). If you'd rather have \"mhl\"
2720 display the message (within MH-E), change this option from its default
2721 value of \"Use Default mhl Format (Printing Only)\".
2723 You can set this option to \"Use Default mhl Format\" to get the same
2724 output as you would get if you ran \"mhl\" from the shell.
2726 If you have a format file that you want MH-E to use, you can set this
2727 option to \"Specify an mhl Format File\" and enter the name of your
2728 format file. Your format file should specify a non-zero value for
2729 \"overflowoffset\" to allow MH-E to parse the header. Note that
2730 \"mhl\" is always used for printing and forwarding; in this case, the
2731 value of this option is consulted if you have specified a format
2733 :type '(choice (const :tag "Use Default mhl Format (Printing Only)" nil)
2734 (const :tag "Use Default mhl Format" t)
2735 (file :tag "Specify an mhl Format File"))
2737 :package-version '(MH-E . "8.0"))
2739 (defcustom-mh mh-mime-save-parts-default-directory t
2740 "Default directory to use for \\<mh-folder-mode-map>\\[mh-mime-save-parts].
2742 The default value for this option is \"Prompt Always\" so that
2743 you are always prompted for the directory in which to save the
2744 attachments. However, if you usually use the same directory
2745 within a session, then you can set this option to \"Prompt the
2746 First Time\" to avoid the prompt each time. you can make this
2747 directory permanent by choosing \"Directory\" and entering the
2749 :type '(choice (const :tag "Prompt the First Time" nil)
2750 (const :tag "Prompt Always" t)
2753 :package-version '(MH-E . "7.0"))
2755 (defcustom-mh mh-print-background-flag nil
2756 "*Non-nil means messages should be printed in the background\\<mh-folder-mode-map>.
2758 Normally messages are printed in the foreground. If this is slow on
2759 your system, you may elect to turn off this option to print in the
2762 WARNING: If you do this, do not delete the message until it is printed
2763 or else the output may be truncated.
2765 This option is not used by the commands \\[mh-ps-print-msg] or
2766 \\[mh-ps-print-msg-file]."
2769 :package-version '(MH-E . "7.0"))
2771 (defcustom-mh mh-show-maximum-size 0
2772 "*Maximum size of message (in bytes) to display automatically.
2774 This option provides an opportunity to skip over large messages
2775 which may be slow to load. The default value of 0 means that all
2776 message are shown regardless of size."
2779 :package-version '(MH-E . "8.0"))
2781 (defcustom-mh mh-show-use-xface-flag (>= emacs-major-version 21)
2782 "*Non-nil means display face images in MH-show buffers.
2784 MH-E can display the content of \"Face:\", \"X-Face:\", and
2785 \"X-Image-URL:\" header fields. If any of these fields occur in the
2786 header of your message, the sender's face will appear in the \"From:\"
2787 header field. If more than one of these fields appear, then the first
2788 field found in the order \"Face:\", \"X-Face:\", and \"X-Image-URL:\"
2791 The option `mh-show-use-xface-flag' is used to turn this feature on
2792 and off. This feature will be turned on by default if your system
2795 The first header field used, if present, is the Gnus-specific
2796 \"Face:\" field. The \"Face:\" field appeared in GNU Emacs 21 and
2797 XEmacs. For more information, see URL
2798 `http://quimby.gnus.org/circus/face/'. Next is the traditional
2799 \"X-Face:\" header field. The display of this field requires the
2800 \"uncompface\" program (see URL
2801 `ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.z'). Recent
2802 versions of XEmacs have internal support for \"X-Face:\" images. If
2803 your version of XEmacs does not, then you'll need both \"uncompface\"
2804 and the x-face package (see URL `ftp://ftp.jpl.org/pub/elisp/').
2806 Finally, MH-E will display images referenced by the \"X-Image-URL:\"
2807 header field if neither the \"Face:\" nor the \"X-Face:\" fields are
2808 present. The display of the images requires \"wget\" (see URL
2809 `http://www.gnu.org/software/wget/wget.html'), \"fetch\", or \"curl\"
2810 to fetch the image and the \"convert\" program from the ImageMagick
2811 suite (see URL `http://www.imagemagick.org/'). Of the three header
2812 fields this is the most efficient in terms of network usage since the
2813 image doesn't need to be transmitted with every single mail.
2815 The option `mh-fetch-x-image-url' controls the fetching of the
2816 \"X-Image-URL:\" header field image."
2819 :package-version '(MH-E . "7.0"))
2821 (defcustom-mh mh-store-default-directory nil
2822 "*Default directory for \\<mh-folder-mode-map>\\[mh-store-msg].
2824 If you would like to change the initial default directory,
2825 customize this option, change the value from \"Current\" to
2826 \"Directory\", and then enter the name of the directory for storing
2827 the content of these messages."
2828 :type '(choice (const :tag "Current" nil)
2831 :package-version '(MH-E . "6.0"))
2833 (defcustom-mh mh-summary-height nil
2834 "*Number of lines in MH-Folder buffer (including the mode line).
2836 The default value of this option is \"Automatic\" which means
2837 that the MH-Folder buffer will maintain the same proportional
2838 size if the frame is resized. If you'd prefer a fixed height,
2839 then choose the \"Fixed Size\" option and enter the number of
2840 lines you'd like to see."
2841 :type '(choice (const :tag "Automatic" nil)
2842 (integer :tag "Fixed Size"))
2844 :package-version '(MH-E . "7.4"))
2846 ;;; The Speedbar (:group 'mh-speedbar)
2848 (defcustom-mh mh-speed-update-interval 60
2849 "Time between speedbar updates in seconds.
2850 Set to 0 to disable automatic update."
2853 :package-version '(MH-E . "8.0"))
2855 ;;; Threading (:group 'mh-thread)
2857 (defcustom-mh mh-show-threads-flag nil
2858 "*Non-nil means new folders start in threaded mode.
2860 Threading large number of messages can be time consuming so this
2861 option is turned off by default. If you turn this option on, then
2862 threading will be done only if the number of messages being
2863 threaded is less than `mh-large-folder'."
2866 :package-version '(MH-E . "7.1"))
2868 ;;; The Tool Bar (:group 'mh-tool-bar)
2870 ;; mh-tool-bar-folder-buttons and mh-tool-bar-letter-buttons defined
2871 ;; dynamically in mh-tool-bar.el.
2873 (defcustom-mh mh-tool-bar-search-function 'mh-search
2874 "*Function called by the tool bar search button.
2876 By default, this is set to `mh-search'. You can also choose
2877 \"Other Function\" from the \"Value Menu\" and enter a function
2878 of your own choosing."
2879 :type '(choice (const mh-search)
2880 (function :tag "Other Function"))
2882 :package-version '(MH-E . "7.0"))
2884 ;; XEmacs has a couple of extra customizations...
2886 (defcustom-mh mh-xemacs-use-tool-bar-flag mh-xemacs-has-tool-bar-flag
2887 "*If non-nil, use tool bar.
2889 This option controls whether to show the MH-E icons at all. By
2890 default, this option is turned on if the window system supports
2891 tool bars. If your system doesn't support tool bars, then you
2892 won't be able to turn on this option."
2895 :set (lambda (symbol value)
2896 (if (and (eq value t)
2897 (not mh-xemacs-has-tool-bar-flag))
2898 (error "Tool bar not supported"))
2899 (set-default symbol value))
2900 :package-version '(MH-E . "7.3"))
2902 (defcustom-mh mh-xemacs-tool-bar-position nil
2903 "*Tool bar location.
2905 This option controls the placement of the tool bar along the four
2906 edges of the frame. You can choose from one of \"Same As Default
2907 Tool Bar\", \"Top\", \"Bottom\", \"Left\", or \"Right\". If this
2908 variable is set to anything other than \"Same As Default Tool
2909 Bar\" and the default tool bar is in a different location, then
2910 two tool bars will be displayed: the MH-E tool bar and the
2912 :type '(radio (const :tag "Same As Default Tool Bar" :value nil)
2913 (const :tag "Top" :value top)
2914 (const :tag "Bottom" :value bottom)
2915 (const :tag "Left" :value left)
2916 (const :tag "Right" :value right))
2918 :package-version '(MH-E . "7.3")))
2922 ;;; Hooks (:group 'mh-hooks + group where hook described)
2924 (defcustom-mh mh-after-commands-processed-hook nil
2925 "Hook run by \\<mh-folder-mode-map>\\[mh-execute-commands] after performing outstanding refile and delete requests.
2927 Variables that are useful in this hook include
2928 `mh-folders-changed', which lists which folders were affected by
2929 deletes and refiles. This list will always include the current
2930 folder, which is also available in `mh-current-folder'."
2934 :package-version '(MH-E . "8.0"))
2936 (defcustom-mh mh-alias-reloaded-hook nil
2937 "Hook run by `mh-alias-reload' after loading aliases."
2941 :package-version '(MH-E . "8.0"))
2943 (defcustom-mh mh-before-commands-processed-hook nil
2944 "Hook run by \\<mh-folder-mode-map>\\[mh-execute-commands] before performing outstanding refile and delete requests.
2946 Variables that are useful in this hook include `mh-delete-list'
2947 and `mh-refile-list' which can be used to see which changes will
2948 be made to the current folder, `mh-current-folder'."
2952 :package-version '(MH-E . "8.0"))
2954 (defcustom-mh mh-before-quit-hook nil
2955 "Hook run by \\<mh-folder-mode-map>\\[mh-quit] before quitting MH-E.
2957 This hook is called before the quit occurs, so you might use it
2958 to perform any MH-E operations; you could perform some query and
2959 abort the quit or call `mh-execute-commands', for example.
2961 See also `mh-quit-hook'."
2965 :package-version '(MH-E . "6.0"))
2967 (defcustom-mh mh-before-send-letter-hook nil
2968 "Hook run at the beginning of the \\<mh-letter-mode-map>\\[mh-send-letter] command.
2970 For example, if you want to check your spelling in your message
2971 before sending, add the `ispell-message' function."
2973 :options '(ispell-message)
2976 :package-version '(MH-E . "6.0"))
2978 (defcustom-mh mh-delete-msg-hook nil
2979 "Hook run by \\<mh-letter-mode-map>\\[mh-delete-msg] after marking each message for deletion.
2981 For example, a past maintainer of MH-E used this once when he
2982 kept statistics on his mail usage."
2986 :package-version '(MH-E . "6.0"))
2988 (defcustom-mh mh-find-path-hook nil
2989 "Hook run by `mh-find-path' after reading the user's MH profile.
2991 This hook can be used the change the value of the variables that
2992 `mh-find-path' sets if you need to run with different values
2993 between MH and MH-E."
2997 :package-version '(MH-E . "7.0"))
2999 (defcustom-mh mh-folder-mode-hook nil
3000 "Hook run by `mh-folder-mode' when visiting a new folder."
3004 :package-version '(MH-E . "6.0"))
3006 (defcustom-mh mh-forward-hook nil
3007 "Hook run by `mh-forward' on a forwarded letter."
3010 :group 'mh-sending-mail
3011 :package-version '(MH-E . "8.0"))
3013 (defcustom-mh mh-inc-folder-hook nil
3014 "Hook run by \\<mh-folder-mode-map>\\[mh-inc-folder] after incorporating mail into a folder."
3018 :package-version '(MH-E . "6.0"))
3020 (defcustom-mh mh-insert-signature-hook nil
3021 "Hook run by \\<mh-letter-mode-map>\\[mh-insert-signature] after signature has been inserted.
3023 Hook functions may access the actual name of the file or the
3024 function used to insert the signature with
3025 `mh-signature-file-name'."
3029 :package-version '(MH-E . "8.0"))
3031 (defcustom-mh mh-kill-folder-suppress-prompt-hooks '(mh-search-p)
3032 "Abnormal hook run at the beginning of \\<mh-folder-mode-map>\\[mh-kill-folder].
3034 The hook functions are called with no arguments and should return
3035 a non-nil value to suppress the normal prompt when you remove a
3036 folder. This is useful for folders that are easily regenerated.
3038 The default value of `mh-search-p' suppresses the prompt on
3039 folders generated by searching.
3041 WARNING: Use this hook with care. If there is a bug in your hook
3042 which returns t on \"+inbox\" and you hit \\[mh-kill-folder] by
3043 accident in the \"+inbox\" folder, you will not be happy."
3047 :package-version '(MH-E . "7.4"))
3049 (defcustom-mh mh-letter-mode-hook nil
3050 "Hook run by `mh-letter-mode' on a new letter.
3052 This hook allows you to do some processing before editing a
3053 letter. For example, you may wish to modify the header after
3054 \"repl\" has done its work, or you may have a complicated
3055 \"components\" file and need to tell MH-E where the cursor should
3059 :group 'mh-sending-mail
3060 :package-version '(MH-E . "6.0"))
3062 (defcustom-mh mh-mh-to-mime-hook nil
3063 "Hook run on the formatted letter by \\<mh-letter-mode-map>\\[mh-mh-to-mime]."
3067 :package-version '(MH-E . "8.0"))
3069 (defcustom-mh mh-search-mode-hook nil
3070 "Hook run upon entry to `mh-search-mode'\\<mh-folder-mode-map>.
3072 If you find that you do the same thing over and over when editing
3073 the search template, you may wish to bind some shortcuts to keys.
3074 This can be done with this hook which is called when
3075 \\[mh-search] is run on a new pattern."
3079 :package-version '(MH-E . "8.0"))
3081 (defcustom-mh mh-quit-hook nil
3082 "Hook run by \\<mh-folder-mode-map>\\[mh-quit] after quitting MH-E.
3084 This hook is not run in an MH-E context, so you might use it to
3085 modify the window setup.
3087 See also `mh-before-quit-hook'."
3091 :package-version '(MH-E . "6.0"))
3093 (defcustom-mh mh-refile-msg-hook nil
3094 "Hook run by \\<mh-folder-mode-map>\\[mh-refile-msg] after marking each message for refiling."
3098 :package-version '(MH-E . "6.0"))
3100 (defcustom-mh mh-show-hook nil
3101 "Hook run after \\<mh-folder-mode-map>\\[mh-show] shows a message.
3103 It is the last thing called after messages are displayed. It's
3104 used to affect the behavior of MH-E in general or when
3105 `mh-show-mode-hook' is too early. See `mh-show-mode-hook'."
3109 :package-version '(MH-E . "6.0"))
3111 (defcustom-mh mh-show-mode-hook nil
3112 "Hook run upon entry to `mh-show-mode'.
3114 This hook is called early on in the process of the message
3115 display. It is usually used to perform some action on the
3116 message's content. See `mh-show-hook'."
3120 :package-version '(MH-E . "6.0"))
3122 (defcustom-mh mh-unseen-updated-hook nil
3123 "Hook run after the unseen sequence has been updated.
3125 The variable `mh-seen-list' can be used by this hook to obtain
3126 the list of messages which were removed from the unseen
3130 :group 'mh-sequences
3131 :package-version '(MH-E . "6.0"))
3135 ;;; Faces (:group 'mh-faces + group where faces described)
3137 (if (boundp 'facemenu-unlisted-faces)
3138 (add-to-list 'facemenu-unlisted-faces "^mh-"))
3140 ;; To add a new face:
3141 ;; 1. Add entry to variable mh-face-data.
3142 ;; 2. Create face using defface-mh (which removes min-color spec and
3143 ;; :package-version keyword where these are not supported),
3144 ;; accessing face data with function mh-face-data.
3145 ;; 3. Add inherit argument to function mh-face-data if applicable.
3146 (defvar mh-face-data
3147 '((mh-folder-followup
3148 ((((class color) (background light))
3149 (:foreground "blue3"))
3150 (((class color) (background dark))
3151 (:foreground "LightGoldenRod"))
3154 (mh-folder-msg-number
3155 ((((class color) (min-colors 64) (background light))
3156 (:foreground "snow4"))
3157 (((class color) (min-colors 64) (background dark))
3158 (:foreground "snow3"))
3159 (((class color) (background light))
3160 (:foreground "purple"))
3161 (((class color) (background dark))
3162 (:foreground "cyan"))))
3164 ((((class color) (min-colors 64) (background light))
3165 (:foreground "DarkGoldenrod"))
3166 (((class color) (min-colors 64) (background dark))
3167 (:foreground "LightGoldenrod"))
3169 (:foreground "yellow" :weight light))
3170 (((class grayscale) (background light))
3171 (:foreground "Gray90" :bold t :italic t))
3172 (((class grayscale) (background dark))
3173 (:foreground "DimGray" :bold t :italic t))
3175 (:bold t :italic t))))
3177 ((((class color) (background light))
3178 (:foreground "blue4"))
3179 (((class color) (background dark))
3180 (:foreground "yellow"))
3184 ((((class color) (background light))
3185 (:background "#dddf7e"))
3186 (((class color) (background dark))
3187 (:background "#dddf7e"))
3191 ((((class color) (min-colors 64) (background light))
3192 (:foreground "RosyBrown"))
3193 (((class color) (min-colors 64) (background dark))
3194 (:foreground "LightSalmon"))
3196 (:foreground "green"))
3197 (((class grayscale) (background light))
3198 (:foreground "DimGray" :italic t))
3199 (((class grayscale) (background dark))
3200 (:foreground "LightGray" :italic t))
3203 (mh-letter-header-field
3204 ((((class color) (background light))
3205 (:background "gray90"))
3206 (((class color) (background dark))
3207 (:background "gray10"))
3211 ((((class color) (background light))
3212 (:foreground "dark green" :bold t))
3213 (((class color) (background dark))
3214 (:foreground "indian red" :bold t))
3218 ((((class color) (min-colors 64) (background light))
3219 (:foreground "DarkGoldenrod"))
3220 (((class color) (min-colors 64) (background dark))
3221 (:foreground "LightGoldenrod"))
3223 (:foreground "yellow" :weight light))
3224 (((class grayscale) (background light))
3225 (:foreground "Gray90" :bold t :italic t))
3226 (((class grayscale) (background dark))
3227 (:foreground "DimGray" :bold t :italic t))
3229 (:bold t :italic t))))
3231 ((((class color) (min-colors 64) (background light))
3232 (:foreground "ForestGreen"))
3233 (((class color) (min-colors 64) (background dark))
3234 (:foreground "PaleGreen"))
3236 (:foreground "green"))
3237 (((class grayscale) (background light))
3238 (:foreground "Gray90" :bold t))
3239 (((class grayscale) (background dark))
3240 (:foreground "DimGray" :bold t))
3242 (:bold t :underline t))))
3244 ((((class color) (background light))
3245 (:foreground "red3"))
3246 (((class color) (background dark))
3247 (:foreground "cyan"))
3251 ((((class color) (min-colors 64) (background light))
3252 (:foreground "RosyBrown"))
3253 (((class color) (min-colors 64) (background dark))
3254 (:foreground "LightSalmon"))
3256 (:foreground "green"))
3257 (((class grayscale) (background light))
3258 (:foreground "DimGray" :italic t))
3259 (((class grayscale) (background dark))
3260 (:foreground "LightGray" :italic t))
3263 (mh-show-pgg-bad ((t (:bold t :foreground "DeepPink1"))))
3264 (mh-show-pgg-good ((t (:bold t :foreground "LimeGreen"))))
3265 (mh-show-pgg-unknown ((t (:bold t :foreground "DarkGoldenrod2"))))
3266 (mh-show-signature ((t (:italic t))))
3268 ((((class color) (background light))
3269 (:foreground "SaddleBrown"))
3270 (((class color) (background dark))
3271 (:foreground "burlywood"))
3272 (((class grayscale) (background light))
3273 (:foreground "DimGray" :underline t))
3274 (((class grayscale) (background dark))
3275 (:foreground "LightGray" :underline t))
3276 (t (:underline t))))
3278 ((((class color) (background light))
3279 (:foreground "blue4"))
3280 (((class color) (background dark))
3281 (:foreground "light blue"))))
3282 (mh-speedbar-selected-folder
3283 ((((class color) (background light))
3284 (:foreground "red1" :underline t))
3285 (((class color) (background dark))
3286 (:foreground "red1" :underline t))
3290 Used by function `mh-face-data' which returns spec that is
3291 consumed by `defface-mh'.")
3295 (defvar mh-inherit-face-flag (assq :inherit custom-face-attributes)
3296 "Non-nil means that the `defface' :inherit keyword is available.
3297 The :inherit keyword is available on all supported versions of
3298 GNU Emacs and XEmacs from at least 21.5.23 on.")
3300 (defvar mh-min-colors-defined-flag (and (not mh-xemacs-flag)
3301 (>= emacs-major-version 22))
3302 "Non-nil means `defface' supports min-colors display requirement.")
3304 (defun mh-face-data (face &optional inherit)
3305 "Return spec for FACE.
3306 See `defface' for the spec definition.
3308 If INHERIT is non-nil and `defface' supports the :inherit
3309 keyword, return INHERIT literally; otherwise, return spec for
3310 FACE from the variable `mh-face-data'. This isn't a perfect
3311 implementation. In the case that the :inherit keyword is not
3312 supported, any additional attributes in the inherit parameter are
3313 not added to the returned spec.
3315 Furthermore, when `mh-min-colors-defined-flag' is nil, this
3316 function finds display entries with \"min-colors\" requirements
3317 and either removes the \"min-colors\" requirement or strips the
3318 display entirely if the display does not support the number of
3321 (if (and inherit mh-inherit-face-flag)
3323 (or (cadr (assq face mh-face-data))
3324 (error "Could not find %s in mh-face-data" face)))))
3326 (if mh-min-colors-defined-flag
3328 (let ((cells (mh-display-color-cells))
3330 ;; Remove entries with min-colors, or delete them if we have
3331 ;; fewer colors than they specify.
3332 (loop for entry in (reverse spec) do
3333 (let ((requirement (if (eq (car entry) t)
3335 (assq 'min-colors (car entry)))))
3337 (when (>= cells (nth 1 requirement))
3338 (setq new-spec (cons (cons (delq requirement (car entry))
3341 (setq new-spec (cons entry new-spec)))))
3344 (defface-mh mh-folder-address
3345 (mh-face-data 'mh-folder-subject '((t (:inherit mh-folder-subject))))
3349 :package-version '(MH-E . "8.0"))
3351 (defface-mh mh-folder-body
3352 (mh-face-data 'mh-folder-msg-number
3354 (:inherit mh-folder-msg-number))
3356 (:inherit mh-folder-msg-number :italic t))))
3360 :package-version '(MH-E . "8.0"))
3362 (defface-mh mh-folder-cur-msg-number
3363 (mh-face-data 'mh-folder-msg-number
3364 '((t (:inherit mh-folder-msg-number :bold t))))
3365 "Current message number face."
3368 :package-version '(MH-E . "8.0"))
3370 (defface-mh mh-folder-date
3371 (mh-face-data 'mh-folder-msg-number '((t (:inherit mh-folder-msg-number))))
3375 :package-version '(MH-E . "8.0"))
3377 (defface-mh mh-folder-deleted
3378 (mh-face-data 'mh-folder-msg-number '((t (:inherit mh-folder-msg-number))))
3379 "Deleted message face."
3382 :package-version '(MH-E . "8.0"))
3384 (defface-mh mh-folder-followup (mh-face-data 'mh-folder-followup)
3388 :package-version '(MH-E . "8.0"))
3390 (defface-mh mh-folder-msg-number (mh-face-data 'mh-folder-msg-number)
3391 "Message number face."
3394 :package-version '(MH-E . "8.0"))
3396 (defface-mh mh-folder-refiled (mh-face-data 'mh-folder-refiled)
3397 "Refiled message face."
3400 :package-version '(MH-E . "8.0"))
3402 (defface-mh mh-folder-sent-to-me-hint
3403 (mh-face-data 'mh-folder-msg-number '((t (:inherit mh-folder-date))))
3404 "Fontification hint face in messages sent directly to us.
3405 The detection of messages sent to us is governed by the scan
3406 format `mh-scan-format-nmh' and the regular expression
3407 `mh-scan-sent-to-me-sender-regexp'."
3410 :package-version '(MH-E . "8.0"))
3412 (defface-mh mh-folder-sent-to-me-sender
3413 (mh-face-data 'mh-folder-followup '((t (:inherit mh-folder-followup))))
3414 "Sender face in messages sent directly to us.
3415 The detection of messages sent to us is governed by the scan
3416 format `mh-scan-format-nmh' and the regular expression
3417 `mh-scan-sent-to-me-sender-regexp'."
3420 :package-version '(MH-E . "8.0"))
3422 (defface-mh mh-folder-subject (mh-face-data 'mh-folder-subject)
3426 :package-version '(MH-E . "8.0"))
3428 (defface-mh mh-folder-tick (mh-face-data 'mh-folder-tick)
3429 "Ticked message face."
3432 :package-version '(MH-E . "8.0"))
3434 (defface-mh mh-folder-to (mh-face-data 'mh-folder-to)
3438 :package-version '(MH-E . "8.0"))
3440 (defface-mh mh-letter-header-field (mh-face-data 'mh-letter-header-field)
3441 "Editable header field value face in draft buffers."
3444 :package-version '(MH-E . "8.0"))
3446 (defface-mh mh-search-folder (mh-face-data 'mh-search-folder)
3447 "Folder heading face in MH-Folder buffers created by searches."
3450 :package-version '(MH-E . "8.0"))
3452 (defface-mh mh-show-cc (mh-face-data 'mh-show-cc)
3453 "Face used to highlight \"cc:\" header fields."
3456 :package-version '(MH-E . "8.0"))
3458 (defface-mh mh-show-date (mh-face-data 'mh-show-date)
3459 "Face used to highlight \"Date:\" header fields."
3462 :package-version '(MH-E . "8.0"))
3464 (defface-mh mh-show-from (mh-face-data 'mh-show-from)
3465 "Face used to highlight \"From:\" header fields."
3468 :package-version '(MH-E . "8.0"))
3470 (defface-mh mh-show-header (mh-face-data 'mh-show-header)
3471 "Face used to deemphasize less interesting header fields."
3474 :package-version '(MH-E . "8.0"))
3476 (defface-mh mh-show-pgg-bad (mh-face-data 'mh-show-pgg-bad)
3477 "Bad PGG signature face."
3480 :package-version '(MH-E . "8.0"))
3482 (defface-mh mh-show-pgg-good (mh-face-data 'mh-show-pgg-good)
3483 "Good PGG signature face."
3486 :package-version '(MH-E . "8.0"))
3488 (defface-mh mh-show-pgg-unknown (mh-face-data 'mh-show-pgg-unknown)
3489 "Unknown or untrusted PGG signature face."
3492 :package-version '(MH-E . "8.0"))
3494 (defface-mh mh-show-signature (mh-face-data 'mh-show-signature)
3498 :package-version '(MH-E . "8.0"))
3500 (defface-mh mh-show-subject
3501 (mh-face-data 'mh-folder-subject '((t (:inherit mh-folder-subject))))
3502 "Face used to highlight \"Subject:\" header fields."
3505 :package-version '(MH-E . "8.0"))
3507 (defface-mh mh-show-to (mh-face-data 'mh-show-to)
3508 "Face used to highlight \"To:\" header fields."
3511 :package-version '(MH-E . "8.0"))
3513 (defface-mh mh-show-xface
3514 (mh-face-data 'mh-show-from '((t (:inherit (mh-show-from highlight)))))
3516 The background and foreground are used in the image."
3519 :package-version '(MH-E . "8.0"))
3521 (defface-mh mh-speedbar-folder (mh-face-data 'mh-speedbar-folder)
3522 "Basic folder face."
3525 :package-version '(MH-E . "8.0"))
3527 (defface-mh mh-speedbar-folder-with-unseen-messages
3528 (mh-face-data 'mh-speedbar-folder
3529 '((t (:inherit mh-speedbar-folder :bold t))))
3530 "Folder face when folder contains unread messages."
3533 :package-version '(MH-E . "8.0"))
3535 (defface-mh mh-speedbar-selected-folder
3536 (mh-face-data 'mh-speedbar-selected-folder)
3537 "Selected folder face."
3540 :package-version '(MH-E . "8.0"))
3542 (defface-mh mh-speedbar-selected-folder-with-unseen-messages
3543 (mh-face-data 'mh-speedbar-selected-folder
3544 '((t (:inherit mh-speedbar-selected-folder :bold t))))
3545 "Selected folder face when folder contains unread messages."
3548 :package-version '(MH-E . "8.0"))
3553 ;; indent-tabs-mode: nil
3554 ;; sentence-end-double-space: nil
3557 ;; arch-tag: cce884de-bd37-4104-9963-e4439d5ed22b
3558 ;;; mh-e.el ends here