Mercurial > hg > xemacs-beta
diff lisp/mh-e/mh-comp.el @ 0:376386a54a3c r19-14
Import from CVS: tag r19-14
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:45:50 +0200 |
parents | |
children | 131b0175ea99 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/lisp/mh-e/mh-comp.el Mon Aug 13 08:45:50 2007 +0200 @@ -0,0 +1,1051 @@ +;;; mh-comp --- mh-e functions for composing messages +;; Time-stamp: <95/08/19 17:48:59 gildea> + +;; Copyright (C) 1993, 1995 Free Software Foundation, Inc. + +;; This file is part of mh-e, part of GNU Emacs. + +;; GNU Emacs is free software; you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation; either version 2, or (at your option) +;; any later version. + +;; GNU Emacs is distributed in the hope that it will be useful, +;; but WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;; GNU General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with GNU Emacs; see the file COPYING. If not, write to +;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. + +;;; Commentary: + +;; Internal support for mh-e package. + +;;; Change Log: + +;; $Id: mh-comp.el,v 1.1.1.1 1996/12/18 03:34:36 steve Exp $ + +;;; Code: + +(provide 'mh-comp) +(require 'mh-utils) + +;;; Site customization (see also mh-utils.el): + +(defvar mh-send-prog "send" + "Name of the MH send program. +Some sites need to change this because of a name conflict.") + +(defvar mh-redist-full-contents nil + "Non-nil if the `dist' command needs whole letter for redistribution. +This is the case only when `send' is compiled with the BERK option. +If MH will not allow you to redist a previously redist'd msg, set to nil.") + + +(defvar mh-note-repl "-" + "String whose first character is used to notate replied to messages.") + +(defvar mh-note-forw "F" + "String whose first character is used to notate forwarded messages.") + +(defvar mh-note-dist "R" + "String whose first character is used to notate redistributed messages.") + +(defvar mh-yank-hooks nil + "Obsolete hook for modifying a citation just inserted in the mail buffer. +Each hook function can find the citation between point and mark. +And each hook function should leave point and mark around the citation +text as modified. + +This is a normal hook, misnamed for historical reasons. +It is semi-obsolete and is only used if mail-citation-hook is nil.") + +(defvar mail-citation-hook nil + "*Hook for modifying a citation just inserted in the mail buffer. +Each hook function can find the citation between point and mark. +And each hook function should leave point and mark around the citation +text as modified. + +If this hook is entirely empty (nil), the text of the message is inserted +with mh-ins-buf-prefix prefixed to each line. + +See also the variable mh-yank-from-start-of-msg, which controls how +much of the message passed to the hook.") + +;;; Copied from sendmail.el for Hyperbole +(defvar mail-header-separator "--------" + "*Line used by MH to separate headers from text in messages being composed.") + +;;; Personal preferences: + +(defvar mh-delete-yanked-msg-window nil + "*Controls window display when a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg]. +If non-nil, yanking the current message into a draft letter deletes any +windows displaying the message.") + +(defvar mh-yank-from-start-of-msg t + "*Controls which part of a message is yanked by \\<mh-letter-mode-map>\\[mh-yank-cur-msg]. +If non-nil, include the entire message. If the symbol `body', then yank the +message minus the header. If nil, yank only the portion of the message +following the point. If the show buffer has a region, this variable is +ignored.") + +(defvar mh-ins-buf-prefix "> " + "*String to put before each non-blank line of a yanked or inserted message. +\\<mh-letter-mode-map>Used when the message is inserted into an outgoing letter +by \\[mh-insert-letter] or \\[mh-yank-cur-msg].") + +(defvar mh-reply-default-reply-to nil + "*Sets the person or persons to whom a reply will be sent. +If nil, prompt for recipient. If non-nil, then \\<mh-folder-mode-map>`\\[mh-reply]' will use this +value and it should be one of \"from\", \"to\", \"cc\", or \"all\". +The values \"cc\" and \"all\" do the same thing.") + +(defvar mh-signature-file-name "~/.signature" + "*Name of file containing the user's signature. +Inserted into message by \\<mh-letter-mode-map>\\[mh-insert-signature].") + +(defvar mh-forward-subject-format "%s: %s" + "*Format to generate the Subject: line contents for a forwarded message. +The two string arguments to the format are the sender of the original +message and the original subject line.") + +(defvar mh-comp-formfile "components" + "Name of file to be used as a skeleton for composing messages. +Default is \"components\". If not a complete path name, the file +is searched for first in the user's MH directory, then in the +system MH lib directory.") + +(defvar mh-repl-formfile "replcomps" + "Name of file to be used as a skeleton for replying to messages. +Default is \"replcomps\". If not a complete path name, the file +is searched for first in the user's MH directory, then in the +system MH lib directory.") + +;;; Hooks: + +(defvar mh-letter-mode-hook nil + "Invoked in `mh-letter-mode' on a new letter.") + +(defvar mh-compose-letter-function nil + "Invoked when setting up a letter draft. +It is passed three arguments: TO recipients, SUBJECT, and CC recipients.") + +(defvar mh-before-send-letter-hook nil + "Invoked at the beginning of the \\<mh-letter-mode-map>\\[mh-send-letter] command.") + + +(defvar mh-rejected-letter-start + (concat "^ ----- Unsent message follows -----$" ;from sendmail V5 + "\\|^ ----- Original message follows -----$" ;from sendmail V8 + "\\|^------- Unsent Draft$" ;from MH itself + "\\|^---------- Original Message ----------$" ;from zmailer + "\\|^ --- The unsent message follows ---$" ;from AIX mail system + "\\|^ Your message follows:$" ;from MMDF-II + "\\|^Content-Description: Returned Content$" ;1993 KJ sendmail + ) + "Regexp specifying the beginning of the wrapper around a returned letter. +This wrapper is generated by the mail system when rejecting a letter.") + +(defvar mh-new-draft-cleaned-headers + "^Date:\\|^Received:\\|^Message-Id:\\|^From:\\|^Sender:\\|^Errors-To:\\|^Delivery-Date:\\|^Return-Path:" + "Regexp of header lines to remove before offering a message as a new draft. +Used by the \\<mh-folder-mode-map>`\\[mh-edit-again]' and `\\[mh-extract-rejected-mail]' commands.") + +(defvar mh-to-field-choices '(("t" . "To:") ("s" . "Subject:") ("c" . "Cc:") + ("b" . "Bcc:") ("f" . "Fcc:") ("r" . "From:") + ("d" . "Dcc:")) + "Alist of (final-character . field-name) choices for mh-to-field.") + +(defvar mh-letter-mode-map (copy-keymap text-mode-map) + "Keymap for composing mail.") + +(defvar mh-letter-mode-syntax-table nil + "Syntax table used by mh-e while in MH-Letter mode.") + +(if mh-letter-mode-syntax-table + () + (setq mh-letter-mode-syntax-table + (make-syntax-table text-mode-syntax-table)) + (modify-syntax-entry ?% "." mh-letter-mode-syntax-table)) + + +;;;###autoload +(defun mh-smail () + "Compose and send mail with the MH mail system. +This function is an entry point to mh-e, the Emacs front end +to the MH mail system. + +See documentation of `\\[mh-send]' for more details on composing mail." + (interactive) + (mh-find-path) + (call-interactively 'mh-send)) + + +(defvar mh-error-if-no-draft nil) ;raise error over using old draft + + +;;;###autoload +(defun mh-smail-batch () + "Set up a mail composition draft with the MH mail system. +This function is an entry point to mh-e, the Emacs front end +to the MH mail system. This function does not prompt the user +for any header fields, and thus is suitable for use by programs +that want to create a mail buffer. +Users should use `\\[mh-smail]' to compose mail." + (mh-find-path) + (let ((mh-error-if-no-draft t)) + (mh-send "" "" ""))) + + +(defun mh-edit-again (msg) + "Clean-up a draft or a message previously sent and make it resendable. +Default is the current message. +The variable mh-new-draft-cleaned-headers specifies the headers to remove. +See also documentation for `\\[mh-send]' function." + (interactive (list (mh-get-msg-num t))) + (let* ((from-folder mh-current-folder) + (config (current-window-configuration)) + (draft + (cond ((and mh-draft-folder (equal from-folder mh-draft-folder)) + (pop-to-buffer (find-file-noselect (mh-msg-filename msg)) t) + (rename-buffer (format "draft-%d" msg)) + (buffer-name)) + (t + (mh-read-draft "clean-up" (mh-msg-filename msg) nil))))) + (mh-clean-msg-header (point-min) mh-new-draft-cleaned-headers nil) + (goto-char (point-min)) + (save-buffer) + (mh-compose-and-send-mail draft "" from-folder nil nil nil nil nil nil + config))) + + +(defun mh-extract-rejected-mail (msg) + "Extract a letter returned by the mail system and make it resendable. +Default is the current message. The variable mh-new-draft-cleaned-headers +gives the headers to clean out of the original message. +See also documentation for `\\[mh-send]' function." + (interactive (list (mh-get-msg-num t))) + (let ((from-folder mh-current-folder) + (config (current-window-configuration)) + (draft (mh-read-draft "extraction" (mh-msg-filename msg) nil))) + (goto-char (point-min)) + (cond ((re-search-forward mh-rejected-letter-start nil t) + (skip-chars-forward " \t\n") + (delete-region (point-min) (point)) + (mh-clean-msg-header (point-min) mh-new-draft-cleaned-headers nil)) + (t + (message "Does not appear to be a rejected letter."))) + (goto-char (point-min)) + (save-buffer) + (mh-compose-and-send-mail draft "" from-folder msg + (mh-get-header-field "To:") + (mh-get-header-field "From:") + (mh-get-header-field "Cc:") + nil nil config))) + + +(defun mh-forward (to cc &optional msg-or-seq) + "Forward a message or message sequence. Defaults to displayed message. +If optional prefix argument provided, then prompt for the message sequence. +See also documentation for `\\[mh-send]' function." + (interactive (list (mh-read-address "To: ") + (mh-read-address "Cc: ") + (if current-prefix-arg + (mh-read-seq-default "Forward" t) + (mh-get-msg-num t)))) + (or msg-or-seq + (setq msg-or-seq (mh-get-msg-num t))) + (let* ((folder mh-current-folder) + (config (current-window-configuration)) + ;; forw always leaves file in "draft" since it doesn't have -draft + (draft-name (expand-file-name "draft" mh-user-path)) + (draft (cond ((or (not (file-exists-p draft-name)) + (y-or-n-p "The file 'draft' exists. Discard it? ")) + (mh-exec-cmd "forw" "-build" + mh-current-folder msg-or-seq) + (prog1 + (mh-read-draft "" draft-name t) + (mh-insert-fields "To:" to "Cc:" cc) + (save-buffer))) + (t + (mh-read-draft "" draft-name nil))))) + (let (orig-from + orig-subject) + (goto-char (point-min)) + (re-search-forward "^------- Forwarded Message") + (forward-line 1) + (skip-chars-forward " \t\n") + (save-restriction + (narrow-to-region (point) (point-max)) + (setq orig-from (mh-get-header-field "From:")) + (setq orig-subject (mh-get-header-field "Subject:"))) + (let ((forw-subject + (mh-forwarded-letter-subject orig-from orig-subject))) + (mh-insert-fields "Subject:" forw-subject) + (goto-char (point-min)) + (re-search-forward "^------- Forwarded Message") + (forward-line -1) + (delete-other-windows) + (if (numberp msg-or-seq) + (mh-add-msgs-to-seq msg-or-seq 'forwarded t) + (mh-add-msgs-to-seq (mh-seq-to-msgs msg-or-seq) 'forwarded t)) + (mh-compose-and-send-mail draft "" folder msg-or-seq + to forw-subject cc + mh-note-forw "Forwarded:" + config))))) + +(defun mh-forwarded-letter-subject (from subject) + ;; Return a Subject suitable for a forwarded message. + ;; Original message has headers FROM and SUBJECT. + (let ((addr-start (string-match "<" from)) + (comment (string-match "(" from))) + (cond ((and addr-start (> addr-start 0)) + ;; Full Name <luser@host> + (setq from (substring from 0 (1- addr-start)))) + (comment + ;; luser@host (Full Name) + (setq from (substring from (1+ comment) (1- (length from))))))) + (format mh-forward-subject-format from subject)) + + +;;;###autoload +(defun mh-smail-other-window () + "Compose and send mail in other window with the MH mail system. +This function is an entry point to mh-e, the Emacs front end +to the MH mail system. + +See documentation of `\\[mh-send]' for more details on composing mail." + (interactive) + (mh-find-path) + (call-interactively 'mh-send-other-window)) + + +(defun mh-redistribute (to cc &optional msg) + "Redistribute a letter. +Depending on how your copy of MH was compiled, you may need to change the +setting of the variable mh-redist-full-contents. See its documentation." + (interactive (list (mh-read-address "Redist-To: ") + (mh-read-address "Redist-Cc: ") + (mh-get-msg-num t))) + (or msg + (setq msg (mh-get-msg-num t))) + (save-window-excursion + (let ((folder mh-current-folder) + (draft (mh-read-draft "redistribution" + (if mh-redist-full-contents + (mh-msg-filename msg) + nil) + nil))) + (mh-goto-header-end 0) + (insert "Resent-To: " to "\n") + (if (not (equal cc "")) (insert "Resent-cc: " cc "\n")) + (mh-clean-msg-header (point-min) + "^Message-Id:\\|^Received:\\|^Return-Path:\\|^Sender:\\|^Date:\\|^From:" + nil) + (save-buffer) + (message "Redistributing...") + (if mh-redist-full-contents + (call-process "/bin/sh" nil 0 nil "-c" + (format "mhdist=1 mhaltmsg=%s %s -push %s" + buffer-file-name + (expand-file-name mh-send-prog mh-progs) + buffer-file-name)) + (call-process "/bin/sh" nil 0 nil "-c" + (format "mhdist=1 mhaltmsg=%s mhannotate=1 %s -push %s" + (mh-msg-filename msg folder) + (expand-file-name mh-send-prog mh-progs) + buffer-file-name))) + (mh-annotate-msg msg folder mh-note-dist + "-component" "Resent:" + "-text" (format "\"%s %s\"" to cc)) + (kill-buffer draft) + (message "Redistributing...done")))) + + +(defun mh-reply (message &optional includep) + "Reply to MESSAGE (default: current message). +If optional prefix argument INCLUDEP provided, then include the message +in the reply using filter mhl.reply in your MH directory. +Prompts for type of addresses to reply to: + from sender only, + to sender and primary recipients, + cc/all sender and all recipients. +If the file named by `mh-repl-formfile' exists, it is used as a skeleton +for the reply. See also documentation for `\\[mh-send]' function." + (interactive (list (mh-get-msg-num t) current-prefix-arg)) + (let ((minibuffer-help-form + "from => Sender only\nto => Sender and primary recipients\ncc or all => Sender and all recipients")) + (let ((reply-to (or mh-reply-default-reply-to + (completing-read "Reply to whom: " + '(("from") ("to") ("cc") ("all")) + nil + t))) + (folder mh-current-folder) + (show-buffer mh-show-buffer) + (config (current-window-configuration))) + (message "Composing a reply...") + (mh-exec-cmd "repl" "-build" "-noquery" "-nodraftfolder" + (if (stringp mh-repl-formfile) ;must be string, but we're paranoid + (list "-form" mh-repl-formfile)) + mh-current-folder message + (cond ((or (equal reply-to "from") (equal reply-to "")) + '("-nocc" "all")) + ((equal reply-to "to") + '("-cc" "to")) + ((or (equal reply-to "cc") (equal reply-to "all")) + '("-cc" "all" "-nocc" "me"))) + (if includep + '("-filter" "mhl.reply"))) + (let ((draft (mh-read-draft "reply" + (expand-file-name "reply" mh-user-path) + t))) + (delete-other-windows) + (save-buffer) + + (let ((to (mh-get-header-field "To:")) + (subject (mh-get-header-field "Subject:")) + (cc (mh-get-header-field "Cc:"))) + (goto-char (point-min)) + (mh-goto-header-end 1) + (or includep + (mh-in-show-buffer (show-buffer) + (mh-display-msg message folder))) + (mh-add-msgs-to-seq message 'answered t) + (message "Composing a reply...done") + (mh-compose-and-send-mail draft "" folder message to subject cc + mh-note-repl "Replied:" config)))))) + + +(defun mh-send (to cc subject) + "Compose and send a letter. +The file named by `mh-comp-formfile' will be used as the form. +Do not call this function from outside mh-e; use \\[mh-smail] instead. + +The letter is composed in mh-letter-mode; see its documentation for more +details. If `mh-compose-letter-function' is defined, it is called on the +draft and passed three arguments: to, subject, and cc." + (interactive (list + (mh-read-address "To: ") + (mh-read-address "Cc: ") + (read-string "Subject: "))) + (let ((config (current-window-configuration))) + (delete-other-windows) + (mh-send-sub to cc subject config))) + + +(defun mh-send-other-window (to cc subject) + "Compose and send a letter in another window. +Do not call this function from outside mh-e; +use \\[mh-smail-other-window] instead. +See also documentation for `\\[mh-send]' function." + (interactive (list + (mh-read-address "To: ") + (mh-read-address "Cc: ") + (read-string "Subject: "))) + (let ((pop-up-windows t)) + (mh-send-sub to cc subject (current-window-configuration)))) + + +(defun mh-send-sub (to cc subject config) + ;; Do the real work of composing and sending a letter. + ;; Expects the TO, CC, and SUBJECT fields as arguments. + ;; CONFIG is the window configuration before sending mail. + (let ((folder mh-current-folder) + (msg-num (mh-get-msg-num nil))) + (message "Composing a message...") + (let ((draft (mh-read-draft + "message" + (let (components) + (cond + ((file-exists-p + (setq components + (expand-file-name mh-comp-formfile mh-user-path))) + components) + ((file-exists-p + (setq components + (expand-file-name mh-comp-formfile mh-lib))) + components) + (t + (error (format "Can't find components file \"%s\"" + components))))) + nil))) + (mh-insert-fields "To:" to "Subject:" subject "Cc:" cc) + (goto-char (point-max)) + (message "Composing a message...done") + (mh-compose-and-send-mail draft "" folder msg-num + to subject cc + nil nil config)))) + + +(defun mh-read-draft (use initial-contents delete-contents-file) + ;; Read draft file into a draft buffer and make that buffer the current one. + ;; USE is a message used for prompting about the intended use of the message. + ;; INITIAL-CONTENTS is filename that is read into an empty buffer, or NIL + ;; if buffer should not be modified. Delete the initial-contents file if + ;; DELETE-CONTENTS-FILE flag is set. + ;; Returns the draft folder's name. + ;; If the draft folder facility is enabled in ~/.mh_profile, a new buffer is + ;; used each time and saved in the draft folder. The draft file can then be + ;; reused. + (cond (mh-draft-folder + (let ((orig-default-dir default-directory) + (draft-file-name (mh-new-draft-name))) + (pop-to-buffer (generate-new-buffer + (format "draft-%s" + (file-name-nondirectory draft-file-name)))) + (condition-case () + (insert-file-contents draft-file-name t) + (file-error)) + (setq default-directory orig-default-dir))) + (t + (let ((draft-name (expand-file-name "draft" mh-user-path))) + (pop-to-buffer "draft") ; Create if necessary + (if (buffer-modified-p) + (if (y-or-n-p "Draft has been modified; kill anyway? ") + (set-buffer-modified-p nil) + (error "Draft preserved"))) + (setq buffer-file-name draft-name) + (clear-visited-file-modtime) + (unlock-buffer) + (cond ((and (file-exists-p draft-name) + (not (equal draft-name initial-contents))) + (insert-file-contents draft-name) + (delete-file draft-name)))))) + (cond ((and initial-contents + (or (zerop (buffer-size)) + (if (y-or-n-p + (format "A draft exists. Use for %s? " use)) + (if mh-error-if-no-draft + (error "A prior draft exists.")) + t))) + (erase-buffer) + (insert-file-contents initial-contents) + (if delete-contents-file (delete-file initial-contents)))) + (auto-save-mode 1) + (if mh-draft-folder + (save-buffer)) ; Do not reuse draft name + (buffer-name)) + + +(defun mh-new-draft-name () + ;; Returns the pathname of folder for draft messages. + (save-excursion + (mh-exec-cmd-quiet t "mhpath" mh-draft-folder "new") + (buffer-substring (point-min) (1- (point-max))))) + + +(defun mh-annotate-msg (msg buffer note &rest args) + ;; Mark the MESSAGE in BUFFER listing with the character NOTE and annotate + ;; the saved message with ARGS. + (apply 'mh-exec-cmd "anno" buffer msg args) + (save-excursion + (cond ((get-buffer buffer) ; Buffer may be deleted + (set-buffer buffer) + (if (symbolp msg) + (mh-notate-seq msg note (1+ mh-cmd-note)) + (mh-notate msg note (1+ mh-cmd-note))))))) + + +(defun mh-insert-fields (&rest name-values) + ;; Insert the NAME-VALUE pairs in the current buffer. + ;; If field NAME exists, append VALUE to it. + ;; Do not insert any pairs whose value is the empty string. + (let ((case-fold-search t)) + (while name-values + (let ((field-name (car name-values)) + (value (car (cdr name-values)))) + (cond ((equal value "") + nil) + ((mh-position-on-field field-name) + (insert " " value)) + (t + (insert field-name " " value "\n"))) + (setq name-values (cdr (cdr name-values))))))) + + +(defun mh-position-on-field (field &optional ignore) + ;; Move to the end of the FIELD in the header. + ;; Move to end of entire header if FIELD not found. + ;; Returns non-nil iff FIELD was found. + ;; The optional second arg is for pre-version 4 compatibility. + (if (mh-goto-header-field field) + (progn + (mh-header-field-end) + t))) + + +(defun mh-get-header-field (field) + ;; Find and return the body of FIELD in the mail header. + ;; Returns the empty string if the field is not in the header of the + ;; current buffer. + (if (mh-goto-header-field field) + (progn + (skip-chars-forward " \t") ;strip leading white space in body + (let ((start (point))) + (mh-header-field-end) + (buffer-substring start (point)))) + "")) + +(fset 'mh-get-field 'mh-get-header-field) ;mh-e 4 compatibility + +(defun mh-goto-header-field (field) + ;; Move to FIELD in the message header. + ;; Move to the end of the FIELD name, which should end in a colon. + ;; Returns T if found, NIL if not. + (goto-char (point-min)) + (let ((case-fold-search t) + (headers-end (save-excursion + (mh-goto-header-end 0) + (point)))) + (re-search-forward (format "^%s" field) headers-end t))) + +(defun mh-header-field-end () + ;; Move to the end of the current header field. + ;; Handles RFC 822 continuation lines. + (forward-line 1) + (while (looking-at "^[ \t]") + (forward-line 1)) + (backward-char 1)) ;to end of previous line + + +(defun mh-goto-header-end (arg) + ;; Find the end of the message header in the current buffer and position + ;; the cursor at the ARG'th newline after the header. + (if (re-search-forward "^-*$" nil nil) + (forward-line arg))) + + +(defun mh-read-address (prompt) + ;; Read a To: or Cc: address, prompting in the minibuffer with PROMPT. + ;; May someday do completion on aliases. + (read-string prompt)) + + + +;;; Mode for composing and sending a draft message. + +(defvar mh-sent-from-folder nil) ;Folder of msg assoc with this letter. + +(defvar mh-sent-from-msg nil) ;Number of msg assoc with this letter. + +(defvar mh-send-args nil) ;Extra args to pass to "send" command. + +(defvar mh-annotate-char nil) ;Character to use to annotate mh-sent-from-msg. + +(defvar mh-annotate-field nil) ;Field name for message annotation. + +(put 'mh-letter-mode 'mode-class 'special) + +;;;###autoload +(defun mh-letter-mode () + "Mode for composing letters in mh-e.\\<mh-letter-mode-map> +When you have finished composing, type \\[mh-send-letter] to send the message +using the MH mail handling system. +See the documentation for \\[mh-edit-mhn] for information on composing MIME +messages. + +\\{mh-letter-mode-map} + +Variables controlling this mode (defaults in parentheses): + + mh-delete-yanked-msg-window (nil) + If non-nil, \\[mh-yank-cur-msg] will delete any windows displaying + the yanked message. + + mh-yank-from-start-of-msg (t) + If non-nil, \\[mh-yank-cur-msg] will include the entire message. + If `body', just yank the body (no header). + If nil, only the portion of the message following the point will be yanked. + If there is a region, this variable is ignored. + + mh-ins-buf-prefix (\"> \") + String to insert before each non-blank line of a message as it is + inserted in a draft letter. + + mh-signature-file-name (\"~/.signature\") + File to be inserted into message by \\[mh-insert-signature]. + +Upon invoking mh-letter-mode, text-mode-hook and mh-letter-mode-hook are +invoked with no args, if those values are non-nil." + + (interactive) + (or mh-user-path (mh-find-path)) + (make-local-variable 'paragraph-start) + (setq paragraph-start (concat "^[ \t]*[-_][-_][-_]+$\\|" paragraph-start)) + (make-local-variable 'paragraph-separate) + (setq paragraph-separate + (concat "^[ \t]*[-_][-_][-_]+$\\|" paragraph-separate)) + (make-local-variable 'mh-send-args) + (make-local-variable 'mh-annotate-char) + (make-local-variable 'mh-annotate-field) + (make-local-variable 'mh-previous-window-config) + (make-local-variable 'mh-sent-from-folder) + (make-local-variable 'mh-sent-from-msg) + (make-local-variable 'mail-header-separator) + (setq mail-header-separator "--------") ;for Hyperbole + (use-local-map mh-letter-mode-map) + (setq major-mode 'mh-letter-mode) + (mh-set-mode-name "MH-Letter") + (set-syntax-table mh-letter-mode-syntax-table) + (run-hooks 'text-mode-hook) + ;; if text-mode-hook turned on auto-fill, tune it for messages + (cond ((and (boundp 'auto-fill-hook) auto-fill-hook) ;emacs 18 + (make-local-variable 'auto-fill-hook) + (setq auto-fill-hook 'mh-auto-fill-for-letter))) + (cond ((and (boundp 'auto-fill-function) auto-fill-function) ;emacs 19 + (make-local-variable 'auto-fill-function) + (setq auto-fill-function 'mh-auto-fill-for-letter))) + (run-hooks 'mh-letter-mode-hook)) + + +(defun mh-auto-fill-for-letter () + ;; Auto-fill in letters treats the header specially by inserting a tab + ;; before continuation line. + (if (mh-in-header-p) + (let ((fill-prefix "\t")) + (do-auto-fill)) + (do-auto-fill))) + + +(defun mh-in-header-p () + ;; Return non-nil if the point is in the header of a draft message. + (save-excursion + (let ((cur-point (point))) + (goto-char (point-min)) + (re-search-forward "^-*$" nil t) + (< cur-point (point))))) + + +(defun mh-to-field () + "Move point to the end of a specified header field. +The field is indicated by the previous keystroke (the last keystroke +of the command) according to the list in the variable mh-to-field-choices. +Create the field if it does not exist. Set the mark to point before moving." + (interactive) + (expand-abbrev) + (let ((target (cdr (or (assoc (char-to-string (logior last-input-char ?`)) + mh-to-field-choices) + ;; also look for a char for version 4 compat + (assoc (logior last-input-char ?`) mh-to-field-choices)))) + (case-fold-search t)) + (push-mark) + (cond ((mh-position-on-field target) + (let ((eol (point))) + (skip-chars-backward " \t") + (delete-region (point) eol)) + (if (and (not (eq (logior last-input-char ?`) ?s)) + (save-excursion + (backward-char 1) + (not (looking-at "[:,]")))) + (insert ", ") + (insert " "))) + (t + (if (mh-position-on-field "To:") + (forward-line 1)) + (insert (format "%s \n" target)) + (backward-char 1))))) + + +(defun mh-to-fcc (&optional folder) + "Insert an Fcc: FOLDER field in the current message. +Prompt for the field name with a completion list of the current folders." + (interactive) + (or folder + (setq folder (mh-prompt-for-folder + "Fcc" + (or (and mh-default-folder-for-message-function + (save-excursion + (goto-char (point-min)) + (funcall mh-default-folder-for-message-function))) + "") + t))) + (let ((last-input-char ?\C-f)) + (expand-abbrev) + (save-excursion + (mh-to-field) + (insert (if (mh-folder-name-p folder) + (substring folder 1) + folder))))) + + +(defun mh-insert-signature () + "Insert the file named by mh-signature-file-name at the current point." + (interactive) + (insert-file-contents mh-signature-file-name) + (set-buffer-modified-p (buffer-modified-p))) ; force mode line update + + +(defun mh-check-whom () + "Verify recipients of the current letter, showing expansion of any aliases." + (interactive) + (let ((file-name buffer-file-name)) + (save-buffer) + (message "Checking recipients...") + (mh-in-show-buffer ("*Recipients*") + (bury-buffer (current-buffer)) + (erase-buffer) + (mh-exec-cmd-output "whom" t file-name)) + (message "Checking recipients...done"))) + + + +;;; Routines to compose and send a letter. + +(defun mh-compose-and-send-mail (draft send-args + sent-from-folder sent-from-msg + to subject cc + annotate-char annotate-field + config) + ;; Edit and compose a draft message in buffer DRAFT and send or save it. + ;; SENT-FROM-FOLDER is buffer containing scan listing of current folder, or + ;; nil if none exists. + ;; SENT-FROM-MSG is the message number or sequence name or nil. + ;; SEND-ARGS is an optional argument passed to the send command. + ;; The TO, SUBJECT, and CC fields are passed to the + ;; mh-compose-letter-function. + ;; If ANNOTATE-CHAR is non-null, it is used to notate the scan listing of the + ;; message. In that case, the ANNOTATE-FIELD is used to build a string + ;; for mh-annotate-msg. + ;; CONFIG is the window configuration to restore after sending the letter. + (pop-to-buffer draft) + (mh-letter-mode) + (setq mh-sent-from-folder sent-from-folder) + (setq mh-sent-from-msg sent-from-msg) + (setq mh-send-args send-args) + (setq mh-annotate-char annotate-char) + (setq mh-annotate-field annotate-field) + (setq mh-previous-window-config config) + (setq mode-line-buffer-identification (list "{%b}")) + (if (and (boundp 'mh-compose-letter-function) + mh-compose-letter-function) + ;; run-hooks will not pass arguments. + (let ((value mh-compose-letter-function)) + (if (and (listp value) (not (eq (car value) 'lambda))) + (while value + (funcall (car value) to subject cc) + (setq value (cdr value))) + (funcall mh-compose-letter-function to subject cc))))) + + +(defun mh-send-letter (&optional arg) + "Send the draft letter in the current buffer. +If optional prefix argument is provided, monitor delivery. +Run mh-before-send-letter-hook before doing anything." + (interactive "P") + (run-hooks 'mh-before-send-letter-hook) + (save-buffer) + (message "Sending...") + (let ((draft-buffer (current-buffer)) + (file-name buffer-file-name) + (config mh-previous-window-config)) + (cond (arg + (pop-to-buffer "MH mail delivery") + (erase-buffer) + (mh-exec-cmd-output mh-send-prog t "-watch" "-nopush" + "-nodraftfolder" mh-send-args file-name) + (goto-char (point-max)) ; show the interesting part + (recenter -1) + (set-buffer draft-buffer)) ; for annotation below + (t + (mh-exec-cmd-daemon mh-send-prog "-nodraftfolder" "-noverbose" + mh-send-args file-name))) + (if mh-annotate-char + (mh-annotate-msg mh-sent-from-msg + mh-sent-from-folder + mh-annotate-char + "-component" mh-annotate-field + "-text" (format "\"%s %s\"" + (mh-get-header-field "To:") + (mh-get-header-field "Cc:")))) + + (cond ((or (not arg) + (y-or-n-p "Kill draft buffer? ")) + (kill-buffer draft-buffer) + (if config + (set-window-configuration config)))) + (if arg + (message "Sending...done") + (message "Sending...backgrounded")))) + + +(defun mh-insert-letter (folder message verbatim) + "Insert a message into the current letter. +Removes the message's headers using mh-invisible-headers. Prefixes +each non-blank line with mh-ins-buf-prefix. Prompts for FOLDER and +MESSAGE. If prefix argument VERBATIM provided, do not indent and do +not delete headers. Leaves the mark before the letter and point after it." + (interactive + (list (mh-prompt-for-folder "Message from" mh-sent-from-folder nil) + (read-input (format "Message number%s: " + (if mh-sent-from-msg + (format " [%d]" mh-sent-from-msg) + ""))) + current-prefix-arg)) + (save-restriction + (narrow-to-region (point) (point)) + (let ((start (point-min))) + (if (equal message "") (setq message (int-to-string mh-sent-from-msg))) + (mh-exec-lib-cmd-output "mhl" "-nobell" "-noclear" + (expand-file-name message + (mh-expand-file-name folder))) + (cond ((not verbatim) + (mh-clean-msg-header start mh-invisible-headers mh-visible-headers) + (set-mark start) ; since mh-clean-msg-header moves it + (mh-insert-prefix-string mh-ins-buf-prefix)))))) + + +(defun mh-yank-cur-msg () + "Insert the current message into the draft buffer. +Prefix each non-blank line in the message with the string in +`mh-ins-buf-prefix'. If a region is set in the message's buffer, then +only the region will be inserted. Otherwise, the entire message will +be inserted if `mh-yank-from-start-of-msg' is non-nil. If this variable +is nil, the portion of the message following the point will be yanked. +If `mh-delete-yanked-msg-window' is non-nil, any window displaying the +yanked message will be deleted." + (interactive) + (if (and mh-sent-from-folder mh-sent-from-msg) + (let ((to-point (point)) + (to-buffer (current-buffer))) + (set-buffer mh-sent-from-folder) + (if mh-delete-yanked-msg-window + (delete-windows-on mh-show-buffer)) + (set-buffer mh-show-buffer) ; Find displayed message + (let ((mh-ins-str (cond ((if (boundp 'mark-active) + mark-active ;Emacs 19 + (mark)) ;Emacs 18 + (buffer-substring (region-beginning) + (region-end))) + ((eq 'body mh-yank-from-start-of-msg) + (buffer-substring + (save-excursion + (goto-char (point-min)) + (mh-goto-header-end 1) + (point)) + (point-max))) + (mh-yank-from-start-of-msg + (buffer-substring (point-min) (point-max))) + (t + (buffer-substring (point) (point-max)))))) + (set-buffer to-buffer) + (save-restriction + (narrow-to-region to-point to-point) + (push-mark) + (insert mh-ins-str) + (mh-insert-prefix-string mh-ins-buf-prefix) + (insert "\n")))) + (error "There is no current message"))) + + +(defun mh-insert-prefix-string (mh-ins-string) + ;; Run mail-citation-hook to insert a prefix string before each line + ;; in the buffer. Generality for supercite users. + (set-mark (point-max)) + (goto-char (point-min)) + (cond (mail-citation-hook + (run-hooks 'mail-citation-hook)) + (mh-yank-hooks ;old hook name + (run-hooks 'mh-yank-hooks)) + (t + (or (bolp) (forward-line 1)) + (let ((zmacs-regions nil)) ;so "(mark)" works in XEmacs + (while (< (point) (mark)) + (insert mh-ins-string) + (forward-line 1)))))) + + +(defun mh-fully-kill-draft () + "Kill the draft message file and the draft message buffer. +Use \\[kill-buffer] if you don't want to delete the draft message file." + (interactive) + (if (y-or-n-p "Kill draft message? ") + (let ((config mh-previous-window-config)) + (if (file-exists-p buffer-file-name) + (delete-file buffer-file-name)) + (set-buffer-modified-p nil) + (kill-buffer (buffer-name)) + (message "") + (if config + (set-window-configuration config))) + (error "Message not killed"))) + + +;;; Build the letter-mode keymap: + +(define-key mh-letter-mode-map "\C-c\C-f\C-b" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-f\C-c" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-f\C-d" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-f\C-f" 'mh-to-fcc) +(define-key mh-letter-mode-map "\C-c\C-f\C-r" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-f\C-s" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-f\C-t" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-fb" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-fc" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-fd" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-ff" 'mh-to-fcc) +(define-key mh-letter-mode-map "\C-c\C-fr" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-fs" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-ft" 'mh-to-field) +(define-key mh-letter-mode-map "\C-c\C-i" 'mh-insert-letter) +(define-key mh-letter-mode-map "\C-c\C-q" 'mh-fully-kill-draft) +(define-key mh-letter-mode-map "\C-c\C-\\" 'mh-fully-kill-draft) ;if no C-q +(define-key mh-letter-mode-map "\C-c\C-s" 'mh-insert-signature) +(define-key mh-letter-mode-map "\C-c\C-^" 'mh-insert-signature) ;if no C-s +(define-key mh-letter-mode-map "\C-c\C-w" 'mh-check-whom) +(define-key mh-letter-mode-map "\C-c\C-y" 'mh-yank-cur-msg) +(define-key mh-letter-mode-map "\C-c\C-c" 'mh-send-letter) +(define-key mh-letter-mode-map "\C-c\C-m\C-f" 'mh-mhn-compose-forw) +(define-key mh-letter-mode-map "\C-c\C-m\C-e" 'mh-mhn-compose-anon-ftp) +(define-key mh-letter-mode-map "\C-c\C-m\C-t" 'mh-mhn-compose-external-compressed-tar) +(define-key mh-letter-mode-map "\C-c\C-m\C-i" 'mh-mhn-compose-insertion) +(define-key mh-letter-mode-map "\C-c\C-e" 'mh-edit-mhn) +(define-key mh-letter-mode-map "\C-c\C-m\C-u" 'mh-revert-mhn-edit) + +;; "C-c /" prefix is used in mh-letter-mode by pgp.el + +;;; autoloads from mh-mime + +(autoload 'mh-mhn-compose-insertion "mh-mime" + "Add a directive to insert a MIME message part from a file. +This is the typical way to insert non-text parts in a message. +See also \\[mh-edit-mhn]." t) + +(autoload 'mh-mhn-compose-anon-ftp "mh-mime" + "Add a directive for a MIME anonymous ftp external body part. +This directive tells MH to include a reference to a +message/external-body part retrievable by anonymous FTP. +See also \\[mh-edit-mhn]." t) + +(autoload 'mh-mhn-compose-external-compressed-tar "mh-mime" + "Add a directive to include a MIME reference to a compressed tar file. +The file should be available via anonymous ftp. This directive +tells MH to include a reference to a message/external-body part. +See also \\[mh-edit-mhn]." t) + +(autoload 'mh-mhn-compose-forw "mh-mime" + "Add a forw directive to this message, to forward a message with MIME. +This directive tells MH to include another message in this one. +See also \\[mh-edit-mhn]." t) + +(autoload 'mh-edit-mhn "mh-mime" + "Format the current draft for MIME, expanding any mhn directives. +Process the current draft with the mhn program, which, +using directives already inserted in the draft, fills in +all the MIME components and header fields. +This step should be done last just before sending the message. +The mhn program is part of MH version 6.8 or later. +The `\\[mh-revert-mhn-edit]' command undoes this command. +For assistance with creating mhn directives to insert +various types of components in a message, see +\\[mh-mhn-compose-insertion] (generic insertion from a file), +\\[mh-mhn-compose-anon-ftp] (external reference to file via anonymous ftp), +\\[mh-mhn-compose-external-compressed-tar] \ +\(reference to compressed tar file via anonymous ftp), and +\\[mh-mhn-compose-forw] (forward message)." t) + +(autoload 'mh-revert-mhn-edit "mh-mime" + "Undoes the effect of \\[mh-edit-mhn] by reverting to the backup file. +Optional non-nil argument means don't ask for confirmation." t)