1 ;;; mh-e.el --- GNU Emacs interface to the MH mail system
3 ;; Copyright (C) 1985-1988, 1990, 1992-1995, 1997, 1999-2014 Free
4 ;; Software Foundation, Inc.
6 ;; Author: Bill Wohler <wohler@newt.com>
7 ;; Maintainer: Bill Wohler <wohler@newt.com>
11 ;; This file is part of GNU Emacs.
13 ;; GNU Emacs is free software: you can redistribute it and/or modify
14 ;; it under the terms of the GNU General Public License as published by
15 ;; the Free Software Foundation, either version 3 of the License, or
16 ;; (at your option) any later version.
18 ;; GNU Emacs is distributed in the hope that it will be useful,
19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ;; GNU General Public License for more details.
23 ;; You should have received a copy of the GNU General Public License
24 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
28 ;; MH-E is an Emacs interface to the MH mail system.
30 ;; MH-E is supported in GNU Emacs 21 and higher, as well as XEmacs 21
31 ;; (except for versions 21.5.9-21.5.16). It is compatible with MH
32 ;; versions 6.8.4 and higher, all versions of nmh, and GNU mailutils
33 ;; 1.0 and higher. Gnus is also required; version 5.10 or higher is
36 ;; MH (Message Handler) is a powerful mail reader. See
37 ;; http://rand-mh.sourceforge.net/.
39 ;; N.B. MH must have been compiled with the MHE compiler flag or several
40 ;; features necessary for MH-E will be missing from MH commands, specifically
41 ;; the -build switch to repl and forw.
44 ;; M-x mh-rmail to read mail. Type C-h m there for a list of commands.
45 ;; C-u M-x mh-rmail to visit any folder.
46 ;; M-x mh-smail to send mail. From within the mail reader, "s" works, too.
48 ;; Your .emacs might benefit from these bindings:
49 ;; (global-set-key "\C-cr" 'mh-rmail)
50 ;; (global-set-key "\C-xm" 'mh-smail)
51 ;; (global-set-key "\C-x4m" 'mh-smail-other-window)
53 ;; If Emacs can't find mh-rmail or mh-smail, add the following to ~/.emacs:
54 ;; (require 'mh-autoloads)
56 ;; If you want to customize MH-E before explicitly loading it, add this:
57 ;; (require 'mh-cus-load)
60 ;; mh-e-users@lists.sourceforge.net
61 ;; mh-e-announce@lists.sourceforge.net
62 ;; mh-e-devel@lists.sourceforge.net
64 ;; Subscribe by sending a "subscribe" message to
65 ;; <list>-request@lists.sourceforge.net, or by using the web interface at
66 ;; https://sourceforge.net/mail/?group_id=13357
69 ;; https://sourceforge.net/tracker/?group_id=13357&atid=113357
70 ;; Include the output of M-x mh-version in the bug report unless
71 ;; you're 110% sure we won't ask for it.
74 ;; https://sourceforge.net/tracker/?group_id=13357&atid=363357
77 ;; https://sourceforge.net/tracker/?group_id=13357&atid=213357
81 ;; Original version for Gosling emacs by Brian Reid, Stanford, 1982.
82 ;; Modified by James Larus, BBN, July 1984 and UCB, 1984 & 1985.
83 ;; Rewritten for GNU Emacs, James Larus, 1985.
84 ;; Modified by Stephen Gildea, 1988.
85 ;; Maintenance picked up by Bill Wohler and the
86 ;; SourceForge Crew <http://mh-e.sourceforge.net/>, 2001.
90 ;; Provide functions to the rest of MH-E. However, mh-e.el must not
91 ;; use any definitions in files that require mh-e from mh-loaddefs,
92 ;; for if it does it will introduce a require loop.
93 (require 'mh-loaddefs
)
101 (require 'mh-xemacs
))
103 (mh-font-lock-add-keywords
107 ;; Function declarations (use font-lock-function-name-face).
108 "\\(def\\(un\\|macro\\)-mh\\)\\|"
109 ;; Variable declarations (use font-lock-variable-name-face).
110 "\\(def\\(custom\\|face\\)-mh\\)\\|"
111 ;; Group declarations (use font-lock-type-face).
114 ;; Any whitespace and defined object.
116 "\\(setf[ \t]+\\sw+)\\|\\sw+\\)?")
117 (1 font-lock-keyword-face
)
118 (7 (cond ((match-beginning 2) font-lock-function-name-face
)
119 ((match-beginning 4) font-lock-variable-name-face
)
120 (t font-lock-type-face
))
127 ;; Try to keep variables local to a single file. Provide accessors if
128 ;; variables are shared. Use this section as a last resort.
130 (defconst mh-version
"8.6" "Version number of MH-E.")
135 '("/usr/local/nmh/bin" ; nmh default
138 "/usr/bin/mh/" ; Ultrix 4.2, Linux
139 "/usr/new/mh/" ; Ultrix < 4.2
140 "/usr/contrib/mh/bin/" ; BSDI
141 "/usr/pkg/bin/" ; NetBSD
143 "/usr/local/bin/mu-mh/" ; GNU mailutils MH - default
144 "/usr/bin/mu-mh/") ; GNU mailutils MH - packaged
145 "List of directories to search for variants of the MH variant.
146 The list `exec-path' is searched in addition to this list.
147 There's no need for users to modify this list. Instead add extra
148 directories to the customizable variable `mh-path'.")
150 (defvar mh-variants nil
151 "List describing known MH variants.
152 Do not access this variable directly as it may not have yet been initialized.
153 Use the function `mh-variants' instead.")
155 (defvar mh-variant-in-use nil
156 "The MH variant currently in use; a string with variant and version number.
157 This differs from `mh-variant' when the latter is set to
161 "Directory containing MH commands, such as inc, repl, and rmm.")
164 (put 'mh-progs
'risky-local-variable t
)
167 "Directory containing the MH library.
168 This directory contains, among other things, the components file.")
171 (put 'mh-lib
'risky-local-variable t
)
173 (defvar mh-lib-progs nil
174 "Directory containing MH helper programs.
175 This directory contains, among other things, the mhl program.")
178 (put 'mh-lib-progs
'risky-local-variable t
)
180 ;; Profile Components
182 (defvar mh-draft-folder nil
183 "Cached value of the \"Draft-Folder:\" MH profile component.
184 Name of folder containing draft messages.
185 Do not use a draft folder if nil.")
188 "Cached value of the \"Inbox:\" MH profile component.
189 Set to \"+inbox\" if no such component.
190 Name of the Inbox folder.")
192 (defvar mh-user-path nil
193 "Cached value of the \"Path:\" MH profile component.
194 User's mail folder directory.")
196 ;; Maps declared here so that they can be used in docstrings.
198 (defvar mh-folder-mode-map
(make-keymap)
199 "Keymap for MH-Folder mode.")
201 (defvar mh-folder-seq-tool-bar-map nil
202 "Keymap for MH-Folder tool bar.")
204 (defvar mh-folder-tool-bar-map nil
205 "Keymap for MH-Folder tool bar.")
207 (defvar mh-inc-spool-map
(make-sparse-keymap)
208 "Keymap for MH-E's mh-inc-spool commands.")
210 (defvar mh-letter-mode-map
(copy-keymap text-mode-map
)
211 "Keymap for MH-Letter mode.")
213 (defvar mh-letter-tool-bar-map nil
214 "Keymap for MH-Letter tool bar.")
216 (defvar mh-search-mode-map
(make-sparse-keymap)
217 "Keymap for MH-Search mode.")
219 (defvar mh-show-mode-map
(make-sparse-keymap)
220 "Keymap MH-Show mode.")
222 (defvar mh-show-seq-tool-bar-map nil
223 "Keymap for MH-Show tool bar.")
225 (defvar mh-show-tool-bar-map nil
226 "Keymap for MH-Show tool bar.")
228 ;; MH-Folder Locals (alphabetical)
230 (defvar mh-arrow-marker nil
231 "Marker for arrow display in fringe.")
233 (defvar mh-blacklist nil
234 "List of messages to use to train the junk filter.
235 This variable can be used by
236 `mh-before-commands-processed-hook'.")
238 (defvar mh-colors-available-flag nil
239 "Non-nil means colors are available.")
241 (defvar mh-current-folder nil
242 "Name of current folder, a string.")
244 (defvar mh-delete-list nil
245 "List of message numbers to delete.
246 This variable can be used by
247 `mh-before-commands-processed-hook'.")
249 (defvar mh-folder-view-stack nil
250 "Stack of previous folder views.")
252 (defvar mh-index-data nil
253 "Info about index search results.")
255 (defvar mh-index-previous-search nil
)
257 (defvar mh-index-msg-checksum-map nil
)
259 (defvar mh-index-checksum-origin-map nil
)
261 (defvar mh-index-sequence-search-flag nil
)
263 (defvar mh-mode-line-annotation nil
264 "Message range displayed in buffer.")
266 (defvar mh-next-direction
'forward
267 "Direction to move to next message.")
269 (defvar mh-previous-window-config nil
270 "Window configuration before MH-E command.")
272 (defvar mh-refile-list nil
273 "List of folder names in `mh-seq-list'.
274 This variable can be used by
275 `mh-before-commands-processed-hook'.")
277 (defvar mh-seen-list nil
278 "List of displayed messages to be removed from the \"Unseen\" sequence.")
280 (defvar mh-seq-list nil
281 "Alist of this folder's sequences.
282 Elements have the form (SEQUENCE . MESSAGES).")
284 (defvar mh-sequence-notation-history nil
285 "Remember original notation that is overwritten by `mh-note-seq'.")
287 (defvar mh-show-buffer nil
288 "Buffer that displays message for this folder.")
290 (define-minor-mode mh-showing-mode
291 "Minor mode to show the message in a separate window."
292 ;; FIXME: maybe this should be moved to mh-show.el.
295 (defvar mh-view-ops nil
296 "Stack of operations that change the folder view.
297 These operations include narrowing or threading.")
299 (defvar mh-whitelist nil
300 "List of messages to use to train the junk filter.
301 This variable can be used by
302 `mh-before-commands-processed-hook'.")
304 ;; MH-Show Locals (alphabetical)
306 (defvar mh-globals-hash
(make-hash-table)
307 "Keeps track of MIME data on a per buffer basis.")
309 (defvar mh-show-folder-buffer nil
310 "Keeps track of folder whose message is being displayed.")
314 (defvar mh-folders-changed nil
315 "Lists which folders were affected by deletes and refiles.
316 This list will always include the current folder
317 `mh-current-folder'. This variable can be used by
318 `mh-after-commands-processed-hook'.")
320 (defvar mh-mail-header-separator
"--------"
321 "*Line used by MH to separate headers from text in messages being composed.
323 This variable should not be used directly in programs. Programs
324 should use `mail-header-separator' instead.
325 `mail-header-separator' is initialized to
326 `mh-mail-header-separator' in `mh-letter-mode'; in other
327 contexts, you may have to perform this initialization yourself.
329 Do not make this a regular expression as it may be the argument
330 to `insert' and it is passed through `regexp-quote' before being
331 used by functions like `re-search-forward'.")
333 (defvar mh-sent-from-folder nil
334 "Folder of msg assoc with this letter.")
336 (defvar mh-sent-from-msg nil
337 "Number of msg assoc with this letter.")
341 (defvar mh-unseen-seq nil
342 "Cached value of the \"Unseen-Sequence:\" MH profile component.
343 Name of the Unseen sequence.")
345 (defvar mh-previous-seq nil
346 "Cached value of the \"Previous-Sequence:\" MH profile component.
347 Name of the Previous sequence.")
349 ;; Etc. (alphabetical)
351 (defvar mh-flists-present-flag nil
352 "Non-nil means that we have \"flists\".")
354 (defvar mh-index-data-file
".mhe_index"
355 "MH-E specific file where index search info is stored.")
357 (defvar mh-letter-header-field-regexp
"^\\([A-Za-z][A-Za-z0-9-]*\\):")
359 (defvar mh-page-to-next-msg-flag nil
360 "Non-nil means next SPC or whatever goes to next undeleted message.")
362 (defvar mh-pgp-support-flag
(not (not (locate-library "mml2015")))
363 "Non-nil means PGP support is available.")
365 (defvar mh-signature-separator
"-- \n"
366 "Text of a signature separator.
368 A signature separator is used to separate the body of a message
369 from the signature. This can be used by user agents such as MH-E
370 to render the signature differently or to suppress the inclusion
371 of the signature in a reply. Use `mh-signature-separator-regexp'
372 when searching for a separator.")
374 (defvar mh-signature-separator-regexp
"^-- $"
375 "This regular expression matches the signature separator.
376 See `mh-signature-separator'.")
378 (defvar mh-thread-scan-line-map nil
379 "Map of message index to various parts of the scan line.")
380 (make-variable-buffer-local 'mh-thread-scan-line-map
)
382 (defvar mh-thread-scan-line-map-stack nil
383 "Old map of message index to various parts of the scan line.
384 This is the original map that is stored when the folder is
386 (make-variable-buffer-local 'mh-thread-scan-line-map-stack
)
388 (defvar mh-x-mailer-string nil
389 "*String containing the contents of the X-Mailer header field.
390 If nil, this variable is initialized to show the version of MH-E,
391 Emacs, and MH the first time a message is composed.")
395 ;;; MH-E Entry Points
397 (eval-when-compile (require 'gnus
))
399 (defmacro mh-macro-expansion-time-gnus-version
()
400 "Return Gnus version available at macro expansion time.
401 The macro evaluates the Gnus version at macro expansion time. If
402 MH-E was compiled then macro expansion happens at compile time."
405 (defun mh-run-time-gnus-version ()
406 "Return Gnus version available at run time."
412 "Display version information about MH-E and the MH mail handling system."
414 (set-buffer (get-buffer-create mh-info-buffer
))
417 (insert "MH-E " mh-version
"\n\n")
418 ;; MH-E compilation details.
419 (insert "MH-E compilation details:\n")
420 (let* ((compiled-mhe (byte-code-function-p (symbol-function 'mh-version
)))
421 (gnus-compiled-version (if compiled-mhe
422 (mh-macro-expansion-time-gnus-version)
424 (insert " Byte compiled:\t\t" (if compiled-mhe
"yes" "no") "\n"
425 " Gnus (compile-time):\t" gnus-compiled-version
"\n"
426 " Gnus (run-time):\t" (mh-run-time-gnus-version) "\n\n"))
428 (insert (emacs-version) "\n\n")
430 (if mh-variant-in-use
431 (insert mh-variant-in-use
"\n"
432 " mh-progs:\t" mh-progs
"\n"
433 " mh-lib:\t" mh-lib
"\n"
434 " mh-lib-progs:\t" mh-lib-progs
"\n\n")
435 (insert "No MH variant detected\n"))
438 (call-process "uname" nil t nil
"-a")
440 (goto-char (point-min))
441 (display-buffer mh-info-buffer
))
447 (defun mh-list-to-string (l)
448 "Flatten the list L and make every element of the new list into a string."
449 (nreverse (mh-list-to-string-1 l
)))
451 (defun mh-list-to-string-1 (l)
452 "Flatten the list L and make every element of the new list into a string."
455 (cond ((null element
))
457 (push (symbol-name element
) new-list
))
459 (push (int-to-string element
) new-list
))
462 (push element new-list
))
464 (setq new-list
(nconc (mh-list-to-string-1 element
) new-list
)))
466 (error "Bad element: %s" element
))))
471 ;;; MH-E Process Support
473 (defvar mh-index-max-cmdline-args
500
474 "Maximum number of command line args.")
476 (defun mh-xargs (cmd &rest args
)
477 "Partial imitation of xargs.
478 The current buffer contains a list of strings, one on each line.
479 The function will execute CMD with ARGS and pass the first
480 `mh-index-max-cmdline-args' strings to it. This is repeated till
481 all the strings have been used."
482 (goto-char (point-min))
483 (let ((current-buffer (current-buffer)))
485 (let ((out (current-buffer)))
486 (set-buffer current-buffer
)
488 (let ((arg-list (reverse args
))
490 (while (and (not (eobp)) (< count mh-index-max-cmdline-args
))
491 (push (buffer-substring-no-properties (point)
492 (mh-line-end-position))
496 (apply #'call-process cmd nil
(list out nil
) nil
497 (nreverse arg-list
))))
499 (insert-buffer-substring out
)))))
501 ;; XXX This should be applied anywhere MH-E calls out to /bin/sh.
502 (defun mh-quote-for-shell (string)
503 "Quote STRING for /bin/sh.
504 Adds double-quotes around entire string and quotes the characters
505 \\, `, and $ with a backslash."
507 (loop for x across string
508 concat
(format (if (memq x
'(?
\\ ?
` ?$
)) "\\%c" "%c") x
))
511 (defun mh-exec-cmd (command &rest args
)
512 "Execute mh-command COMMAND with ARGS.
513 The side effects are what is desired. Any output is assumed to be
514 an error and is shown to the user. The output is not read or
516 (with-current-buffer (get-buffer-create mh-log-buffer
)
517 (let* ((initial-size (mh-truncate-log-buffer))
519 (args (mh-list-to-string args
)))
520 (apply 'call-process
(expand-file-name command mh-progs
) nil t nil args
)
521 (when (> (buffer-size) initial-size
)
524 (insert "Errors when executing: " command
)
525 (loop for arg in args do
(insert " " arg
))
527 (save-window-excursion
528 (switch-to-buffer-other-window mh-log-buffer
)
531 (defun mh-exec-cmd-error (env command
&rest args
)
532 "In environment ENV, execute mh-command COMMAND with ARGS.
533 ENV is nil or a string of space-separated \"var=value\" elements.
534 Signals an error if process does not complete successfully."
535 (with-current-buffer (get-buffer-create mh-temp-buffer
)
537 (let ((process-environment process-environment
))
538 ;; XXX: We should purge the list that split-string returns of empty
539 ;; strings. This can happen in XEmacs if leading or trailing spaces
541 (dolist (elem (if (stringp env
) (split-string env
" ") ()))
542 (push elem process-environment
))
543 (mh-handle-process-error
544 command
(apply #'call-process
(expand-file-name command mh-progs
)
545 nil t nil
(mh-list-to-string args
))))))
547 (defun mh-exec-cmd-daemon (command filter
&rest args
)
548 "Execute MH command COMMAND in the background.
550 If FILTER is non-nil then it is used to process the output
551 otherwise the default filter `mh-process-daemon' is used. See
552 `set-process-filter' for more details of FILTER.
554 ARGS are passed to COMMAND as command line arguments."
555 (with-current-buffer (get-buffer-create mh-log-buffer
)
556 (mh-truncate-log-buffer))
557 (let* ((process-connection-type nil
)
558 (process (apply 'start-process
560 (expand-file-name command mh-progs
)
561 (mh-list-to-string args
))))
562 (set-process-filter process
(or filter
'mh-process-daemon
))
565 (defun mh-exec-cmd-env-daemon (env command filter
&rest args
)
566 "In environment ENV, execute mh-command COMMAND in the background.
568 ENV is nil or a string of space-separated \"var=value\" elements.
569 Signals an error if process does not complete successfully.
571 If FILTER is non-nil then it is used to process the output
572 otherwise the default filter `mh-process-daemon' is used. See
573 `set-process-filter' for more details of FILTER.
575 ARGS are passed to COMMAND as command line arguments."
576 (let ((process-environment process-environment
))
577 (dolist (elem (if (stringp env
) (split-string env
" ") ()))
578 (push elem process-environment
))
579 (apply #'mh-exec-cmd-daemon command filter args
)))
581 (defun mh-process-daemon (process output
)
582 "PROCESS daemon that puts OUTPUT into a temporary buffer.
583 Any output from the process is displayed in an asynchronous
585 (with-current-buffer (get-buffer-create mh-log-buffer
)
586 (insert-before-markers output
)
587 (display-buffer mh-log-buffer
)))
589 (defun mh-exec-cmd-quiet (raise-error command
&rest args
)
590 "Signal RAISE-ERROR if COMMAND with ARGS fails.
591 Execute MH command COMMAND with ARGS. ARGS is a list of strings.
592 Return at start of mh-temp buffer, where output can be parsed and
594 Returns value of `call-process', which is 0 for success, unless
595 RAISE-ERROR is non-nil, in which case an error is signaled if
596 `call-process' returns non-0."
597 (set-buffer (get-buffer-create mh-temp-buffer
))
601 (expand-file-name command mh-progs
) nil t nil
603 (goto-char (point-min))
605 (mh-handle-process-error command value
)
608 (defun mh-exec-cmd-output (command display
&rest args
)
609 "Execute MH command COMMAND with DISPLAY flag and ARGS.
610 Put the output into buffer after point.
611 Set mark after inserted text.
612 Output is expected to be shown to user, not parsed by MH-E."
613 (push-mark (point) t
)
615 (expand-file-name command mh-progs
) nil t display
616 (mh-list-to-string args
))
618 ;; The following is used instead of 'exchange-point-and-mark because the
619 ;; latter activates the current region (between point and mark), which
620 ;; turns on highlighting. So prior to this bug fix, doing "inc" would
621 ;; highlight a region containing the new messages, which is undesirable.
622 ;; The bug wasn't seen in emacs21 but still occurred in XEmacs21.4.
623 (mh-exchange-point-and-mark-preserving-active-mark))
627 (defvar mark-active
))
629 (defun mh-exchange-point-and-mark-preserving-active-mark ()
630 "Put the mark where point is now, and point where the mark is now.
631 This command works even when the mark is not active, and
632 preserves whether the mark is active or not."
634 (let ((is-active (and (boundp 'mark-active
) mark-active
)))
635 (let ((omark (mark t
)))
637 (error "No mark set in this buffer"))
640 (if (boundp 'mark-active
)
641 (setq mark-active is-active
))
644 (defun mh-exec-lib-cmd-output (command &rest args
)
645 "Execute MH library command COMMAND with ARGS.
646 Put the output into buffer after point.
647 Set mark after inserted text."
648 (apply 'mh-exec-cmd-output
(expand-file-name command mh-lib-progs
) nil args
))
650 (defun mh-handle-process-error (command status
)
651 "Raise error if COMMAND returned non-zero STATUS, otherwise return STATUS."
654 (goto-char (point-min))
655 (insert (if (integerp status
)
656 (format "%s: exit code %d\n" command status
)
657 (format "%s: %s\n" command status
)))
658 (let ((error-message (buffer-substring (point-min) (point-max))))
659 (with-current-buffer (get-buffer-create mh-log-buffer
)
660 (mh-truncate-log-buffer)
661 (insert error-message
)))
662 (error "%s failed, check buffer %s for error message"
663 command mh-log-buffer
)))
667 ;;; MH-E Customization Support Routines
669 ;; Shush compiler (Emacs 21 and XEmacs).
670 (defvar customize-package-emacs-version-alist
)
672 ;; Temporary function and data structure used customization.
673 ;; These will be unbound after the options are defined.
674 (defmacro mh-strip-package-version
(args)
675 "Strip :package-version keyword and its value from ARGS.
676 In Emacs versions that support the :package-version keyword,
677 ARGS is returned unchanged."
678 `(if (boundp 'customize-package-emacs-version-alist
)
681 (loop for keyword in
,args
682 if
(cond ((eq keyword
':package-version
) (setq seen t
) nil
)
683 (seen (setq seen nil
) nil
)
687 (defmacro defgroup-mh
(symbol members doc
&rest args
)
688 "Declare SYMBOL as a customization group containing MEMBERS.
689 See documentation for `defgroup' for a description of the arguments
690 SYMBOL, MEMBERS, DOC and ARGS.
691 This macro is used by Emacs versions that lack the :package-version
692 keyword, introduced in Emacs 22."
693 (declare (doc-string 3))
694 `(defgroup ,symbol
,members
,doc
,@(mh-strip-package-version args
)))
695 (put 'defgroup-mh
'lisp-indent-function
'defun
)
697 (defmacro defcustom-mh
(symbol value doc
&rest args
)
698 "Declare SYMBOL as a customizable variable that defaults to VALUE.
699 See documentation for `defcustom' for a description of the arguments
700 SYMBOL, VALUE, DOC and ARGS.
701 This macro is used by Emacs versions that lack the :package-version
702 keyword, introduced in Emacs 22."
703 (declare (doc-string 3))
704 `(defcustom ,symbol
,value
,doc
,@(mh-strip-package-version args
)))
705 (put 'defcustom-mh
'lisp-indent-function
'defun
)
707 (defmacro defface-mh
(face spec doc
&rest args
)
708 "Declare FACE as a customizable face that defaults to SPEC.
709 See documentation for `defface' for a description of the arguments
710 FACE, SPEC, DOC and ARGS.
711 This macro is used by Emacs versions that lack the :package-version
712 keyword, introduced in Emacs 22."
713 (declare (doc-string 3))
714 `(defface ,face
,spec
,doc
,@(mh-strip-package-version args
)))
715 (put 'defface-mh
'lisp-indent-function
'defun
)
721 (defcustom-mh mh-path nil
722 "*Additional list of directories to search for MH.
725 :type
'(repeat (directory))
726 :package-version
'(MH-E .
"8.0"))
728 (defun mh-variants ()
729 "Return a list of installed variants of MH on the system.
730 This function looks for MH in `mh-sys-path', `mh-path' and
731 `exec-path'. The format of the list of variants that is returned
732 is described by the variable `mh-variants'."
736 ;; Make a unique list of directories, keeping the given order.
737 ;; We don't want the same MH variant to be listed multiple times.
738 (loop for dir in
(append mh-path mh-sys-path exec-path
) do
739 (setq dir
(file-chase-links (directory-file-name dir
)))
740 (add-to-list 'list-unique dir
))
741 (loop for dir in
(nreverse list-unique
) do
742 (when (and dir
(file-directory-p dir
) (file-readable-p dir
))
743 (let ((variant (mh-variant-info dir
)))
745 (add-to-list 'mh-variants variant
)))))
748 (defun mh-variant-info (dir)
749 "Return MH variant found in DIR, or nil if none present."
750 (let ((tmp-buffer (get-buffer-create mh-temp-buffer
)))
751 (with-current-buffer tmp-buffer
753 ((mh-variant-mh-info dir
))
754 ((mh-variant-nmh-info dir
))
755 ((mh-variant-gnu-mh-info dir
))))))
757 (defun mh-variant-mh-info (dir)
758 "Return info for MH variant in DIR assuming a temporary buffer is set up."
759 ;; MH does not have the -version option.
760 ;; Its version number is included in the output of "-help" as:
762 ;; version: MH 6.8.4 #2[UCI] (burrito) of Fri Jan 15 20:01:39 EST 1999
763 ;; options: [ATHENA] [BIND] [DUMB] [LIBLOCKFILE] [LOCALE] [MAILGROUP] [MHE]
764 ;; [MHRC] [MIME] [MORE='"/usr/bin/sensible-pager"'] [NLINK_HACK]
765 ;; [NORUSERPASS] [OVERHEAD] [POP] [POPSERVICE='"pop-3"'] [RENAME]
766 ;; [RFC1342] [RPATHS] [RPOP] [SENDMTS] [SMTP] [SOCKETS]
767 ;; [SPRINTFTYPE=int] [SVR4] [SYS5] [SYS5DIR] [TERMINFO]
768 ;; [TYPESIG=void] [UNISTD] [UTK] [VSPRINTF]
769 (let ((mhparam (expand-file-name "mhparam" dir
)))
770 (when (mh-file-command-p mhparam
)
772 (call-process mhparam nil
'(t nil
) nil
"-help")
773 (goto-char (point-min))
774 (when (search-forward-regexp "version: MH \\(\\S +\\)" nil t
)
775 (let ((version (format "MH %s" (match-string 1))))
777 (call-process mhparam nil
'(t nil
) nil
"libdir")
778 (goto-char (point-min))
779 (when (search-forward-regexp "^.*$" nil t
)
780 (let ((libdir (match-string 0)))
783 (mh-lib-progs ,libdir
)
788 (defun mh-variant-gnu-mh-info (dir)
789 "Return info for GNU mailutils MH variant in DIR.
790 This assumes that a temporary buffer is set up."
791 ;; 'mhparam -version' output:
792 ;; mhparam (GNU mailutils 0.3.2)
793 (let ((mhparam (expand-file-name "mhparam" dir
)))
794 (when (mh-file-command-p mhparam
)
796 (call-process mhparam nil
'(t nil
) nil
"-version")
797 (goto-char (point-min))
798 (when (search-forward-regexp "mhparam (\\(GNU [Mm]ailutils \\S +\\))"
800 (let ((version (match-string 1))
804 (mh-lib-progs ,(mh-profile-component "libdir"))
805 (mh-lib ,(mh-profile-component "etcdir"))
807 (flists ,(file-exists-p
808 (expand-file-name "flists" dir
)))))))))
810 (defun mh-variant-nmh-info (dir)
811 "Return info for nmh variant in DIR assuming a temporary buffer is set up."
812 ;; `mhparam -version' outputs:
813 ;; mhparam -- nmh-1.1-RC1 [compiled on chaak at Fri Jun 20 11:03:28 PDT 2003]
814 (let ((mhparam (expand-file-name "mhparam" dir
)))
815 (when (mh-file-command-p mhparam
)
817 (call-process mhparam nil
'(t nil
) nil
"-version")
818 (goto-char (point-min))
819 (when (search-forward-regexp "mhparam -- nmh-\\(\\S +\\)" nil t
)
820 (let ((version (format "nmh %s" (match-string 1)))
824 (mh-lib-progs ,(mh-profile-component "libdir"))
825 (mh-lib ,(mh-profile-component "etcdir"))
827 (flists ,(file-exists-p
828 (expand-file-name "flists" dir
)))))))))
830 (defun mh-file-command-p (file)
831 "Return t if file FILE is the name of a executable regular file."
832 (and (file-regular-p file
) (file-executable-p file
)))
834 (defun mh-variant-set-variant (variant)
835 "Set up the system variables for the MH variant named VARIANT.
836 If VARIANT is a string, use that key in the alist returned by the
837 function `mh-variants'.
838 If VARIANT is a symbol, select the first entry that matches that
841 ((stringp variant
) ;e.g. "nmh 1.1-RC1"
842 (when (assoc variant
(mh-variants))
843 (let* ((alist (cdr (assoc variant
(mh-variants))))
844 (lib-progs (cadr (assoc 'mh-lib-progs alist
)))
845 (lib (cadr (assoc 'mh-lib alist
)))
846 (progs (cadr (assoc 'mh-progs alist
)))
847 (flists (cadr (assoc 'flists alist
))))
848 ;;(set-default mh-variant variant)
849 (setq mh-x-mailer-string nil
850 mh-flists-present-flag flists
851 mh-lib-progs lib-progs
854 mh-variant-in-use variant
))))
855 ((symbolp variant
) ;e.g. 'nmh (pick the first match)
856 (loop for variant-list in
(mh-variants)
857 when
(eq variant
(cadr (assoc 'variant
(cdr variant-list
))))
858 return
(let* ((version (car variant-list
))
859 (alist (cdr variant-list
))
860 (lib-progs (cadr (assoc 'mh-lib-progs alist
)))
861 (lib (cadr (assoc 'mh-lib alist
)))
862 (progs (cadr (assoc 'mh-progs alist
)))
863 (flists (cadr (assoc 'flists alist
))))
864 ;;(set-default mh-variant flavor)
865 (setq mh-x-mailer-string nil
866 mh-flists-present-flag flists
867 mh-lib-progs lib-progs
870 mh-variant-in-use version
)
873 (defun mh-variant-p (&rest variants
)
874 "Return t if variant is any of VARIANTS.
875 Currently known variants are 'MH, 'nmh, and 'gnu-mh."
876 (let ((variant-in-use
877 (cadr (assoc 'variant
(assoc mh-variant-in-use
(mh-variants))))))
878 (not (null (member variant-in-use variants
)))))
880 (defun mh-profile-component (component)
881 "Return COMPONENT value from mhparam, or nil if unset."
883 ;; MH and nmh use -components, GNU mailutils MH uses -component.
884 ;; Since MH and nmh work with an unambiguous prefix, the `s' is
886 (mh-exec-cmd-quiet nil
"mhparam" "-component" component
)
887 (mh-profile-component-value component
)))
889 (defun mh-profile-component-value (component)
890 "Find and return the value of COMPONENT in the current buffer.
891 Returns nil if the component is not in the buffer."
892 (let ((case-fold-search t
))
893 (goto-char (point-min))
894 (cond ((not (re-search-forward (format "^%s:" component
) nil t
)) nil
)
895 ((looking-at "[\t ]*$") nil
)
897 (re-search-forward "[\t ]*\\([^\t \n].*\\)$" nil t
)
898 (let ((start (match-beginning 1)))
900 (buffer-substring start
(point)))))))
902 (defun mh-variant-set (variant)
903 "Set the MH variant to VARIANT.
904 Sets `mh-progs', `mh-lib', `mh-lib-progs' and
905 `mh-flists-present-flag'.
906 If the VARIANT is \"autodetect\", then first try nmh, then MH and
907 finally GNU mailutils MH."
909 (list (completing-read
911 (mapcar (lambda (x) (list (car x
))) (mh-variants))
914 ;; TODO Remove mu-mh backwards compatibility in 9.0.
915 (when (and (stringp variant
)
916 (string-match "^mu-mh" variant
))
918 (format "%s\n%s; %s" "The variant name mu-mh has been renamed to gnu-mh"
919 "and will be removed in MH-E 9.0"
920 "try M-x customize-option mh-variant"))
922 (setq variant
(concat "gnu-mh" (substring variant
(match-end 0)))))
924 (let ((valid-list (mapcar (lambda (x) (car x
)) (mh-variants))))
927 ((eq variant
'autodetect
)
929 ((mh-variant-set-variant 'nmh
)
930 (message "%s installed as MH variant" mh-variant-in-use
))
931 ((mh-variant-set-variant 'mh
)
932 (message "%s installed as MH variant" mh-variant-in-use
))
933 ((mh-variant-set-variant 'gnu-mh
)
934 (message "%s installed as MH variant" mh-variant-in-use
))
936 (message "No MH variant found on the system"))))
937 ((member variant valid-list
)
938 (when (not (mh-variant-set-variant variant
))
939 (message "Warning: %s variant not found. Autodetecting..." variant
)
940 (mh-variant-set 'autodetect
)))
942 (message "Unknown variant %s; use %s"
944 (mapconcat (lambda (x) (format "%s" (car x
)))
945 (mh-variants) " or "))))))
947 (defcustom-mh mh-variant
'autodetect
948 "*Specifies the variant used by MH-E.
950 The default setting of this option is \"Auto-detect\" which means
951 that MH-E will automatically choose the first of nmh, MH, or GNU
952 mailutils MH that it finds in the directories listed in
953 `mh-path' (which you can customize), `mh-sys-path', and
954 `exec-path'. If MH-E can't find MH at all, you may have to
955 customize `mh-path' and add the directory in which the command
956 \"mhparam\" is located. If, on the other hand, you have both nmh
957 and GNU mailutils MH installed (for example) and
958 `mh-variant-in-use' was initialized to nmh but you want to use
959 GNU mailutils MH, then you can set this option to \"gnu-mh\".
961 When this variable is changed, MH-E resets `mh-progs', `mh-lib',
962 `mh-lib-progs', `mh-flists-present-flag', and `mh-variant-in-use'
963 accordingly. Prior to version 8, it was often necessary to set
964 some of these variables in \"~/.emacs\"; now it is no longer
965 necessary and can actually cause problems."
967 (const :tag
"Auto-detect" autodetect
)
968 ,@(mapcar (lambda (x) `(const ,(car x
))) (mh-variants)))
969 :set
(lambda (symbol value
)
970 (set-default symbol value
) ;Done in mh-variant-set-variant!
971 (mh-variant-set value
))
973 :package-version
'(MH-E .
"8.0"))
977 ;;; MH-E Customization
979 ;; All of the defgroups, defcustoms, and deffaces in MH-E are found
980 ;; here. This makes it possible to customize modules that aren't
981 ;; loaded yet. It also makes it easier to organize the customization
984 ;; This section contains the following sub-sections:
986 ;; 1. MH-E Customization Groups
988 ;; These are the customization group definitions. Every group has a
989 ;; associated manual node. The ordering is alphabetical, except for
990 ;; the groups mh-faces and mh-hooks which are last .
992 ;; 2. MH-E Customization
994 ;; These are the actual customization variables. There is a
995 ;; sub-section for each group in the MH-E Customization Groups
996 ;; section, in the same order, separated by page breaks. Within
997 ;; each section, variables are sorted alphabetically.
1001 ;; All hooks must be placed in the mh-hook group; in addition, add
1002 ;; the group associated with the manual node in which the hook is
1003 ;; described. Since the mh-hook group appears near the end of this
1004 ;; section, the hooks will appear at the end of these other groups.
1008 ;; All faces must be placed in the mh-faces group; in addition, add
1009 ;; the group associated with the manual node in which the face is
1010 ;; described. Since the mh-faces group appears near the end of this
1011 ;; section, the faces will appear at the end of these other groups.
1013 (defun mh-customize (&optional delete-other-windows-flag
)
1014 "Customize MH-E variables.
1015 If optional argument DELETE-OTHER-WINDOWS-FLAG is non-nil, other
1016 windows in the frame are removed."
1018 (customize-group 'mh-e
)
1019 (when delete-other-windows-flag
1020 (delete-other-windows)))
1022 ;; FIXME: Maybe out of date? --xfq
1023 (if (boundp 'customize-package-emacs-version-alist
)
1024 (add-to-list 'customize-package-emacs-version-alist
1025 '(MH-E ("6.0" .
"22.1") ("6.1" .
"22.1") ("7.0" .
"22.1")
1026 ("7.1" .
"22.1") ("7.2" .
"22.1") ("7.3" .
"22.1")
1027 ("7.4" .
"22.1") ("8.0" .
"22.1"))))
1031 ;;; MH-E Customization Groups
1033 (defgroup-mh mh-e nil
1034 "Emacs interface to the MH mail system.
1035 MH is the Rand Mail Handler. Other implementations include nmh
1037 :link
'(custom-manual "(mh-e)Top")
1039 :package-version
'(MH-E .
"8.0"))
1041 (defgroup-mh mh-alias nil
1043 :link
'(custom-manual "(mh-e)Aliases")
1046 :package-version
'(MH-E .
"7.1"))
1048 (defgroup-mh mh-folder nil
1049 "Organizing your mail with folders."
1051 :link
'(custom-manual "(mh-e)Folders")
1053 :package-version
'(MH-E .
"7.1"))
1055 (defgroup-mh mh-folder-selection nil
1058 :link
'(custom-manual "(mh-e)Folder Selection")
1060 :package-version
'(MH-E .
"8.0"))
1062 (defgroup-mh mh-identity nil
1064 :link
'(custom-manual "(mh-e)Identities")
1065 :prefix
"mh-identity-"
1067 :package-version
'(MH-E .
"7.1"))
1069 (defgroup-mh mh-inc nil
1070 "Incorporating your mail."
1072 :link
'(custom-manual "(mh-e)Incorporating Mail")
1074 :package-version
'(MH-E .
"8.0"))
1076 (defgroup-mh mh-junk nil
1077 "Dealing with junk mail."
1078 :link
'(custom-manual "(mh-e)Junk")
1081 :package-version
'(MH-E .
"7.3"))
1083 (defgroup-mh mh-letter nil
1086 :link
'(custom-manual "(mh-e)Editing Drafts")
1088 :package-version
'(MH-E .
"7.1"))
1090 (defgroup-mh mh-ranges nil
1093 :link
'(custom-manual "(mh-e)Ranges")
1095 :package-version
'(MH-E .
"8.0"))
1097 (defgroup-mh mh-scan-line-formats nil
1098 "Scan line formats."
1099 :link
'(custom-manual "(mh-e)Scan Line Formats")
1102 :package-version
'(MH-E .
"8.0"))
1104 (defgroup-mh mh-search nil
1106 :link
'(custom-manual "(mh-e)Searching")
1107 :prefix
"mh-search-"
1109 :package-version
'(MH-E .
"8.0"))
1111 (defgroup-mh mh-sending-mail nil
1114 :link
'(custom-manual "(mh-e)Sending Mail")
1116 :package-version
'(MH-E .
"8.0"))
1118 (defgroup-mh mh-sequences nil
1121 :link
'(custom-manual "(mh-e)Sequences")
1123 :package-version
'(MH-E .
"8.0"))
1125 (defgroup-mh mh-show nil
1126 "Reading your mail."
1128 :link
'(custom-manual "(mh-e)Reading Mail")
1130 :package-version
'(MH-E .
"7.1"))
1132 (defgroup-mh mh-speedbar nil
1135 :link
'(custom-manual "(mh-e)Speedbar")
1137 :package-version
'(MH-E .
"8.0"))
1139 (defgroup-mh mh-thread nil
1141 :prefix
"mh-thread-"
1142 :link
'(custom-manual "(mh-e)Threading")
1144 :package-version
'(MH-E .
"8.0"))
1146 (defgroup-mh mh-tool-bar nil
1148 :link
'(custom-manual "(mh-e)Tool Bar")
1151 :package-version
'(MH-E .
"8.0"))
1153 (defgroup-mh mh-hooks nil
1155 :link
'(custom-manual "(mh-e)Top")
1158 :package-version
'(MH-E .
"7.1"))
1160 (defgroup-mh mh-faces nil
1161 "Faces used in MH-E."
1162 :link
'(custom-manual "(mh-e)Top")
1166 :package-version
'(MH-E .
"7.1"))
1170 ;;; MH-E Customization
1172 ;; See Variant Support, above, for mh-e group.
1174 ;;; Aliases (:group 'mh-alias)
1176 (defcustom-mh mh-alias-completion-ignore-case-flag t
1177 "*Non-nil means don't consider case significant in MH alias completion.
1179 As MH ignores case in the aliases, so too does MH-E. However, you
1180 may turn off this option to make case significant which can be
1181 used to segregate completion of your aliases. You might use
1182 lowercase for mailing lists and uppercase for people."
1185 :package-version
'(MH-E .
"7.1"))
1187 (defcustom-mh mh-alias-expand-aliases-flag nil
1188 "*Non-nil means to expand aliases entered in the minibuffer.
1190 In other words, aliases entered in the minibuffer will be
1191 expanded to the full address in the message draft. By default,
1192 this expansion is not performed."
1195 :package-version
'(MH-E .
"7.1"))
1197 (defcustom-mh mh-alias-flash-on-comma t
1198 "*Specify whether to flash address or warn on translation.
1200 This option controls the behavior when a [comma] is pressed while
1201 entering aliases or addresses. The default setting flashes the
1202 address associated with an address in the minibuffer briefly, but
1203 does not display a warning if the alias is not found."
1204 :type
'(choice (const :tag
"Flash but Don't Warn If No Alias" t
)
1205 (const :tag
"Flash and Warn If No Alias" 1)
1206 (const :tag
"Don't Flash Nor Warn If No Alias" nil
))
1208 :package-version
'(MH-E .
"7.1"))
1210 (defcustom-mh mh-alias-insert-file nil
1211 "*Filename used to store a new MH-E alias.
1213 The default setting of this option is \"Use Aliasfile Profile
1214 Component\". This option can also hold the name of a file or a
1215 list a file names. If this option is set to a list of file names,
1216 or the \"Aliasfile:\" profile component contains more than one file
1217 name, MH-E will prompt for one of them when MH-E adds an alias."
1218 :type
'(choice (const :tag
"Use Aliasfile Profile Component" nil
)
1219 (file :tag
"Alias File")
1220 (repeat :tag
"List of Alias Files" file
))
1222 :package-version
'(MH-E .
"7.1"))
1224 (defcustom-mh mh-alias-insertion-location
'sorted
1225 "Specifies where new aliases are entered in alias files.
1227 This option is set to \"Alphabetical\" by default. If you organize
1228 your alias file in other ways, then adding aliases to the \"Top\"
1229 or \"Bottom\" of your alias file might be more appropriate."
1230 :type
'(choice (const :tag
"Alphabetical" sorted
)
1231 (const :tag
"Top" top
)
1232 (const :tag
"Bottom" bottom
))
1234 :package-version
'(MH-E .
"7.1"))
1236 (defcustom-mh mh-alias-local-users t
1237 "*Non-nil means local users are added to alias completion.
1239 Aliases are created from \"/etc/passwd\" entries with a user ID
1240 larger than a magical number, typically 200. This can be a handy
1241 tool on a machine where you and co-workers exchange messages.
1242 These aliases have the form \"local.first.last\" if a real name is
1243 present in the password file. Otherwise, the alias will have the
1244 form \"local.login\".
1246 If you're on a system with thousands of users you don't know, and
1247 the loading of local aliases slows MH-E down noticeably, then
1248 turn this option off.
1250 This option also takes a string which is executed to generate the
1251 password file. For example, use \"ypcat passwd\" to obtain the
1253 :type
'(choice (boolean) (string))
1255 :package-version
'(MH-E .
"7.1"))
1257 (defcustom-mh mh-alias-local-users-prefix
"local."
1258 "*String prefixed to the real names of users from the password file.
1259 This option can also be set to \"Use Login\".
1261 For example, consider the following password file entry:
1263 psg:x:1000:1000:Peter S Galbraith,,,:/home/psg:/bin/tcsh
1265 The following settings of this option will produce the associated
1268 \"local.\" local.peter.galbraith
1269 \"\" peter.galbraith
1272 This option has no effect if variable `mh-alias-local-users' is
1274 :type
'(choice (const :tag
"Use Login" nil
)
1277 :package-version
'(MH-E .
"7.4"))
1279 (defcustom-mh mh-alias-passwd-gecos-comma-separator-flag t
1280 "*Non-nil means the gecos field in the password file uses a comma separator.
1282 In the example in `mh-alias-local-users-prefix', commas are used
1283 to separate different values within the so-called gecos field.
1284 This is a fairly common usage. However, in the rare case that the
1285 gecos field in your password file is not separated by commas and
1286 whose contents may contain commas, you can turn this option off."
1289 :package-version
'(MH-E .
"7.4"))
1291 ;;; Organizing Your Mail with Folders (:group 'mh-folder)
1293 (defcustom-mh mh-new-messages-folders t
1294 "Folders searched for the \"unseen\" sequence.
1296 Set this option to \"Inbox\" to search the \"+inbox\" folder or
1297 \"All\" to search all of the top level folders. Otherwise, list
1298 the folders that should be searched with the \"Choose Folders\"
1301 See also `mh-recursive-folders-flag'."
1302 :type
'(choice (const :tag
"Inbox" t
)
1303 (const :tag
"All" nil
)
1304 (repeat :tag
"Choose Folders" (string :tag
"Folder")))
1306 :package-version
'(MH-E .
"8.0"))
1308 (defcustom-mh mh-ticked-messages-folders t
1309 "Folders searched for `mh-tick-seq'.
1311 Set this option to \"Inbox\" to search the \"+inbox\" folder or
1312 \"All\" to search all of the top level folders. Otherwise, list
1313 the folders that should be searched with the \"Choose Folders\"
1316 See also `mh-recursive-folders-flag'."
1317 :type
'(choice (const :tag
"Inbox" t
)
1318 (const :tag
"All" nil
)
1319 (repeat :tag
"Choose Folders" (string :tag
"Folder")))
1321 :package-version
'(MH-E .
"8.0"))
1323 (defcustom-mh mh-large-folder
200
1324 "The number of messages that indicates a large folder.
1326 If a folder is deemed to be large, that is the number of messages
1327 in it exceed this value, then confirmation is needed when it is
1328 visited. Even when `mh-show-threads-flag' is non-nil, the folder
1329 is not automatically threaded, if it is large. If set to nil all
1330 folders are treated as if they are small."
1331 :type
'(choice (const :tag
"No Limit") integer
)
1333 :package-version
'(MH-E .
"7.0"))
1335 (defcustom-mh mh-recenter-summary-flag nil
1336 "*Non-nil means to recenter the summary window.
1338 If this option is turned on, recenter the summary window when the
1339 show window is toggled off."
1342 :package-version
'(MH-E .
"7.0"))
1344 (defcustom-mh mh-recursive-folders-flag nil
1345 "*Non-nil means that commands which operate on folders do so recursively."
1348 :package-version
'(MH-E .
"7.0"))
1350 (defcustom-mh mh-sortm-args nil
1351 "*Additional arguments for \"sortm\"\\<mh-folder-mode-map>.
1353 This option is consulted when a prefix argument is used with
1354 \\[mh-sort-folder]. Normally default arguments to \"sortm\" are
1355 specified in the MH profile. This option may be used to provide
1356 an alternate view. For example, \"'(\"-nolimit\" \"-textfield\"
1357 \"subject\")\" is a useful setting."
1358 :type
'(repeat string
)
1360 :package-version
'(MH-E .
"8.0"))
1362 ;;; Folder Selection (:group 'mh-folder-selection)
1364 (defcustom-mh mh-default-folder-for-message-function nil
1365 "Function to select a default folder for refiling or \"Fcc:\".
1367 When this function is called, the current buffer contains the message
1368 being refiled and point is at the start of the message. This function
1369 should return the default folder as a string with a leading \"+\"
1370 sign. It can also return nil so that the last folder name is used as
1371 the default, or an empty string to suppress the default entirely."
1372 :type
'(choice (const nil
) function
)
1373 :group
'mh-folder-selection
1374 :package-version
'(MH-E .
"8.0"))
1376 (defcustom-mh mh-default-folder-list nil
1377 "*List of addresses and folders.
1379 The folder name associated with the first address found in this
1380 list is used as the default for `mh-refile-msg' and similar
1381 functions. Each element in this list contains a \"Check Recipient\"
1382 item. If this item is turned on, then the address is checked
1383 against the recipient instead of the sender. This is useful for
1386 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1387 for more information."
1388 :type
'(repeat (list (regexp :tag
"Address")
1389 (string :tag
"Folder")
1390 (boolean :tag
"Check Recipient")))
1391 :group
'mh-folder-selection
1392 :package-version
'(MH-E .
"7.2"))
1394 (defcustom-mh mh-default-folder-must-exist-flag t
1395 "*Non-nil means guessed folder name must exist to be used.
1397 If the derived folder does not exist, and this option is on, then
1398 the last folder name used is suggested. This is useful if you get
1399 mail from various people for whom you have an alias, but file
1400 them all in the same project folder.
1402 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1403 for more information."
1405 :group
'mh-folder-selection
1406 :package-version
'(MH-E .
"7.2"))
1408 (defcustom-mh mh-default-folder-prefix
""
1409 "*Prefix used for folder names generated from aliases.
1410 The prefix is used to prevent clutter in your mail directory.
1412 See `mh-prompt-for-refile-folder' and `mh-folder-from-address'
1413 for more information."
1415 :group
'mh-folder-selection
1416 :package-version
'(MH-E .
"7.2"))
1418 ;;; Identities (:group 'mh-identity)
1421 (unless (fboundp 'mh-identity-make-menu-no-autoload
)
1422 (defun mh-identity-make-menu-no-autoload ()
1423 "Temporary definition.
1424 Real definition will take effect when mh-identity is loaded."
1427 (defcustom-mh mh-identity-list nil
1428 "*List of identities.
1430 To customize this option, click on the \"INS\" button and enter a label
1431 such as \"Home\" or \"Work\". Then click on the \"INS\" button with the
1432 label \"Add at least one item below\". Then choose one of the items in
1435 You can specify an alternate \"From:\" header field using the \"From
1436 Field\" menu item. You must include a valid email address. A standard
1437 format is \"First Last <login@@host.domain>\". If you use an initial
1438 with a period, then you must quote your name as in '\"First I. Last\"
1439 <login@@host.domain>'. People usually list the name of the company
1440 where they work using the \"Organization Field\" menu item. Set any
1441 arbitrary header field and value in the \"Other Field\" menu item.
1442 Unless the header field is a standard one, precede the name of your
1443 field's label with \"X-\", as in \"X-Fruit-of-the-Day:\". The value of
1444 \"Attribution Verb\" overrides the setting of
1445 `mh-extract-from-attribution-verb'. Set your signature with the
1446 \"Signature\" menu item. You can specify the contents of
1447 `mh-signature-file-name', a file, or a function. Specify a different
1448 key to sign or encrypt messages with the \"GPG Key ID\" menu item.
1450 You can select the identities you have added via the menu called
1451 \"Identity\" in the MH-Letter buffer. You can also use
1452 \\[mh-insert-identity]. To clear the fields and signature added by the
1453 identity, select the \"None\" identity.
1455 The \"Identity\" menu contains two other items to save you from having
1456 to set the identity on every message. The menu item \"Set Default for
1457 Session\" can be used to set the default identity to the current
1458 identity until you exit Emacs. The menu item \"Save as Default\" sets
1459 the option `mh-identity-default' to the current identity setting. You
1460 can also customize the `mh-identity-default' option in the usual
1462 :type
'(repeat (list :tag
""
1463 (string :tag
"Label")
1464 (repeat :tag
"Add at least one item below"
1466 (cons :tag
"From Field"
1468 (string :tag
"Value"))
1469 (cons :tag
"Organization Field"
1470 (const "Organization")
1471 (string :tag
"Value"))
1472 (cons :tag
"Other Field"
1473 (string :tag
"Field")
1474 (string :tag
"Value"))
1475 (cons :tag
"Attribution Verb"
1476 (const ":attribution-verb")
1477 (string :tag
"Value"))
1478 (cons :tag
"Signature"
1479 (const :tag
"Signature"
1482 (const :tag
"mh-signature-file-name"
1486 (cons :tag
"GPG Key ID"
1487 (const :tag
"GPG Key ID"
1488 ":pgg-default-user-id")
1489 (string :tag
"Value"))))))
1490 :set
(lambda (symbol value
)
1491 (set-default symbol value
)
1492 (mh-identity-make-menu-no-autoload))
1494 :package-version
'(MH-E .
"7.1"))
1496 (defcustom-mh mh-auto-fields-list nil
1497 "List of recipients for which header lines are automatically inserted.
1499 This option can be used to set the identity depending on the
1500 recipient. To customize this option, click on the \"INS\" button and
1501 enter a regular expression for the recipient's address. Click on the
1502 \"INS\" button with the \"Add at least one item below\" label. Then choose
1503 one of the items in the \"Value Menu\".
1505 The \"Identity\" menu item is used to select an identity from those
1506 configured in `mh-identity-list'. All of the information for that
1507 identity will be added if the recipient matches. The \"Fcc Field\" menu
1508 item is used to select a folder that is used in the \"Fcc:\" header.
1509 When you send the message, MH will put a copy of your message in this
1510 folder. The \"Mail-Followup-To Field\" menu item is used to insert an
1511 \"Mail-Followup-To:\" header field with the recipients you provide. If
1512 the recipient's mail user agent supports this header field (as nmh
1513 does), then their replies will go to the addresses listed. This is
1514 useful if their replies go both to the list and to you and you don't
1515 have a mechanism to suppress duplicates. If you reply to someone not
1516 on the list, you must either remove the \"Mail-Followup-To:\" field, or
1517 ensure the recipient is also listed there so that he receives replies
1518 to your reply. Other header fields may be added using the \"Other
1521 These fields can only be added after the recipient is known. Once the
1522 header contains one or more recipients, run the
1523 \\[mh-insert-auto-fields] command or choose the \"Identity -> Insert
1524 Auto Fields\" menu item to insert these fields manually. However, you
1525 can just send the message and the fields will be added automatically.
1526 You are given a chance to see these fields and to confirm them before
1527 the message is actually sent. You can do away with this confirmation
1528 by turning off the option `mh-auto-fields-prompt-flag'.
1530 You should avoid using the same header field in `mh-auto-fields-list'
1531 and `mh-identity-list' definitions that may apply to the same message
1532 as the result is undefined."
1535 (string :tag
"Recipient")
1536 (repeat :tag
"Add at least one item below"
1538 (cons :tag
"Identity"
1543 (function (lambda (arg) `(const ,arg
)))
1544 (mapcar 'car mh-identity-list
))))
1545 (cons :tag
"Fcc Field"
1547 (string :tag
"Value"))
1548 (cons :tag
"Mail-Followup-To Field"
1549 (const "Mail-Followup-To")
1550 (string :tag
"Value"))
1551 (cons :tag
"Other Field"
1552 (string :tag
"Field")
1553 (string :tag
"Value"))))))
1555 :package-version
'(MH-E .
"7.3"))
1557 (defcustom-mh mh-auto-fields-prompt-flag t
1558 "*Non-nil means to prompt before sending if fields inserted.
1559 See `mh-auto-fields-list'."
1562 :package-version
'(MH-E .
"8.0"))
1564 (defcustom-mh mh-identity-default nil
1565 "Default identity to use when `mh-letter-mode' is called.
1566 See `mh-identity-list'."
1569 (cons '(const :tag
"None" nil
)
1570 (mapcar (function (lambda (arg) `(const ,arg
)))
1571 (mapcar 'car mh-identity-list
))))
1573 :package-version
'(MH-E .
"7.1"))
1575 (defcustom-mh mh-identity-handlers
1576 '(("From" . mh-identity-handler-top
)
1577 (":default" . mh-identity-handler-bottom
)
1578 (":attribution-verb" . mh-identity-handler-attribution-verb
)
1579 (":signature" . mh-identity-handler-signature
)
1580 (":pgg-default-user-id" . mh-identity-handler-gpg-identity
))
1581 "Handler functions for fields in `mh-identity-list'.
1583 This option is used to change the way that fields, signatures,
1584 and attributions in `mh-identity-list' are added. To customize
1585 `mh-identity-handlers', replace the name of an existing handler
1586 function associated with the field you want to change with the
1587 name of a function you have written. You can also click on an
1588 \"INS\" button and insert a field of your choice and the name of
1589 the function you have written to handle it.
1591 The \"Field\" field can be any field that you've used in your
1592 `mh-identity-list'. The special fields \":attribution-verb\",
1593 \":signature\", or \":pgg-default-user-id\" are used for the
1594 `mh-identity-list' choices \"Attribution Verb\", \"Signature\", and
1595 \"GPG Key ID\" respectively.
1597 The handler associated with the \":default\" field is used when no
1598 other field matches.
1600 The handler functions are passed two or three arguments: the
1601 FIELD itself (for example, \"From\"), or one of the special
1602 fields (for example, \":signature\"), and the ACTION 'remove or
1603 'add. If the action is 'add, an additional argument
1604 containing the VALUE for the field is given."
1605 :type
'(repeat (cons (string :tag
"Field") function
))
1607 :package-version
'(MH-E .
"8.0"))
1609 ;;; Incorporating Your Mail (:group 'mh-inc)
1611 (defcustom-mh mh-inc-prog
"inc"
1612 "*Program to incorporate new mail into a folder.
1614 This program generates a one-line summary for each of the new
1615 messages. Unless it is an absolute pathname, the file is assumed
1616 to be in the `mh-progs' directory. You may also link a file to
1617 \"inc\" that uses a different format. You'll then need to modify
1618 several scan line format variables appropriately."
1621 :package-version
'(MH-E .
"6.0"))
1624 (unless (fboundp 'mh-inc-spool-make-no-autoload
)
1625 (defun mh-inc-spool-make-no-autoload ()
1626 "Temporary definition.
1627 Real definition will take effect when mh-inc is loaded."
1630 (defcustom-mh mh-inc-spool-list nil
1631 "*Alternate spool files.
1633 You can use the `mh-inc-spool-list' variable to direct MH-E to
1634 retrieve mail from arbitrary spool files other than your system
1635 mailbox, file it in folders other than your \"+inbox\", and assign
1636 key bindings to incorporate this mail.
1638 Suppose you are subscribed to the \"mh-e-devel\" mailing list and
1639 you use \"procmail\" to filter this mail into \"~/mail/mh-e\" with
1640 the following recipe in \".procmailrc\":
1644 * ^From mh-e-devel-admin@stop.mail-abuse.org
1647 In order to incorporate \"~/mail/mh-e\" into \"+mh-e\" with an
1648 \"I m\" (mh-inc-spool-mh-e) command, customize this option, and click
1649 on the \"INS\" button. Enter a \"Spool File\" of \"~/mail/mh-e\", a
1650 \"Folder\" of \"mh-e\", and a \"Key Binding\" of \"m\".
1652 You can use \"xbuffy\" to automate the incorporation of this mail
1653 using the Emacs 22 command \"emacsclient\" as follows:
1660 command emacsclient --eval '(mh-inc-spool-mh-e)'
1662 In XEmacs, the command \"gnuclient\" is used in a similar
1664 :type
'(repeat (list (file :tag
"Spool File")
1665 (string :tag
"Folder")
1666 (character :tag
"Key Binding")))
1667 :set
(lambda (symbol value
)
1668 (set-default symbol value
)
1669 (mh-inc-spool-make-no-autoload))
1671 :package-version
'(MH-E .
"7.3"))
1673 ;;; Dealing with Junk Mail (:group 'mh-junk)
1675 (defvar mh-junk-choice nil
1676 "Chosen spam fighting program.")
1678 ;; Available spam filter interfaces
1679 (defvar mh-junk-function-alist
1680 '((spamassassin mh-spamassassin-blacklist mh-spamassassin-whitelist
)
1681 (bogofilter mh-bogofilter-blacklist mh-bogofilter-whitelist
)
1682 (spamprobe mh-spamprobe-blacklist mh-spamprobe-whitelist
))
1683 "Available choices of spam programs to use.
1685 This is an alist. For each element there are functions that
1686 blacklist a message as spam and whitelist a message incorrectly
1687 classified as spam.")
1689 (defun mh-junk-choose (symbol value
)
1690 "Choose spam program to use.
1692 The function is always called with SYMBOL bound to
1693 `mh-junk-program' and VALUE bound to the new value of
1694 `mh-junk-program'. The function sets the variable
1695 `mh-junk-choice' in addition to `mh-junk-program'."
1696 (set symbol value
) ;XXX shouldn't this be set-default?
1697 (setq mh-junk-choice
1699 (loop for element in mh-junk-function-alist
1700 until
(executable-find (symbol-name (car element
)))
1701 finally return
(car element
)))))
1703 (defcustom-mh mh-junk-background nil
1704 "If on, spam programs are run in background.
1706 By default, the programs are run in the foreground, but this can
1707 be slow when junking large numbers of messages. If you have
1708 enough memory or don't junk that many messages at the same time,
1709 you might try turning on this option.
1711 Note that this option is used as the \"display\" argument in the
1712 call to `call-process'. Therefore, turning on this option means
1713 setting its value to \"0\". You can also set its value to t to
1714 direct the programs' output to the \"*MH-E Log*\" buffer; this
1715 may be useful for debugging."
1716 :type
'(choice (const :tag
"Off" nil
)
1717 (const :tag
"On" 0))
1719 :package-version
'(MH-E .
"8.0"))
1721 (defcustom-mh mh-junk-disposition nil
1722 "Disposition of junk mail."
1723 :type
'(choice (const :tag
"Delete Spam" nil
)
1724 (string :tag
"Spam Folder"))
1726 :package-version
'(MH-E .
"8.0"))
1728 (defcustom-mh mh-junk-program nil
1729 "Spam program that MH-E should use.
1731 The default setting of this option is \"Auto-detect\" which means
1732 that MH-E will automatically choose one of SpamAssassin,
1733 bogofilter, or SpamProbe in that order. If, for example, you have
1734 both SpamAssassin and bogofilter installed and you want to use
1735 bogofilter, then you can set this option to \"Bogofilter\"."
1736 :type
'(choice (const :tag
"Auto-detect" nil
)
1737 (const :tag
"SpamAssassin" spamassassin
)
1738 (const :tag
"Bogofilter" bogofilter
)
1739 (const :tag
"SpamProbe" spamprobe
))
1740 :set
'mh-junk-choose
1742 :package-version
'(MH-E .
"7.3"))
1744 ;;; Editing a Draft (:group 'mh-letter)
1746 (defcustom-mh mh-compose-insertion
(if (locate-library "mml") 'mml
'mh
)
1747 "Type of tags used when composing MIME messages.
1749 In addition to MH-style directives, MH-E also supports MML (MIME
1750 Meta Language) tags. (see Info node `(emacs-mime)Composing').
1751 This option can be used to choose between them. By default, this
1752 option is set to \"MML\" if it is supported since it provides a
1753 lot more functionality. This option can also be set to \"MH\" if
1754 MH-style directives are preferred."
1755 :type
'(choice (const :tag
"MML" mml
)
1756 (const :tag
"MH" mh
))
1758 :package-version
'(MH-E .
"7.0"))
1760 (defcustom-mh mh-compose-skipped-header-fields
1761 '("From" "Organization" "References" "In-Reply-To"
1762 "X-Face" "Face" "X-Image-URL" "X-Mailer")
1763 "List of header fields to skip over when navigating in draft."
1764 :type
'(repeat (string :tag
"Field"))
1766 :package-version
'(MH-E .
"7.4"))
1768 (defcustom-mh mh-compose-space-does-completion-flag nil
1769 "*Non-nil means \\<mh-letter-mode-map>\\[mh-letter-complete-or-space] does completion in message header."
1772 :package-version
'(MH-E .
"7.4"))
1774 (defcustom-mh mh-delete-yanked-msg-window-flag nil
1775 "*Non-nil means delete any window displaying the message.
1777 This deletes the window containing the original message after
1778 yanking it with \\<mh-letter-mode-map>\\[mh-yank-cur-msg] to make
1779 more room on your screen for your reply."
1782 :package-version
'(MH-E .
"7.0"))
1784 (defcustom-mh mh-extract-from-attribution-verb
"wrote:"
1785 "*Verb to use for attribution when a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg].
1787 The attribution consists of the sender's name and email address
1788 followed by the content of this option. This option can be set to
1789 \"wrote:\", \"a écrit:\", and \"schrieb:\". You can also use the
1790 \"Custom String\" menu item to enter your own verb."
1791 :type
'(choice (const "wrote:")
1794 (string :tag
"Custom String"))
1796 :package-version
'(MH-E .
"7.0"))
1798 (defcustom-mh mh-ins-buf-prefix
"> "
1799 "*String to put before each line of a yanked or inserted message.
1801 The prefix \"> \" is the default setting of this option. I
1802 suggest that you not modify this option since it is used by many
1803 mailers and news readers: messages are far easier to read if
1804 several included messages have all been indented by the same
1807 This prefix is not inserted if you use one of the supercite
1808 flavors of `mh-yank-behavior' or you have added a
1809 `mail-citation-hook'."
1812 :package-version
'(MH-E .
"6.0"))
1814 (defcustom-mh mh-letter-complete-function
'ispell-complete-word
1815 "*Function to call when completing outside of address or folder fields.
1817 In the body of the message,
1818 \\<mh-letter-mode-map>\\[mh-letter-complete] runs this function,
1819 which is set to \"ispell-complete-word\" by default."
1820 :type
'(choice function
(const nil
))
1822 :package-version
'(MH-E .
"7.1"))
1824 (defcustom-mh mh-letter-fill-column
72
1825 "*Fill column to use in MH Letter mode.
1827 By default, this option is 72 to allow others to quote your
1828 message without line wrapping."
1831 :package-version
'(MH-E .
"6.0"))
1833 (defcustom-mh mh-mml-method-default
(if mh-pgp-support-flag
"pgpmime" "none")
1834 "Default method to use in security tags.
1836 This option is used to select between a variety of mail security
1837 mechanisms. The default is \"PGP (MIME)\" if it is supported\;
1838 otherwise, the default is \"None\". Other mechanisms include
1839 vanilla \"PGP\" and \"S/MIME\".
1841 The `pgg' customization group may have some settings which may
1842 interest you (see Info node `(pgg)').
1844 In particular, I turn on the option `pgg-encrypt-for-me' so that
1845 all messages I encrypt are encrypted with my public key as well.
1846 If you keep a copy of all of your outgoing mail with a \"Fcc:\"
1847 header field, this setting is vital so that you can read the mail
1849 :type
'(choice (const :tag
"PGP (MIME)" "pgpmime")
1850 (const :tag
"PGP" "pgp")
1851 (const :tag
"S/MIME" "smime")
1852 (const :tag
"None" "none"))
1854 :package-version
'(MH-E .
"8.0"))
1856 (defcustom-mh mh-signature-file-name
"~/.signature"
1857 "*Source of user's signature.
1859 By default, the text of your signature is taken from the file
1860 \"~/.signature\". You can read from other sources by changing this
1861 option. This file may contain a vCard in which case an attachment is
1862 added with the vCard.
1864 This option may also be a symbol, in which case that function is
1865 called. You may not want a signature separator to be added for you;
1866 instead you may want to insert one yourself. Options that you may find
1867 useful to do this include `mh-signature-separator' (when inserting a
1868 signature separator) and `mh-signature-separator-regexp' (for finding
1869 said separator). The function `mh-signature-separator-p', which
1870 reports t if the buffer contains a separator, may be useful as well.
1872 The signature is inserted into your message with the command
1873 \\<mh-letter-mode-map>\\[mh-insert-signature] or with the option
1874 `mh-identity-list'."
1877 :package-version
'(MH-E .
"6.0"))
1879 (defcustom-mh mh-signature-separator-flag t
1880 "*Non-nil means a signature separator should be inserted.
1882 It is not recommended that you change this option since various
1883 mail user agents, including MH-E, use the separator to present
1884 the signature differently, and to suppress the signature when
1885 replying or yanking a letter into a draft."
1888 :package-version
'(MH-E .
"8.0"))
1890 (defcustom-mh mh-x-face-file
"~/.face"
1891 "*File containing face header field to insert in outgoing mail.
1893 If the file starts with either of the strings \"X-Face:\", \"Face:\"
1894 or \"X-Image-URL:\" then the contents are added to the message header
1895 verbatim. Otherwise it is assumed that the file contains the value of
1896 the \"X-Face:\" header field.
1898 The \"X-Face:\" header field, which is a low-resolution, black and
1899 white image, can be generated using the \"compface\" command (see URL
1900 `ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.Z'). The
1901 \"Online X-Face Converter\" is a useful resource for quick conversion
1902 of images into \"X-Face:\" header fields (see URL
1903 `http://www.dairiki.org/xface/').
1905 Use the \"make-face\" script to convert a JPEG image to the higher
1906 resolution, color, \"Face:\" header field (see URL
1907 `http://quimby.gnus.org/circus/face/make-face').
1909 The URL of any image can be used for the \"X-Image-URL:\" field and no
1910 processing of the image is required.
1912 To prevent the setting of any of these header fields, either set
1913 `mh-x-face-file' to nil, or simply ensure that the file defined by
1914 this option doesn't exist."
1917 :package-version
'(MH-E .
"7.0"))
1919 (defcustom-mh mh-yank-behavior
'attribution
1920 "*Controls which part of a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg].
1922 To include the entire message, including the entire header, use
1923 \"Body and Header\". Use \"Body\" to yank just the body without
1924 the header. To yank only the portion of the message following the
1925 point, set this option to \"Below Point\".
1927 Choose \"Invoke supercite\" to pass the entire message and header
1930 If the \"Body With Attribution\" setting is used, then the
1931 message minus the header is yanked and a simple attribution line
1932 is added at the top using the value of the option
1933 `mh-extract-from-attribution-verb'. This is the default.
1935 If the \"Invoke supercite\" or \"Body With Attribution\" settings
1936 are used, the \"-noformat\" argument is passed to the \"repl\"
1937 program to override a \"-filter\" or \"-format\" argument. These
1938 settings also have \"Automatically\" variants that perform the
1939 action automatically when you reply so that you don't need to use
1940 \\[mh-yank-cur-msg] at all. Note that this automatic action is
1941 only performed if the show buffer matches the message being
1942 replied to. People who use the automatic variants tend to turn on
1943 the option `mh-delete-yanked-msg-window-flag' as well so that the
1944 show window is never displayed.
1946 If the show buffer has a region, the option `mh-yank-behavior' is
1947 ignored unless its value is one of Attribution variants in which
1948 case the attribution is added to the yanked region.
1950 If this option is set to one of the supercite flavors, the hook
1951 `mail-citation-hook' is ignored and `mh-ins-buf-prefix' is not
1953 :type
'(choice (const :tag
"Body and Header" t
)
1954 (const :tag
"Body" body
)
1955 (const :tag
"Below Point" nil
)
1956 (const :tag
"Invoke supercite" supercite
)
1957 (const :tag
"Invoke supercite, Automatically" autosupercite
)
1958 (const :tag
"Body With Attribution" attribution
)
1959 (const :tag
"Body With Attribution, Automatically"
1962 :package-version
'(MH-E .
"8.0"))
1964 ;;; Ranges (:group 'mh-ranges)
1966 (defcustom-mh mh-interpret-number-as-range-flag t
1967 "*Non-nil means interpret a number as a range.
1969 Since one of the most frequent ranges used is \"last:N\", MH-E
1970 will interpret input such as \"200\" as \"last:200\" if this
1971 option is on (which is the default). If you need to scan just the
1972 message 200, then use the range \"200:200\"."
1975 :package-version
'(MH-E .
"7.4"))
1977 ;;; Scan Line Formats (:group 'mh-scan-line-formats)
1980 (unless (fboundp 'mh-adaptive-cmd-note-flag-check
)
1981 (defun mh-adaptive-cmd-note-flag-check (symbol value
)
1982 "Temporary definition.
1983 Real definition, below, uses variables that aren't defined yet."
1984 (set-default symbol value
))))
1986 (defcustom-mh mh-adaptive-cmd-note-flag t
1987 "*Non-nil means that the message number width is determined dynamically.
1989 If you've created your own format to handle long message numbers,
1990 you'll be pleased to know you no longer need it since MH-E adapts its
1991 internal format based upon the largest message number if this option
1992 is on (the default). This option may only be turned on when
1993 `mh-scan-format-file' is set to \"Use MH-E scan Format\".
1995 If you prefer fixed-width message numbers, turn off this option and
1996 call `mh-set-cmd-note' with the width specified by your format file
1997 \(see `mh-scan-format-file'). For example, the default width is 4, so
1998 you would use \"(mh-set-cmd-note 4)\"."
2000 :group
'mh-scan-line-formats
2001 :set
'mh-adaptive-cmd-note-flag-check
2002 :package-version
'(MH-E .
"7.0"))
2004 (defun mh-scan-format-file-check (symbol value
)
2005 "Check if desired setting is valid.
2006 Throw an error if user tries to set `mh-scan-format-file' to
2007 anything but t when `mh-adaptive-cmd-note-flag' is on. Otherwise,
2008 set SYMBOL to VALUE."
2009 (if (and (not (eq value t
))
2010 mh-adaptive-cmd-note-flag
)
2011 (error "%s %s" "You must turn off `mh-adaptive-cmd-note-flag'"
2012 "unless you use \"Use MH-E scan Format\"")
2013 (set-default symbol value
)))
2015 (defcustom-mh mh-scan-format-file t
2016 "Specifies the format file to pass to the scan program.
2018 The default setting for this option is \"Use MH-E scan Format\". This
2019 means that the format string will be taken from the either
2020 `mh-scan-format-mh' or `mh-scan-format-nmh' depending on whether MH or
2021 nmh (or GNU mailutils MH) is in use. This setting also enables you to
2022 turn on the `mh-adaptive-cmd-note-flag' option.
2024 You can also set this option to \"Use Default scan Format\" to get the
2025 same output as you would get if you ran \"scan\" from the shell. If
2026 you have a format file that you want MH-E to use but not MH, you can
2027 set this option to \"Specify a scan Format File\" and enter the name
2028 of your format file.
2030 If you change the format of the scan lines you'll need to tell MH-E
2031 how to parse the new format. As you will see, quite a lot of variables
2032 are involved to do that. Use \"\\[apropos] RET mh-scan.*regexp\" to
2033 obtain a list of these variables. You will also have to call
2034 `mh-set-cmd-note' if your notations are not in column 4 (columns in
2035 Emacs start with 0)."
2036 :type
'(choice (const :tag
"Use MH-E scan Format" t
)
2037 (const :tag
"Use Default scan Format" nil
)
2038 (file :tag
"Specify a scan Format File"))
2039 :group
'mh-scan-line-formats
2040 :set
'mh-scan-format-file-check
2041 :package-version
'(MH-E .
"6.0"))
2043 (defun mh-adaptive-cmd-note-flag-check (symbol value
)
2044 "Check if desired setting is valid.
2045 Throw an error if user tries to turn on
2046 `mh-adaptive-cmd-note-flag' when `mh-scan-format-file' isn't t.
2047 Otherwise, set SYMBOL to VALUE."
2049 (not (eq mh-scan-format-file t
)))
2050 (error "%s %s" "Can't turn on unless `mh-scan-format-file'"
2051 "is set to \"Use MH-E scan Format\"")
2052 (set-default symbol value
)))
2054 (defcustom-mh mh-scan-prog
"scan"
2055 "*Program used to scan messages.
2057 The name of the program that generates a listing of one line per
2058 message is held in this option. Unless this variable contains an
2059 absolute pathname, it is assumed to be in the `mh-progs'
2060 directory. You may link another program to `scan' (see
2061 \"mh-profile(5)\") to produce a different type of listing."
2063 :group
'mh-scan-line-formats
2064 :package-version
'(MH-E .
"6.0"))
2065 (make-variable-buffer-local 'mh-scan-prog
)
2067 ;;; Searching (:group 'mh-search)
2069 (defcustom-mh mh-search-program nil
2070 "Search program that MH-E shall use.
2072 The default setting of this option is \"Auto-detect\" which means
2073 that MH-E will automatically choose one of swish++, swish-e,
2074 mairix, namazu, pick and grep in that order. If, for example, you
2075 have both swish++ and mairix installed and you want to use
2076 mairix, then you can set this option to \"mairix\".
2078 More information about setting up an indexing program to use with
2079 MH-E can be found in the documentation of `mh-search'."
2080 :type
'(choice (const :tag
"Auto-detect" nil
)
2081 (const :tag
"swish++" swish
++)
2082 (const :tag
"swish-e" swish
)
2083 (const :tag
"mairix" mairix
)
2084 (const :tag
"namazu" namazu
)
2085 (const :tag
"pick" pick
)
2086 (const :tag
"grep" grep
))
2088 :package-version
'(MH-E .
"8.0"))
2090 ;;; Sending Mail (:group 'mh-sending-mail)
2092 (defcustom-mh mh-compose-forward-as-mime-flag t
2093 "*Non-nil means that messages are forwarded as attachments.
2095 By default, this option is on which means that the forwarded
2096 messages are included as attachments. If you would prefer to
2097 forward your messages verbatim (as text, inline), then turn off
2098 this option. Forwarding messages verbatim works well for short,
2099 textual messages, but your recipient won't be able to view any
2100 non-textual attachments that were in the forwarded message. Be
2101 aware that if you have \"forw: -mime\" in your MH profile, then
2102 forwarded messages will always be included as attachments
2103 regardless of the settings of this option."
2105 :group
'mh-sending-mail
2106 :package-version
'(MH-E .
"8.0"))
2108 (defcustom-mh mh-compose-letter-function nil
2109 "Invoked when starting a new draft.
2111 However, it is the last function called before you edit your
2112 message. The consequence of this is that you can write a function
2113 to write and send the message for you. This function is passed
2114 three arguments: the contents of the TO, SUBJECT, and CC header
2116 :type
'(choice (const nil
) function
)
2117 :group
'mh-sending-mail
2118 :package-version
'(MH-E .
"6.0"))
2120 (defcustom-mh mh-compose-prompt-flag nil
2121 "*Non-nil means prompt for header fields when composing a new draft."
2123 :group
'mh-sending-mail
2124 :package-version
'(MH-E .
"7.4"))
2126 (defcustom-mh mh-forward-subject-format
"%s: %s"
2127 "*Format string for forwarded message subject.
2129 This option is a string which includes two escapes (\"%s\"). The
2130 first \"%s\" is replaced with the sender of the original message,
2131 and the second one is replaced with the original \"Subject:\"."
2133 :group
'mh-sending-mail
2134 :package-version
'(MH-E .
"6.0"))
2136 (defcustom-mh mh-insert-x-mailer-flag t
2137 "*Non-nil means append an \"X-Mailer:\" header field to the header.
2139 This header field includes the version of MH-E and Emacs that you
2140 are using. If you don't want to participate in our marketing, you
2141 can turn this option off."
2143 :group
'mh-sending-mail
2144 :package-version
'(MH-E .
"7.0"))
2146 (defcustom-mh mh-redist-full-contents-flag nil
2147 "*Non-nil means the \"dist\" command needs entire letter for redistribution.
2149 This option must be turned on if \"dist\" requires the whole
2150 letter for redistribution, which is the case if \"send\" is
2151 compiled with the BERK option (which many people abhor). If you
2152 find that MH will not allow you to redistribute a message that
2153 has been redistributed before, turn off this option."
2155 :group
'mh-sending-mail
2156 :package-version
'(MH-E .
"8.0"))
2158 (defcustom-mh mh-reply-default-reply-to nil
2159 "*Sets the person or persons to whom a reply will be sent.
2161 This option is set to \"Prompt\" by default so that you are
2162 prompted for the recipient of a reply. If you find that most of
2163 the time that you specify \"cc\" when you reply to a message, set
2164 this option to \"cc\". Other choices include \"from\", \"to\", or
2165 \"all\". You can always edit the recipients in the draft."
2166 :type
'(choice (const :tag
"Prompt" nil
)
2171 :group
'mh-sending-mail
2172 :package-version
'(MH-E .
"6.0"))
2174 (defcustom-mh mh-reply-show-message-flag t
2175 "*Non-nil means the MH-Show buffer is displayed when replying.
2177 If you include the message automatically, you can hide the
2178 MH-Show buffer by turning off this option.
2180 See also `mh-reply'."
2182 :group
'mh-sending-mail
2183 :package-version
'(MH-E .
"7.0"))
2185 ;;; Sequences (:group 'mh-sequences)
2187 ;; If `mh-unpropagated-sequences' becomes a defcustom, add the following to
2188 ;; the docstring: "Additional sequences that should not to be preserved can be
2189 ;; specified by setting `mh-unpropagated-sequences' appropriately." XXX
2191 (defcustom-mh mh-refile-preserves-sequences-flag t
2192 "*Non-nil means that sequences are preserved when messages are refiled.
2194 If a message is in any sequence (except \"Previous-Sequence:\"
2195 and \"cur\") when it is refiled, then it will still be in those
2196 sequences in the destination folder. If this behavior is not
2197 desired, then turn off this option."
2199 :group
'mh-sequences
2200 :package-version
'(MH-E .
"7.4"))
2202 (defcustom-mh mh-tick-seq
'tick
2203 "The name of the MH sequence for ticked messages.
2205 You can customize this option if you already use the \"tick\"
2206 sequence for your own use. You can also disable all of the
2207 ticking functions by choosing the \"Disable Ticking\" item but
2208 there isn't much advantage to that."
2209 :type
'(choice (const :tag
"Disable Ticking" nil
)
2211 :group
'mh-sequences
2212 :package-version
'(MH-E .
"7.3"))
2214 (defcustom-mh mh-update-sequences-after-mh-show-flag t
2215 "*Non-nil means flush MH sequences to disk after message is shown\\<mh-folder-mode-map>.
2217 Three sequences are maintained internally by MH-E and pushed out
2218 to MH when a message is shown. They include the sequence
2219 specified by your \"Unseen-Sequence:\" profile entry, \"cur\",
2220 and the sequence listed by the option `mh-tick-seq' which is
2221 \"tick\" by default. If you do not like this behavior, turn off
2222 this option. You can then update the state manually with the
2223 \\[mh-execute-commands], \\[mh-quit], or \\[mh-update-sequences]
2226 :group
'mh-sequences
2227 :package-version
'(MH-E .
"7.0"))
2229 (defcustom-mh mh-whitelist-preserves-sequences-flag t
2230 "*Non-nil means that sequences are preserved when messages are whitelisted.
2232 If a message is in any sequence (except \"Previous-Sequence:\"
2233 and \"cur\") when it is whitelisted, then it will still be in
2234 those sequences in the destination folder. If this behavior is
2235 not desired, then turn off this option."
2237 :group
'mh-sequences
2238 :package-version
'(MH-E .
"8.4"))
2240 ;;; Reading Your Mail (:group 'mh-show)
2242 (defcustom-mh mh-bury-show-buffer-flag t
2243 "*Non-nil means show buffer is buried.
2245 One advantage of not burying the show buffer is that one can
2246 delete the show buffer more easily in an electric buffer list
2247 because of its proximity to its associated MH-Folder buffer. Try
2248 running \\[electric-buffer-list] to see what I mean."
2251 :package-version
'(MH-E .
"7.0"))
2253 (defcustom-mh mh-clean-message-header-flag t
2254 "*Non-nil means remove extraneous header fields.
2256 See also `mh-invisible-header-fields-default' and
2257 `mh-invisible-header-fields'."
2260 :package-version
'(MH-E .
"7.0"))
2262 (defcustom-mh mh-decode-mime-flag
(not (not (locate-library "mm-decode")))
2263 "*Non-nil means attachments are handled\\<mh-folder-mode-map>.
2265 MH-E can handle attachments as well if the Gnus `mm-decode'
2266 library is present. If so, this option will be on. Otherwise,
2267 you'll see the MIME body parts rather than text or attachments.
2268 There isn't much point in turning off this option; however, you
2269 can inspect it if it appears that the body parts are not being
2270 interpreted correctly or toggle it with the command
2271 \\[mh-toggle-mh-decode-mime-flag] to view the raw message.
2273 This option also controls the display of quoted-printable
2274 messages and other graphical widgets. See the options
2275 `mh-graphical-smileys-flag' and `mh-graphical-emphasis-flag'."
2278 :package-version
'(MH-E .
"7.0"))
2280 (defcustom-mh mh-display-buttons-for-alternatives-flag nil
2281 "*Non-nil means display buttons for all alternative attachments.
2283 Sometimes, a mail program will produce multiple alternatives of
2284 the attachment in increasing degree of faithfulness to the
2285 original content. By default, only the preferred alternative is
2286 displayed. If this option is on, then the preferred part is shown
2287 inline and buttons are shown for each of the other alternatives."
2290 :package-version
'(MH-E .
"7.4"))
2292 (defcustom-mh mh-display-buttons-for-inline-parts-flag nil
2293 "*Non-nil means display buttons for all inline attachments\\<mh-folder-mode-map>.
2295 The sender can request that attachments should be viewed inline so
2296 that they do not really appear like an attachment at all to the
2297 reader. Most of the time, this is desirable, so by default MH-E
2298 suppresses the buttons for inline attachments. On the other hand, you
2299 may receive code or HTML which the sender has added to his message as
2300 inline attachments so that you can read them in MH-E. In this case, it
2301 is useful to see the buttons so that you know you don't have to cut
2302 and paste the code into a file; you can simply save the attachment.
2304 If you want to make the buttons visible for inline attachments, you
2305 can use the command \\[mh-toggle-mime-buttons] to toggle the
2306 visibility of these buttons. You can turn on these buttons permanently
2307 by turning on this option.
2309 MH-E cannot display all attachments inline however. It can display
2310 text (including HTML) and images."
2313 :package-version
'(MH-E .
"7.0"))
2315 (defcustom-mh mh-do-not-confirm-flag nil
2316 "*Non-nil means non-reversible commands do not prompt for confirmation.
2318 Commands such as `mh-pack-folder' prompt to confirm whether to
2319 process outstanding moves and deletes or not before continuing.
2320 Turning on this option means that these actions will be
2321 performed--which is usually desired but cannot be
2322 retracted--without question."
2325 :package-version
'(MH-E .
"7.0"))
2327 (defcustom-mh mh-fetch-x-image-url nil
2328 "*Control fetching of \"X-Image-URL:\" header field image.
2330 Ths option controls the fetching of the \"X-Image-URL:\" header
2331 field image with the following values:
2334 You are prompted before the image is fetched. MH-E will
2335 remember your reply and will either use the already fetched
2336 image the next time the same URL is encountered or silently
2337 skip it if you didn't fetch it the first time. This is a
2341 Images are never fetched and only displayed if they are
2342 already present in the cache. This is the default.
2344 There isn't a value of \"Always Fetch\" for privacy and DOS (denial of
2345 service) reasons. For example, fetching a URL can tip off a spammer
2346 that you've read his email (which is why you shouldn't blindly answer
2347 yes if you've set this option to \"Ask Before Fetching\"). Someone may
2348 also flood your network and fill your disk drive by sending a torrent
2349 of messages, each specifying a unique URL to a very large file.
2351 The cache of images is found in the directory \".mhe-x-image-cache\"
2352 within your MH directory. You can add your own face to the \"From:\"
2353 field too. See Info node `(mh-e)Picture'.
2355 This setting only has effect if the option `mh-show-use-xface-flag' is
2358 :type
'(choice (const :tag
"Ask Before Fetching" ask
)
2359 (const :tag
"Never Fetch" nil
))
2361 :package-version
'(MH-E .
"7.3"))
2363 (defcustom-mh mh-graphical-smileys-flag t
2364 "*Non-nil means graphical smileys are displayed.
2366 It is a long standing custom to inject body language using a
2367 cornucopia of punctuation, also known as the \"smileys\". MH-E
2368 can render these as graphical widgets if this option is turned
2369 on, which it is by default. Smileys include patterns such as :-)
2372 This option is disabled if the option `mh-decode-mime-flag' is
2376 :package-version
'(MH-E .
"7.0"))
2378 (defcustom-mh mh-graphical-emphasis-flag t
2379 "*Non-nil means graphical emphasis is displayed.
2381 A few typesetting features are indicated in ASCII text with
2382 certain characters. If your terminal supports it, MH-E can render
2383 these typesetting directives naturally if this option is turned
2384 on, which it is by default. For example, _underline_ will be
2385 underlined, *bold* will appear in bold, /italics/ will appear in
2386 italics, and so on. See the option `gnus-emphasis-alist' for the
2389 This option is disabled if the option `mh-decode-mime-flag' is
2393 :package-version
'(MH-E .
"7.0"))
2395 (defcustom-mh mh-highlight-citation-style
'gnus
2396 "Style for highlighting citations.
2398 If the sender of the message has cited other messages in his
2399 message, then MH-E will highlight these citations to emphasize
2400 the sender's actual response. This option can be customized to
2401 change the highlighting style. The \"Multicolor\" method uses a
2402 different color for each indentation while the \"Monochrome\"
2403 method highlights all citations in red. To disable highlighting
2404 of citations entirely, choose \"None\"."
2405 :type
'(choice (const :tag
"Multicolor" gnus
)
2406 (const :tag
"Monochrome" font-lock
)
2407 (const :tag
"None" nil
))
2409 :package-version
'(MH-E .
"8.0"))
2411 ;; These entries have been intentionally excluded by the developers.
2412 ;; "Comments:" ; RFC 2822 - show this one
2413 ;; "Fax:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2414 ;; "Mail-System-Version:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2415 ;; "Mailer:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2416 ;; "Organization:" ;
2417 ;; "Phone:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2418 ;; "Reply-By:" ; RFC 2156
2419 ;; "Reply-To:" ; RFC 2822
2421 ;; "User-Agent:" ; Similar to X-Mailer, so display it.
2423 ;; "X-Operator:" ; Similar to X-Mailer, so display it
2425 ;; Keep fields alphabetized with case folding. Use M-:(setq
2426 ;; sort-fold-case t) from the minibuffer to accomplish this.
2427 ;; Mention source, if known.
2428 (defvar mh-invisible-header-fields-internal
2430 "Abuse-Reports-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2433 "Accreditor:" ; Habeas
2434 "Also-Control:" ; H. Spencer: News Article Format and Transmission, June 1994
2435 "Alternate-recipient:" ; RFC 2156
2436 "Approved-By:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2437 "Approved:" ; RFC 1036
2438 "Article-Names:" ; H. Spencer: News Article Format and Transmission, June 1994
2439 "Article-Updates:" ; H. Spencer: News Article Format and Transmission, June 1994
2440 "Authentication-Results:"
2441 "Auto-forwarded:" ; RFC 2156
2442 "Autoforwarded:" ; RFC 2156
2447 "Cancel-Key:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2448 "Cancel-Lock:" ; NNTP posts
2449 "Comment:" ; Shows up with DomainKeys
2450 "Content-" ; RFC 2045, 1123, 1766, 1864, 2045, 2110, 2156, 2183, 2912
2451 "Control:" ; RFC 1036
2452 "Conversion-With-Loss:" ; RFC 2156
2453 "Conversion:" ; RFC 2156
2454 "Delivered-To:" ; Egroups/yahoogroups mailing list manager
2455 "Delivery-Date:" ; RFC 2156
2457 "Discarded-X400-" ; RFC 2156
2458 "Disclose-Recipients:" ; RFC 2156
2459 "Disposition-Notification-Options:" ; RFC 2298
2460 "Disposition-Notification-To:" ; RFC 2298
2461 "Distribution:" ; RFC 1036
2462 "DKIM-" ; http://antispam.yahoo.com/domainkeys
2463 "DL-Expansion-History:" ; RFC 2156
2464 "DomainKey-" ; http://antispam.yahoo.com/domainkeys
2465 "DomainKey-Signature:"
2466 "Encoding:" ; RFC 1505
2468 "Errors-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2469 "Expires:" ; RFC 1036
2470 "Expiry-Date:" ; RFC 2156
2471 "Face:" ; Gnus Face header
2472 "Followup-To:" ; RFC 1036
2473 "For-Approval:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2474 "For-Comment:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2475 "For-Handling:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2478 "Generate-Delivery-Report:" ; RFC 2156
2479 "Importance:" ; RFC 2156, 2421
2480 "In-Reply-To:" ; RFC 2822
2481 "Incomplete-Copy:" ; RFC 2156
2482 "Keywords:" ; RFC 2822
2483 "Language:" ; RFC 2156
2485 "List-" ; RFC 2369, 2919
2486 "Mail-Copies-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2487 "Mail-Followup-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2489 "Mail-Reply-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2490 "Mailing-List:" ; Egroups/yahoogroups mailing list manager
2491 "Message-Content:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2492 "Message-Id:" ; RFC 822
2493 "Message-Type:" ; RFC 2156
2494 "Mime-Version" ; RFC 2045
2497 "Obsoletes:" ; RFC 2156
2500 "Original-Encoded-Information-Types:" ; RFC 2156
2501 "Original-Lines:" ; mail to news
2502 "Original-Newsgroups:" ; mail to news
2503 "Original-NNTP-" ; mail to news
2504 "Original-Path:" ; mail to news
2505 "Original-Received:" ; mail to news
2506 "Original-Recipient:" ; RFC 2298
2507 "Original-To:" ; mail to news
2508 "Original-X-" ; mail to news
2509 "Origination-Client:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2510 "Originator:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2511 "P1-Content-Type:" ; X400
2512 "P1-Message-Id:" ; X400
2513 "P1-Recipient:" ; X400
2516 "Posted-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2517 "Precedence:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2519 "Prevent-NonDelivery-Report:" ; RFC 2156
2520 "Priority:" ; RFC 2156
2521 "Read-Receipt-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2522 "Received-SPF:" ; Gmail
2523 "Received:" ; RFC 822
2524 "References:" ; RFC 2822
2525 "Registered-Mail-Reply-Requested-By:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2527 "Replaces:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2529 "Resent-" ; RFC 2822
2530 "Return-Path:" ; RFC 822
2531 "Return-Receipt-Requested:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2532 "Return-Receipt-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2534 "See-Also:" ; H. Spencer: News Article Format and Transmission, June 1994
2535 "Sensitivity:" ; RFC 2156, 2421
2536 "Speech-Act:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2537 "Status:" ; sendmail
2538 "Supersedes:" ; H. Spencer: News Article Format and Transmission, June 1994
2539 "Telefax:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2543 "Translated-By:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2544 "Translation-Of:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2545 "Ua-Content-Id:" ; X400
2549 "X-Accept-Language:" ; Netscape/Mozilla
2551 "X-ACL-Warn:" ; http://www.exim.org
2552 "X-Admin:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2553 "X-Administrivia-To:"
2554 "X-AMAZON" ; Amazon.com
2555 "X-AnalysisOut:" ; Exchange
2556 "X-AntiAbuse:" ; cPanel
2557 "X-Antivirus-Scanner:"
2558 "X-AOL-IP:" ; AOL WebMail
2559 "X-Apparently-From:" ; MS Outlook
2560 "X-Apparently-To:" ; Egroups/yahoogroups mailing list manager
2563 "X-Authenticated-Info:" ; Verizon.net?
2564 "X-Authenticated-Sender:" ; AT&T Message Center (webmail)
2565 "X-Authentication-Info:" ; verizon.net?
2566 "X-Authentication-Warning:" ; sendmail
2567 "X-Authority-Analysis:"
2568 "X-Auto-Response-Suppress:" ; Exchange
2569 "X-Barracuda-" ; Barracuda spam scores
2570 "X-Bayes-Prob:" ; IEEE spam filter
2571 "X-Beenthere:" ; Mailman mailing list manager
2574 "X-Bogosity:" ; bogofilter
2575 "X-BPS1:" ; http://www.boggletools.com
2576 "X-BPS2:" ; http://www.boggletools.com
2577 "X-Brightmail-Tracker:" ; Brightmail
2578 "X-BrightmailFiltered:" ; Brightmail
2579 "X-Bugzilla-" ; Bugzilla
2580 "X-Cam-" ; Cambridge scanners
2584 "X-CanIt-Geo:" ; IEEE spam filter
2585 "X-Cloudmark-SP-" ; Cloudmark (www.cloudmark.com)
2586 "X-Comment:" ; AT&T Mailennium
2587 "X-Complaints-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2589 "X-Confirm-Reading-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2590 "X-Content-Filtered-By:"
2591 "X-ContentStamp:" ; NetZero
2592 "X-Country-Chain:" ; http://www.declude.com/x-note.htm
2593 "X-Cr-Hashedpuzzle:"
2596 "X-DCC-" ; SpamAssassin
2597 "X-Declude-" ; http://www.declude.com/x-note.htm
2601 "X-detected-operating-system:" ; GNU.ORG?
2604 "X-DocGen-Version:" ; DocGen
2606 "X-Echelon-Distraction"
2607 "X-EFL-Spamscore:" ; MIT alumni spam filtering
2608 "X-eGroups-" ; Egroups/yahoogroups mailing list manager
2610 "X-ELNK-Trace:" ; Earthlink mailer
2611 "X-EM-" ; Some ecommerce software
2612 "X-Email-Type-Id:" ; Paypal http://www.paypal.com
2613 "X-Enigmail-Version:"
2614 "X-Envelope-Date:" ; GNU mailutils
2615 "X-Envelope-From:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2616 "X-Envelope-Sender:"
2617 "X-Envelope-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2618 "X-EviteMessageId:" ; evite.com
2619 "X-Evolution:" ; Evolution mail client
2621 "X-Face:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2622 "X-Facebook" ; Facebook
2626 "X-Forwarded-" ; Google+
2628 "X-FuHaFi:" ; http://www.gmx.net/
2629 "X-Generated-By:" ; launchpad.net
2631 "X-Gnus-Mail-Source:" ; gnus
2632 "X-Google-" ; Google mail
2633 "X-Google-Sender-Auth:"
2634 "X-Greylist:" ; milter-greylist-1.2.1
2635 "X-Habeas-" ; http://www.returnpath.net
2636 "X-Hashcash:" ; hashcash
2637 "X-Headers-End:" ; SpamCop
2642 "X-Identity:" ; http://www.declude.com/x-note.htm
2643 "X-IEEE-UCE-" ; IEEE spam filter
2645 "X-IMAP:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2647 "X-IronPort-" ; IronPort AV
2648 "X-ISI-4-30-3-MailScanner:"
2650 "X-Jira-Fingerprint:" ; JIRA
2651 "X-Junkmail-" ; RCN?
2654 "X-Launchpad-" ; plaunchpad.net
2655 "X-List-Host:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2656 "X-List-Subscribe:" ; Unknown mailing list managers
2657 "X-List-Unsubscribe:" ; Unknown mailing list managers
2658 "X-Listprocessor-" ; ListProc(tm) by CREN
2659 "X-Listserver:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2660 "X-Loop:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2661 "X-Lrde-Mailscanner:"
2662 "X-Lumos-SenderID:" ; Roving ConstantContact
2663 "X-mail_abuse_inquiries:" ; http://www.salesforce.com
2664 "X-Mail-from:" ; fastmail.fm
2665 "X-MAIL-INFO:" ; NetZero
2667 "X-MailFlowPolicy:" ; Cisco Email Security (formerly IronPort; http://www.ironport.com)
2668 "X-Mailing-List:" ; Unknown mailing list managers
2670 "X-Mailman-Approved-At:" ; Mailman mailing list manager
2671 "X-Mailman-Version:" ; Mailman mailing list manager
2672 "X-MailScanner" ; ListProc(tm) by CREN
2673 "X-Mailutils-Message-Id" ; GNU Mailutils
2674 "X-Majordomo:" ; Majordomo mailing list manager
2676 "X-MaxCode-Template:" ; Paypal http://www.paypal.com
2677 "X-MB-Message-" ; AOL WebMail
2678 "X-MDaemon-Deliver-To:"
2680 "X-ME-Bayesian:" ; http://www.newmediadevelopment.net/page.cfm/parent/Client-Area/content/Managing-spam/
2683 "X-MessageWall-Score:" ; Unknown mailing list manager, AUC TeX
2684 "X-MHE-Checksum:" ; Checksum added during index search
2685 "X-MIME-Autoconverted:" ; sendmail
2686 "X-MIMEOLE:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/sendmail
2688 "X-Mms-" ; T-Mobile pictures
2689 "X-Mozilla-Status:" ; Netscape/Mozilla
2690 "X-MS-" ; MS Outlook
2691 "X-Msmail-" ; MS Outlook
2692 "X-MSMail-Priority" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2694 "X-NAI-Spam-" ; Network Associates Inc. SpamKiller
2696 "X-Newsreader:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2697 "X-No-Archive:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2698 "X-Notes-Item:" ; Lotus Notes Domino structured header
2699 "X-Notification-" ; Google+
2700 "X-Notifications:" ; Google+
2701 "X-OperatingSystem:"
2702 "X-Oracle-Calendar:" ; Oracle calendar invitations
2704 "X-Orcl-Content-Type:"
2706 "X-Original-Arrival-Type:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2707 "X-Original-Complaints-To:"
2708 "X-Original-Date:" ; SourceForge mailing list manager
2711 "X-OriginalArrivalTime:" ; Hotmail
2712 "X-Originating-Email:" ; Hotmail
2713 "X-Originating-IP:" ; Hotmail
2719 "X-Policyd-Weight:" ; policyd-weight (Postfix)
2721 "X-Priority:" ; MS Outlook
2722 "X-Proofpoint-" ; Proofpoint mail filter
2725 "X-Qotd-" ; User added
2726 "X-RCPT-TO:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2729 "X-Report-Abuse-To:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2731 "X-Resolved-to:" ; fastmail.fm
2732 "X-Return-Path-Hint:" ; Roving ConstantContact
2733 "X-RIM-" ; Research In Motion (i.e. BlackBerry)
2735 "X-RocketYMMF:" ; Yahoo
2736 "X-Roving-" ; Roving ConstantContact
2737 "X-SA-Exim-" ; Exim SpamAssassin
2738 "X-Sasl-enc:" ; Apple Mail
2745 "X-Sender-ID:" ; Google+
2746 "X-Sender:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2747 "X-Sendergroup:" ; Cisco Email Security (formerly IronPort; http://www.ironport.com)
2751 "X-SFDC-" ; http://www.salesforce.com
2752 "X-Sieve:" ; Sieve filtering
2757 "X-Spam-" ; SpamAssassin
2758 "X-Spam:" ; Exchange
2759 "X-SpamBouncer:" ; Spam
2762 "X-Submission-Address:"
2766 "X-TM-IMSS-Message-ID:" ; http://www.trendmicro.com
2769 "X-UIDL:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2772 "X-URI:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2773 "X-URL:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2774 "X-USANET-" ; usa.net
2779 "X-VirtualServerGroup:"
2782 "X-VSMLoop:" ; NTMail
2783 "X-WebTV-Signature:"
2784 "X-Wss-Id:" ; Worldtalk gateways
2785 "X-X-Sender:" ; http://people.dsv.su.se/~jpalme/ietf/mail-headers/
2786 "X-XPT-XSL-Name:" ; Paypal http://www.paypal.com
2788 "X-XWALL-" ; http://www.dataenter.co.at/doc/xwall_undocumented_config.htm
2789 "X-Y-GMX-Trusted:" ; http://www.gmx.net/
2797 "List of default header fields that are not to be shown.
2799 Do not alter this variable directly. Instead, add entries from
2800 here that you would like to be displayed in
2801 `mh-invisible-header-fields-default' and add entries to hide in
2802 `mh-invisible-header-fields'.")
2805 (unless (fboundp 'mh-invisible-headers
)
2806 (defun mh-invisible-headers ()
2807 "Temporary definition.
2808 Real definition, below, uses variables that aren't defined yet."
2811 (defvar mh-delay-invisible-header-generation-flag t
2812 "Non-nil means to delay the generation of invisible header fields.
2813 Because the function `mh-invisible-headers' uses both
2814 `mh-invisible-header-fields' and `mh-invisible-header-fields', it
2815 cannot be run until both variables have been initialized.")
2817 (defcustom-mh mh-invisible-header-fields nil
2818 "*Additional header fields to hide.
2820 Header fields that you would like to hide that aren't listed in
2821 `mh-invisible-header-fields-default' can be added to this option
2822 with a couple of caveats. Regular expressions are not allowed.
2823 Unique fields should have a \":\" suffix; otherwise, the element
2824 can be used to render invisible an entire class of fields that
2825 start with the same prefix.
2827 If you think a header field should be generally ignored, please
2828 update SF #1916032 (see URL
2829 `https://sourceforge.net/tracker/index.php?func=detail&aid=1916032&group_id=13357&atid=113357').
2831 See also `mh-clean-message-header-flag'."
2833 :type
'(repeat (string :tag
"Header field"))
2834 :set
(lambda (symbol value
)
2835 (set-default symbol value
)
2836 (mh-invisible-headers))
2838 :package-version
'(MH-E .
"7.1"))
2840 (defcustom-mh mh-invisible-header-fields-default nil
2841 "*List of hidden header fields.
2843 The header fields listed in this option are hidden, although you
2844 can check off any field that you would like to see.
2846 Header fields that you would like to hide that aren't listed can
2847 be added to the option `mh-invisible-header-fields'.
2849 See also `mh-clean-message-header-flag'.
2851 If you think a header field should be added to this list, please
2852 update SF #1916032 (see URL
2853 `https://sourceforge.net/tracker/index.php?func=detail&aid=1916032&group_id=13357&atid=113357')."
2854 :type
`(set ,@(mapcar (lambda (x) `(const ,x
))
2855 mh-invisible-header-fields-internal
))
2856 :set
(lambda (symbol value
)
2857 (set-default symbol value
)
2858 (mh-invisible-headers))
2860 :package-version
'(MH-E .
"8.0"))
2862 (defvar mh-invisible-header-fields-compiled nil
2863 "*Regexp matching lines in a message header that are not to be shown.
2864 Do not alter this variable directly. Instead, customize
2865 `mh-invisible-header-fields-default' checking for fields normally
2866 hidden that you wish to display, and add extra entries to hide in
2867 `mh-invisible-header-fields'.")
2869 (defun mh-invisible-headers ()
2870 "Make or remake the variable `mh-invisible-header-fields-compiled'.
2871 Done using `mh-invisible-header-fields-internal' as input, from
2872 which entries from `mh-invisible-header-fields-default' are
2873 removed and entries from `mh-invisible-header-fields' are added."
2874 (let ((fields mh-invisible-header-fields-internal
))
2875 (when mh-invisible-header-fields-default
2876 ;; Remove entries from `mh-invisible-header-fields-default'
2878 (loop for x in fields
2879 unless
(member x mh-invisible-header-fields-default
)
2881 (when (and (boundp 'mh-invisible-header-fields
)
2882 mh-invisible-header-fields
)
2883 (dolist (x mh-invisible-header-fields
)
2884 (unless (member x fields
) (setq fields
(cons x fields
)))))
2886 (setq mh-invisible-header-fields-compiled
2889 ;; workaround for insufficient default
2890 (let ((max-specpdl-size 1000))
2891 (regexp-opt fields t
))))
2892 (setq mh-invisible-header-fields-compiled nil
))))
2894 ;; Compile invisible header fields.
2895 (mh-invisible-headers)
2897 (defcustom-mh mh-lpr-command-format
"lpr -J '%s'"
2898 "*Command used to print\\<mh-folder-mode-map>.
2900 This option contains the Unix command line which performs the
2901 actual printing for the \\[mh-print-msg] command. The string can
2902 contain one escape, \"%s\", which is replaced by the name of the
2903 folder and the message number and is useful for print job names.
2904 I use \"mpage -h'%s' -b Letter -H1of -mlrtb -P\" which produces a
2905 nice header and adds a bit of margin so the text fits within my
2908 This options is not used by the commands \\[mh-ps-print-msg] or
2909 \\[mh-ps-print-msg-file]."
2912 :package-version
'(MH-E .
"6.0"))
2914 (defcustom-mh mh-max-inline-image-height nil
2915 "*Maximum inline image height if \"Content-Disposition:\" is not present.
2917 Some older mail programs do not insert this needed plumbing to
2918 tell MH-E whether to display the attachments inline or not. If
2919 this is the case, MH-E will display these images inline if they
2920 are smaller than the window. However, you might want to allow
2921 larger images to be displayed inline. To do this, you can change
2922 the options `mh-max-inline-image-width' and
2923 `mh-max-inline-image-height' from their default value of zero to
2924 a large number. The size of your screen is a good choice for
2926 :type
'(choice (const nil
) integer
)
2928 :package-version
'(MH-E .
"7.0"))
2930 (defcustom-mh mh-max-inline-image-width nil
2931 "*Maximum inline image width if \"Content-Disposition:\" is not present.
2933 Some older mail programs do not insert this needed plumbing to
2934 tell MH-E whether to display the attachments inline or not. If
2935 this is the case, MH-E will display these images inline if they
2936 are smaller than the window. However, you might want to allow
2937 larger images to be displayed inline. To do this, you can change
2938 the options `mh-max-inline-image-width' and
2939 `mh-max-inline-image-height' from their default value of zero to
2940 a large number. The size of your screen is a good choice for
2942 :type
'(choice (const nil
) integer
)
2944 :package-version
'(MH-E .
"7.0"))
2946 (defcustom-mh mh-mhl-format-file nil
2947 "*Specifies the format file to pass to the \"mhl\" program.
2949 Normally MH-E takes care of displaying messages itself (rather than
2950 calling an MH program to do the work). If you'd rather have \"mhl\"
2951 display the message (within MH-E), change this option from its default
2952 value of \"Use Default mhl Format (Printing Only)\".
2954 You can set this option to \"Use Default mhl Format\" to get the same
2955 output as you would get if you ran \"mhl\" from the shell.
2957 If you have a format file that you want MH-E to use, you can set this
2958 option to \"Specify an mhl Format File\" and enter the name of your
2959 format file. Your format file should specify a non-zero value for
2960 \"overflowoffset\" to allow MH-E to parse the header. Note that
2961 \"mhl\" is always used for printing and forwarding; in this case, the
2962 value of this option is consulted if you have specified a format
2964 :type
'(choice (const :tag
"Use Default mhl Format (Printing Only)" nil
)
2965 (const :tag
"Use Default mhl Format" t
)
2966 (file :tag
"Specify an mhl Format File"))
2968 :package-version
'(MH-E .
"8.0"))
2970 (defcustom-mh mh-mime-save-parts-default-directory t
2971 "Default directory to use for \\<mh-folder-mode-map>\\[mh-mime-save-parts].
2973 The default value for this option is \"Prompt Always\" so that
2974 you are always prompted for the directory in which to save the
2975 attachments. However, if you usually use the same directory
2976 within a session, then you can set this option to \"Prompt the
2977 First Time\" to avoid the prompt each time. you can make this
2978 directory permanent by choosing \"Directory\" and entering the
2980 :type
'(choice (const :tag
"Prompt the First Time" nil
)
2981 (const :tag
"Prompt Always" t
)
2984 :package-version
'(MH-E .
"7.0"))
2986 (defcustom-mh mh-print-background-flag nil
2987 "*Non-nil means messages should be printed in the background\\<mh-folder-mode-map>.
2989 Normally messages are printed in the foreground. If this is slow on
2990 your system, you may elect to turn off this option to print in the
2993 WARNING: If you do this, do not delete the message until it is printed
2994 or else the output may be truncated.
2996 This option is not used by the commands \\[mh-ps-print-msg] or
2997 \\[mh-ps-print-msg-file]."
3000 :package-version
'(MH-E .
"7.0"))
3002 (defcustom-mh mh-show-maximum-size
0
3003 "*Maximum size of message (in bytes) to display automatically.
3005 This option provides an opportunity to skip over large messages
3006 which may be slow to load. The default value of 0 means that all
3007 message are shown regardless of size."
3010 :package-version
'(MH-E .
"8.0"))
3012 (defcustom-mh mh-show-use-xface-flag
(>= emacs-major-version
21)
3013 "*Non-nil means display face images in MH-show buffers.
3015 MH-E can display the content of \"Face:\", \"X-Face:\", and
3016 \"X-Image-URL:\" header fields. If any of these fields occur in the
3017 header of your message, the sender's face will appear in the \"From:\"
3018 header field. If more than one of these fields appear, then the first
3019 field found in the order \"Face:\", \"X-Face:\", and \"X-Image-URL:\"
3022 The option `mh-show-use-xface-flag' is used to turn this feature on
3023 and off. This feature will be turned on by default if your system
3026 The first header field used, if present, is the Gnus-specific
3027 \"Face:\" field. The \"Face:\" field appeared in GNU Emacs 21 and
3028 XEmacs. For more information, see URL
3029 `http://quimby.gnus.org/circus/face/'. Next is the traditional
3030 \"X-Face:\" header field. The display of this field requires the
3031 \"uncompface\" program (see URL
3032 `ftp://ftp.cs.indiana.edu/pub/faces/compface/compface.tar.z'). Recent
3033 versions of XEmacs have internal support for \"X-Face:\" images. If
3034 your version of XEmacs does not, then you'll need both \"uncompface\"
3035 and the x-face package (see URL `ftp://ftp.jpl.org/pub/elisp/').
3037 Finally, MH-E will display images referenced by the \"X-Image-URL:\"
3038 header field if neither the \"Face:\" nor the \"X-Face:\" fields are
3039 present. The display of the images requires \"wget\" (see URL
3040 `http://www.gnu.org/software/wget/wget.html'), \"fetch\", or \"curl\"
3041 to fetch the image and the \"convert\" program from the ImageMagick
3042 suite (see URL `http://www.imagemagick.org/'). Of the three header
3043 fields this is the most efficient in terms of network usage since the
3044 image doesn't need to be transmitted with every single mail.
3046 The option `mh-fetch-x-image-url' controls the fetching of the
3047 \"X-Image-URL:\" header field image."
3050 :package-version
'(MH-E .
"7.0"))
3052 (defcustom-mh mh-store-default-directory nil
3053 "*Default directory for \\<mh-folder-mode-map>\\[mh-store-msg].
3055 If you would like to change the initial default directory,
3056 customize this option, change the value from \"Current\" to
3057 \"Directory\", and then enter the name of the directory for storing
3058 the content of these messages."
3059 :type
'(choice (const :tag
"Current" nil
)
3062 :package-version
'(MH-E .
"6.0"))
3064 (defcustom-mh mh-summary-height nil
3065 "*Number of lines in MH-Folder buffer (including the mode line).
3067 The default value of this option is \"Automatic\" which means
3068 that the MH-Folder buffer will maintain the same proportional
3069 size if the frame is resized. If you'd prefer a fixed height,
3070 then choose the \"Fixed Size\" option and enter the number of
3071 lines you'd like to see."
3072 :type
'(choice (const :tag
"Automatic" nil
)
3073 (integer :tag
"Fixed Size"))
3075 :package-version
'(MH-E .
"7.4"))
3077 ;;; The Speedbar (:group 'mh-speedbar)
3079 (defcustom-mh mh-speed-update-interval
60
3080 "Time between speedbar updates in seconds.
3081 Set to 0 to disable automatic update."
3084 :package-version
'(MH-E .
"8.0"))
3086 ;;; Threading (:group 'mh-thread)
3088 (defcustom-mh mh-show-threads-flag nil
3089 "*Non-nil means new folders start in threaded mode.
3091 Threading large number of messages can be time consuming so this
3092 option is turned off by default. If you turn this option on, then
3093 threading will be done only if the number of messages being
3094 threaded is less than `mh-large-folder'."
3097 :package-version
'(MH-E .
"7.1"))
3099 ;;; The Tool Bar (:group 'mh-tool-bar)
3101 ;; mh-tool-bar-folder-buttons and mh-tool-bar-letter-buttons defined
3102 ;; dynamically in mh-tool-bar.el.
3104 (defcustom-mh mh-tool-bar-search-function
'mh-search
3105 "*Function called by the tool bar search button.
3107 By default, this is set to `mh-search'. You can also choose
3108 \"Other Function\" from the \"Value Menu\" and enter a function
3109 of your own choosing."
3110 :type
'(choice (const mh-search
)
3111 (function :tag
"Other Function"))
3113 :package-version
'(MH-E .
"7.0"))
3115 ;; XEmacs has a couple of extra customizations...
3117 (defcustom-mh mh-xemacs-use-tool-bar-flag mh-xemacs-has-tool-bar-flag
3118 "*If non-nil, use tool bar.
3120 This option controls whether to show the MH-E icons at all. By
3121 default, this option is turned on if the window system supports
3122 tool bars. If your system doesn't support tool bars, then you
3123 won't be able to turn on this option."
3126 :set
(lambda (symbol value
)
3127 (if (and (eq value t
)
3128 (not mh-xemacs-has-tool-bar-flag
))
3129 (error "Tool bar not supported"))
3130 (set-default symbol value
))
3131 :package-version
'(MH-E .
"7.3"))
3133 (defcustom-mh mh-xemacs-tool-bar-position nil
3134 "*Tool bar location.
3136 This option controls the placement of the tool bar along the four
3137 edges of the frame. You can choose from one of \"Same As Default
3138 Tool Bar\", \"Top\", \"Bottom\", \"Left\", or \"Right\". If this
3139 variable is set to anything other than \"Same As Default Tool
3140 Bar\" and the default tool bar is in a different location, then
3141 two tool bars will be displayed: the MH-E tool bar and the
3143 :type
'(radio (const :tag
"Same As Default Tool Bar" :value nil
)
3144 (const :tag
"Top" :value top
)
3145 (const :tag
"Bottom" :value bottom
)
3146 (const :tag
"Left" :value left
)
3147 (const :tag
"Right" :value right
))
3149 :package-version
'(MH-E .
"7.3")))
3153 ;;; Hooks (:group 'mh-hooks + group where hook described)
3155 (defcustom-mh mh-after-commands-processed-hook nil
3156 "Hook run by \\<mh-folder-mode-map>\\[mh-execute-commands] after performing outstanding refile and delete requests.
3158 Variables that are useful in this hook include
3159 `mh-folders-changed', which lists which folders were affected by
3160 deletes and refiles. This list will always include the current
3161 folder, which is also available in `mh-current-folder'."
3165 :package-version
'(MH-E .
"8.0"))
3167 (defcustom-mh mh-alias-reloaded-hook nil
3168 "Hook run by `mh-alias-reload' after loading aliases."
3172 :package-version
'(MH-E .
"8.0"))
3174 (defcustom-mh mh-annotate-msg-hook nil
3175 "Hook run whenever a message is sent and after the scan lines and message are annotated.
3176 Hook functions can access the current folder name with
3177 `mh-current-folder' and obtain the message numbers of the
3178 annotated messages with `mh-annotate-list'."
3181 :group
'mh-sending-mail
3182 :package-version
'(MH-E .
"8.1"))
3184 (defcustom-mh mh-before-commands-processed-hook nil
3185 "Hook run by \\<mh-folder-mode-map>\\[mh-execute-commands] before performing outstanding refile and delete requests.
3187 Variables that are useful in this hook include `mh-delete-list',
3188 `mh-refile-list', `mh-blacklist', and `mh-whitelist' which can be
3189 used to see which changes will be made to the current folder,
3190 `mh-current-folder'."
3194 :package-version
'(MH-E .
"8.0"))
3196 (defcustom-mh mh-before-quit-hook nil
3197 "Hook run by \\<mh-folder-mode-map>\\[mh-quit] before quitting MH-E.
3199 This hook is called before the quit occurs, so you might use it
3200 to perform any MH-E operations; you could perform some query and
3201 abort the quit or call `mh-execute-commands', for example.
3203 See also `mh-quit-hook'."
3207 :package-version
'(MH-E .
"6.0"))
3209 (defcustom-mh mh-before-send-letter-hook nil
3210 "Hook run at the beginning of the \\<mh-letter-mode-map>\\[mh-send-letter] command.
3212 For example, if you want to check your spelling in your message
3213 before sending, add the `ispell-message' function."
3215 :options
'(ispell-message)
3218 :package-version
'(MH-E .
"6.0"))
3220 (defcustom-mh mh-blacklist-msg-hook nil
3221 "Hook run by \\<mh-letter-mode-map>\\[mh-junk-blacklist] after marking each message for blacklisting."
3225 :package-version
'(MH-E .
"8.4"))
3227 (defcustom-mh mh-delete-msg-hook nil
3228 "Hook run by \\<mh-letter-mode-map>\\[mh-delete-msg] after marking each message for deletion.
3230 For example, a past maintainer of MH-E used this once when he
3231 kept statistics on his mail usage."
3235 :package-version
'(MH-E .
"6.0"))
3237 (defcustom-mh mh-find-path-hook nil
3238 "Hook run by `mh-find-path' after reading the user's MH profile.
3240 This hook can be used the change the value of the variables that
3241 `mh-find-path' sets if you need to run with different values
3242 between MH and MH-E."
3246 :package-version
'(MH-E .
"7.0"))
3248 (defcustom-mh mh-folder-mode-hook nil
3249 "Hook run by `mh-folder-mode' when visiting a new folder."
3253 :package-version
'(MH-E .
"6.0"))
3255 (defcustom-mh mh-forward-hook nil
3256 "Hook run by `mh-forward' on a forwarded letter."
3259 :group
'mh-sending-mail
3260 :package-version
'(MH-E .
"8.0"))
3262 (defcustom-mh mh-inc-folder-hook nil
3263 "Hook run by \\<mh-folder-mode-map>\\[mh-inc-folder] after incorporating mail into a folder."
3267 :package-version
'(MH-E .
"6.0"))
3269 (defcustom-mh mh-insert-signature-hook nil
3270 "Hook run by \\<mh-letter-mode-map>\\[mh-insert-signature] after signature has been inserted.
3272 Hook functions may access the actual name of the file or the
3273 function used to insert the signature with
3274 `mh-signature-file-name'."
3278 :package-version
'(MH-E .
"8.0"))
3280 (mh-define-obsolete-variable-alias 'mh-kill-folder-suppress-prompt-hooks
3281 'mh-kill-folder-suppress-prompt-functions
"24.3")
3282 (defcustom-mh mh-kill-folder-suppress-prompt-functions
'(mh-search-p)
3283 "Abnormal hook run at the beginning of \\<mh-folder-mode-map>\\[mh-kill-folder].
3285 The hook functions are called with no arguments and should return
3286 a non-nil value to suppress the normal prompt when you remove a
3287 folder. This is useful for folders that are easily regenerated.
3289 The default value of `mh-search-p' suppresses the prompt on
3290 folders generated by searching.
3292 WARNING: Use this hook with care. If there is a bug in your hook
3293 which returns t on \"+inbox\" and you hit \\[mh-kill-folder] by
3294 accident in the \"+inbox\" folder, you will not be happy."
3298 :package-version
'(MH-E .
"7.4"))
3300 (defcustom-mh mh-letter-mode-hook nil
3301 "Hook run by `mh-letter-mode' on a new letter.
3303 This hook allows you to do some processing before editing a
3304 letter. For example, you may wish to modify the header after
3305 \"repl\" has done its work, or you may have a complicated
3306 \"components\" file and need to tell MH-E where the cursor should
3310 :group
'mh-sending-mail
3311 :package-version
'(MH-E .
"6.0"))
3313 (defcustom-mh mh-mh-to-mime-hook nil
3314 "Hook run on the formatted letter by \\<mh-letter-mode-map>\\[mh-mh-to-mime]."
3318 :package-version
'(MH-E .
"8.0"))
3320 (defcustom-mh mh-search-mode-hook nil
3321 "Hook run upon entry to `mh-search-mode'\\<mh-folder-mode-map>.
3323 If you find that you do the same thing over and over when editing
3324 the search template, you may wish to bind some shortcuts to keys.
3325 This can be done with this hook which is called when
3326 \\[mh-search] is run on a new pattern."
3330 :package-version
'(MH-E .
"8.0"))
3332 (defcustom-mh mh-pack-folder-hook nil
3333 "Hook run by \\<mh-folder-mode-map>\\[mh-pack-folder] after renumbering the messages.
3334 Hook functions can access the current folder name with `mh-current-folder'."
3338 :package-version
'(MH-E .
"8.2"))
3340 (defcustom-mh mh-quit-hook nil
3341 "Hook run by \\<mh-folder-mode-map>\\[mh-quit] after quitting MH-E.
3343 This hook is not run in an MH-E context, so you might use it to
3344 modify the window setup.
3346 See also `mh-before-quit-hook'."
3350 :package-version
'(MH-E .
"6.0"))
3352 (defcustom-mh mh-refile-msg-hook nil
3353 "Hook run by \\<mh-folder-mode-map>\\[mh-refile-msg] after marking each message for refiling."
3357 :package-version
'(MH-E .
"6.0"))
3359 (defcustom-mh mh-show-hook nil
3360 "Hook run after \\<mh-folder-mode-map>\\[mh-show] shows a message.
3362 It is the last thing called after messages are displayed. It's
3363 used to affect the behavior of MH-E in general or when
3364 `mh-show-mode-hook' is too early. See `mh-show-mode-hook'."
3368 :package-version
'(MH-E .
"6.0"))
3370 (defcustom-mh mh-show-mode-hook nil
3371 "Hook run upon entry to `mh-show-mode'.
3373 This hook is called early on in the process of the message
3374 display. It is usually used to perform some action on the
3375 message's content. See `mh-show-hook'."
3379 :package-version
'(MH-E .
"6.0"))
3381 (defcustom-mh mh-unseen-updated-hook nil
3382 "Hook run after the unseen sequence has been updated.
3384 The variable `mh-seen-list' can be used by this hook to obtain
3385 the list of messages which were removed from the unseen
3389 :group
'mh-sequences
3390 :package-version
'(MH-E .
"6.0"))
3392 (defcustom-mh mh-whitelist-msg-hook nil
3393 "Hook run by \\<mh-letter-mode-map>\\[mh-junk-whitelist] after marking each message for whitelisting."
3397 :package-version
'(MH-E .
"8.4"))
3401 ;;; Faces (:group 'mh-faces + group where faces described)
3403 (if (boundp 'facemenu-unlisted-faces
)
3404 (add-to-list 'facemenu-unlisted-faces
"^mh-"))
3406 ;; To add a new face:
3407 ;; 1. Add entry to variable mh-face-data.
3408 ;; 2. Create face using defface-mh (which removes min-color spec and
3409 ;; :package-version keyword where these are not supported),
3410 ;; accessing face data with function mh-face-data.
3411 ;; 3. Add inherit argument to function mh-face-data if applicable.
3412 (defvar mh-face-data
3413 '((mh-folder-followup
3414 ((((class color
) (background light
))
3415 (:foreground
"blue3"))
3416 (((class color
) (background dark
))
3417 (:foreground
"LightGoldenRod"))
3420 (mh-folder-msg-number
3421 ((((class color
) (min-colors 64) (background light
))
3422 (:foreground
"snow4"))
3423 (((class color
) (min-colors 64) (background dark
))
3424 (:foreground
"snow3"))
3425 (((class color
) (background light
))
3426 (:foreground
"purple"))
3427 (((class color
) (background dark
))
3428 (:foreground
"cyan"))))
3430 ((((class color
) (min-colors 64) (background light
))
3431 (:foreground
"DarkGoldenrod"))
3432 (((class color
) (min-colors 64) (background dark
))
3433 (:foreground
"LightGoldenrod"))
3435 (:foreground
"yellow" :weight light
))
3436 (((class grayscale
) (background light
))
3437 (:foreground
"Gray90" :bold t
:italic t
))
3438 (((class grayscale
) (background dark
))
3439 (:foreground
"DimGray" :bold t
:italic t
))
3441 (:bold t
:italic t
))))
3443 ((((class color
) (background light
))
3444 (:foreground
"blue4"))
3445 (((class color
) (background dark
))
3446 (:foreground
"yellow"))
3450 ((((class color
) (background light
))
3451 (:background
"#dddf7e"))
3452 (((class color
) (background dark
))
3453 (:background
"#dddf7e"))
3457 ((((class color
) (min-colors 64) (background light
))
3458 (:foreground
"RosyBrown"))
3459 (((class color
) (min-colors 64) (background dark
))
3460 (:foreground
"LightSalmon"))
3462 (:foreground
"green"))
3463 (((class grayscale
) (background light
))
3464 (:foreground
"DimGray" :italic t
))
3465 (((class grayscale
) (background dark
))
3466 (:foreground
"LightGray" :italic t
))
3469 (mh-letter-header-field
3470 ((((class color
) (background light
))
3471 (:background
"gray90"))
3472 (((class color
) (background dark
))
3473 (:background
"gray10"))
3477 ((((class color
) (background light
))
3478 (:foreground
"dark green" :bold t
))
3479 (((class color
) (background dark
))
3480 (:foreground
"indian red" :bold t
))
3484 ((((class color
) (min-colors 64) (background light
))
3485 (:foreground
"DarkGoldenrod"))
3486 (((class color
) (min-colors 64) (background dark
))
3487 (:foreground
"LightGoldenrod"))
3489 (:foreground
"yellow" :weight light
))
3490 (((class grayscale
) (background light
))
3491 (:foreground
"Gray90" :bold t
:italic t
))
3492 (((class grayscale
) (background dark
))
3493 (:foreground
"DimGray" :bold t
:italic t
))
3495 (:bold t
:italic t
))))
3497 ((((class color
) (min-colors 64) (background light
))
3498 (:foreground
"ForestGreen"))
3499 (((class color
) (min-colors 64) (background dark
))
3500 (:foreground
"PaleGreen"))
3502 (:foreground
"green"))
3503 (((class grayscale
) (background light
))
3504 (:foreground
"Gray90" :bold t
))
3505 (((class grayscale
) (background dark
))
3506 (:foreground
"DimGray" :bold t
))
3508 (:bold t
:underline t
))))
3510 ((((class color
) (background light
))
3511 (:foreground
"red3"))
3512 (((class color
) (background dark
))
3513 (:foreground
"cyan"))
3517 ((((class color
) (min-colors 64) (background light
))
3518 (:foreground
"RosyBrown"))
3519 (((class color
) (min-colors 64) (background dark
))
3520 (:foreground
"LightSalmon"))
3522 (:foreground
"green"))
3523 (((class grayscale
) (background light
))
3524 (:foreground
"DimGray" :italic t
))
3525 (((class grayscale
) (background dark
))
3526 (:foreground
"LightGray" :italic t
))
3529 (mh-show-pgg-bad ((t (:bold t
:foreground
"DeepPink1"))))
3530 (mh-show-pgg-good ((t (:bold t
:foreground
"LimeGreen"))))
3531 (mh-show-pgg-unknown ((t (:bold t
:foreground
"DarkGoldenrod2"))))
3532 (mh-show-signature ((t (:italic t
))))
3534 ((((class color
) (background light
))
3535 (:foreground
"SaddleBrown"))
3536 (((class color
) (background dark
))
3537 (:foreground
"burlywood"))
3538 (((class grayscale
) (background light
))
3539 (:foreground
"DimGray" :underline t
))
3540 (((class grayscale
) (background dark
))
3541 (:foreground
"LightGray" :underline t
))
3542 (t (:underline t
))))
3544 ((((class color
) (background light
))
3545 (:foreground
"blue4"))
3546 (((class color
) (background dark
))
3547 (:foreground
"light blue"))))
3548 (mh-speedbar-selected-folder
3549 ((((class color
) (background light
))
3550 (:foreground
"red1" :underline t
))
3551 (((class color
) (background dark
))
3552 (:foreground
"red1" :underline t
))
3556 Used by function `mh-face-data' which returns spec that is
3557 consumed by `defface-mh'.")
3561 (defvar mh-inherit-face-flag
(assq :inherit custom-face-attributes
)
3562 "Non-nil means that the `defface' :inherit keyword is available.
3563 The :inherit keyword is available on all supported versions of
3564 GNU Emacs and XEmacs from at least 21.5.23 on.")
3566 (defvar mh-min-colors-defined-flag
(and (not (featurep 'xemacs
))
3567 (>= emacs-major-version
22))
3568 "Non-nil means `defface' supports min-colors display requirement.")
3570 (defun mh-face-data (face &optional inherit
)
3571 "Return spec for FACE.
3572 See `defface' for the spec definition.
3574 If INHERIT is non-nil and `defface' supports the :inherit
3575 keyword, return INHERIT literally; otherwise, return spec for
3576 FACE from the variable `mh-face-data'. This isn't a perfect
3577 implementation. In the case that the :inherit keyword is not
3578 supported, any additional attributes in the inherit parameter are
3579 not added to the returned spec.
3581 Furthermore, when `mh-min-colors-defined-flag' is nil, this
3582 function finds display entries with \"min-colors\" requirements
3583 and either removes the \"min-colors\" requirement or strips the
3584 display entirely if the display does not support the number of
3587 (if (and inherit mh-inherit-face-flag
)
3589 (or (cadr (assq face mh-face-data
))
3590 (error "Could not find %s in mh-face-data" face
)))))
3592 (if mh-min-colors-defined-flag
3594 (let ((cells (mh-display-color-cells))
3596 ;; Remove entries with min-colors, or delete them if we have
3597 ;; fewer colors than they specify.
3598 (loop for entry in
(reverse spec
) do
3599 (let ((requirement (if (eq (car entry
) t
)
3601 (assq 'min-colors
(car entry
)))))
3603 (when (>= cells
(nth 1 requirement
))
3604 (setq new-spec
(cons (cons (delq requirement
(car entry
))
3607 (setq new-spec
(cons entry new-spec
)))))
3610 (defface-mh mh-folder-address
3611 (mh-face-data 'mh-folder-subject
'((t (:inherit mh-folder-subject
))))
3615 :package-version
'(MH-E .
"8.0"))
3617 (defface-mh mh-folder-blacklisted
3618 (mh-face-data 'mh-folder-msg-number
'((t (:inherit mh-folder-msg-number
))))
3619 "Blacklisted message face."
3622 :package-version
'(MH-E .
"8.4"))
3624 (defface-mh mh-folder-body
3625 (mh-face-data 'mh-folder-msg-number
3627 (:inherit mh-folder-msg-number
))
3629 (:inherit mh-folder-msg-number
:italic t
))))
3633 :package-version
'(MH-E .
"8.0"))
3635 (defface-mh mh-folder-cur-msg-number
3636 (mh-face-data 'mh-folder-msg-number
3637 '((t (:inherit mh-folder-msg-number
:bold t
))))
3638 "Current message number face."
3641 :package-version
'(MH-E .
"8.0"))
3643 (defface-mh mh-folder-date
3644 (mh-face-data 'mh-folder-msg-number
'((t (:inherit mh-folder-msg-number
))))
3648 :package-version
'(MH-E .
"8.0"))
3650 (defface-mh mh-folder-deleted
3651 (mh-face-data 'mh-folder-msg-number
'((t (:inherit mh-folder-msg-number
))))
3652 "Deleted message face."
3655 :package-version
'(MH-E .
"8.0"))
3657 (defface-mh mh-folder-followup
(mh-face-data 'mh-folder-followup
)
3661 :package-version
'(MH-E .
"8.0"))
3663 (defface-mh mh-folder-msg-number
(mh-face-data 'mh-folder-msg-number
)
3664 "Message number face."
3667 :package-version
'(MH-E .
"8.0"))
3669 (defface-mh mh-folder-refiled
(mh-face-data 'mh-folder-refiled
)
3670 "Refiled message face."
3673 :package-version
'(MH-E .
"8.0"))
3675 (defface-mh mh-folder-sent-to-me-hint
3676 (mh-face-data 'mh-folder-msg-number
'((t (:inherit mh-folder-date
))))
3677 "Fontification hint face in messages sent directly to us.
3678 The detection of messages sent to us is governed by the scan
3679 format `mh-scan-format-nmh' and the regular expression
3680 `mh-scan-sent-to-me-sender-regexp'."
3683 :package-version
'(MH-E .
"8.0"))
3685 (defface-mh mh-folder-sent-to-me-sender
3686 (mh-face-data 'mh-folder-followup
'((t (:inherit mh-folder-followup
))))
3687 "Sender face in messages sent directly to us.
3688 The detection of messages sent to us is governed by the scan
3689 format `mh-scan-format-nmh' and the regular expression
3690 `mh-scan-sent-to-me-sender-regexp'."
3693 :package-version
'(MH-E .
"8.0"))
3695 (defface-mh mh-folder-subject
(mh-face-data 'mh-folder-subject
)
3699 :package-version
'(MH-E .
"8.0"))
3701 (defface-mh mh-folder-tick
(mh-face-data 'mh-folder-tick
)
3702 "Ticked message face."
3705 :package-version
'(MH-E .
"8.0"))
3707 (defface-mh mh-folder-to
(mh-face-data 'mh-folder-to
)
3711 :package-version
'(MH-E .
"8.0"))
3713 (defface-mh mh-folder-whitelisted
3714 (mh-face-data 'mh-folder-refiled
'((t (:inherit mh-folder-refiled
))))
3715 "Whitelisted message face."
3718 :package-version
'(MH-E .
"8.4"))
3720 (defface-mh mh-letter-header-field
(mh-face-data 'mh-letter-header-field
)
3721 "Editable header field value face in draft buffers."
3724 :package-version
'(MH-E .
"8.0"))
3726 (defface-mh mh-search-folder
(mh-face-data 'mh-search-folder
)
3727 "Folder heading face in MH-Folder buffers created by searches."
3730 :package-version
'(MH-E .
"8.0"))
3732 (defface-mh mh-show-cc
(mh-face-data 'mh-show-cc
)
3733 "Face used to highlight \"cc:\" header fields."
3736 :package-version
'(MH-E .
"8.0"))
3738 (defface-mh mh-show-date
(mh-face-data 'mh-show-date
)
3739 "Face used to highlight \"Date:\" header fields."
3742 :package-version
'(MH-E .
"8.0"))
3744 (defface-mh mh-show-from
(mh-face-data 'mh-show-from
)
3745 "Face used to highlight \"From:\" header fields."
3748 :package-version
'(MH-E .
"8.0"))
3750 (defface-mh mh-show-header
(mh-face-data 'mh-show-header
)
3751 "Face used to deemphasize less interesting header fields."
3754 :package-version
'(MH-E .
"8.0"))
3756 (defface-mh mh-show-pgg-bad
(mh-face-data 'mh-show-pgg-bad
)
3757 "Bad PGG signature face."
3760 :package-version
'(MH-E .
"8.0"))
3762 (defface-mh mh-show-pgg-good
(mh-face-data 'mh-show-pgg-good
)
3763 "Good PGG signature face."
3766 :package-version
'(MH-E .
"8.0"))
3768 (defface-mh mh-show-pgg-unknown
(mh-face-data 'mh-show-pgg-unknown
)
3769 "Unknown or untrusted PGG signature face."
3772 :package-version
'(MH-E .
"8.0"))
3774 (defface-mh mh-show-signature
(mh-face-data 'mh-show-signature
)
3778 :package-version
'(MH-E .
"8.0"))
3780 (defface-mh mh-show-subject
3781 (mh-face-data 'mh-folder-subject
'((t (:inherit mh-folder-subject
))))
3782 "Face used to highlight \"Subject:\" header fields."
3785 :package-version
'(MH-E .
"8.0"))
3787 (defface-mh mh-show-to
(mh-face-data 'mh-show-to
)
3788 "Face used to highlight \"To:\" header fields."
3791 :package-version
'(MH-E .
"8.0"))
3793 (defface-mh mh-show-xface
3794 (mh-face-data 'mh-show-from
'((t (:inherit
(mh-show-from highlight
)))))
3796 The background and foreground are used in the image."
3799 :package-version
'(MH-E .
"8.0"))
3801 (defface-mh mh-speedbar-folder
(mh-face-data 'mh-speedbar-folder
)
3802 "Basic folder face."
3805 :package-version
'(MH-E .
"8.0"))
3807 (defface-mh mh-speedbar-folder-with-unseen-messages
3808 (mh-face-data 'mh-speedbar-folder
3809 '((t (:inherit mh-speedbar-folder
:bold t
))))
3810 "Folder face when folder contains unread messages."
3813 :package-version
'(MH-E .
"8.0"))
3815 (defface-mh mh-speedbar-selected-folder
3816 (mh-face-data 'mh-speedbar-selected-folder
)
3817 "Selected folder face."
3820 :package-version
'(MH-E .
"8.0"))
3822 (defface-mh mh-speedbar-selected-folder-with-unseen-messages
3823 (mh-face-data 'mh-speedbar-selected-folder
3824 '((t (:inherit mh-speedbar-selected-folder
:bold t
))))
3825 "Selected folder face when folder contains unread messages."
3828 :package-version
'(MH-E .
"8.0"))
3833 ;; indent-tabs-mode: nil
3834 ;; sentence-end-double-space: nil
3837 ;;; mh-e.el ends here