| blob | 1c98a9c9083762d2bdb1bc09211ea76c024ccf90 |
1 ;;; sendmail.el --- mail sending commands for Emacs.
3 ;; Copyright (C) 1985, 1986, 1992, 1993, 1994, 1995 Free Software Foundation, Inc.
5 ;; Maintainer: FSF
6 ;; Keywords: mail
8 ;; This file is part of GNU Emacs.
10 ;; GNU Emacs is free software; you can redistribute it and/or modify
11 ;; it under the terms of the GNU General Public License as published by
12 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; any later version.
15 ;; GNU Emacs is distributed in the hope that it will be useful,
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ;; GNU General Public License for more details.
20 ;; You should have received a copy of the GNU General Public License
21 ;; along with GNU Emacs; see the file COPYING. If not, write to
22 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
24 ;;; Commentary:
26 ;; This mode provides mail-sending facilities from within Emacs. It is
27 ;; documented in the Emacs user's manual.
29 ;;; Code:
31 ;;;###autoload
35 If `nil', they contain just the return address like:
36 king@grassland.com
37 If `parens', they look like:
38 king@grassland.com (Elvis Parsley)
39 If `angles', they look like:
42 ;;;###autoload
44 Non-nil means insert BCC to self in messages to be sent.
45 This is done when the message is initialized,
48 ;;;###autoload
50 Non-nil means when sending a message wait for and display errors.
53 ;;;###autoload
54 (defvar mail-yank-ignored-headers "^via:\\|^mail-from:\\|^origin:\\|^status:\\|^remailed\\|^received:\\|^message-id:\\|^summary-line:\\|^to:\\|^subject:\\|^in-reply-to:\\|^return-path:" "\
57 ;; Useful to set in site-init.el
58 ;;;###autoload
60 Function to call to send the current buffer as mail.
63 ;;;###autoload
67 ;;;###autoload
69 *Name of file to write all outgoing messages in, or nil for none.
72 ;;;###autoload
76 ;;;###autoload
78 "*If non-nil, the name of a file to use instead of `/usr/lib/aliases'.
79 This file defines aliases to be expanded by the mailer; this is a different
80 feature from that of defining aliases in `.mailrc' to be expanded in Emacs.
83 ;;;###autoload
85 "*If non-nil, the name of the user's personal mail alias file.
86 This file typically should be in same format as the `.mailrc' file used by
87 the `Mail' or `mailx' program.
91 "Alist of mail address aliases,
92 or t meaning should be initialized from your mail aliases file.
93 \(The file's name is normally `~/.mailrc', but your MAILRC environment
94 variable can override that name.)
95 The alias definitions in the file have this form:
102 "*Prefix insert on lines of yanked message being replied to.
105 "*Number of spaces to insert at the beginning of each cited line.
108 "Obsolete hook for modifying a citation just inserted in the mail buffer.
109 Each hook function can find the citation between (point) and (mark t).
110 And each hook function should leave point and mark around the citation
111 text as modified.
113 This is a normal hook, misnamed for historical reasons.
117 "*Hook for modifying a citation just inserted in the mail buffer.
118 Each hook function can find the citation between (point) and (mark t).
119 And each hook function should leave point and mark around the citation
120 text as modified.
122 If this hook is entirely empty (nil), a default action is taken
129 "Read mail aliases from user's personal aliases file and set `mail-aliases'."
130 nil)
133 "Expand all mail aliases in suitable header fields found between BEG and END.
134 Suitable header fields are `To', `Cc' and `Bcc' and their `Resent-' variants.
135 Optional second arg EXCLUDE may be a regular expression defining text to be
136 removed from alias expansions."
137 nil)
139 ;;;###autoload
141 "*Text inserted at end of mail buffer when a message is initialized.
149 "*A string containing header lines, to be inserted in outgoing messages.
150 It is inserted before you edit the message,
154 "*If non-nil, try to show RMAIL summary buffer after returning from mail.
156 the RMAIL summary buffer before returning, if it exists and this variable
159 ;; Note: could use /usr/ucb/mail instead of sendmail;
160 ;; options -t, and -v if not interactive.
173 ;; According to RFC822, "The field-name must be composed of printable
174 ;; ASCII characters (i.e. characters that have decimal values between
175 ;; 33 and 126, except colon)", i.e. any chars except ctl chars,
176 ;; space, or colon.
178 "Set this non-nil if the system's mailer runs the header and body together.
179 \(This problem exists on Sunos 4 when sendmail is run in remote mode.)
180 The value should be an expression to test whether the problem will
209 mail-aliases t))))
226 ;; Here removed code to extract names from within <...>
227 ;; on the assumption that mail-strip-quoted-names
228 ;; has been called and has done so.
255 ;; Insert the signature. But remember the beginning of the message.
271 ;;;###autoload
273 "Major mode for editing mail to be sent.
274 Like Text Mode but with these additional commands:
275 C-c C-s mail-send (send the message) C-c C-c mail-send-and-exit
276 C-c C-f move to a header field (and create it if there isn't):
277 C-c C-f C-t move to To: C-c C-f C-s move to Subj:
278 C-c C-f C-b move to BCC: C-c C-f C-c move to CC:
279 C-c C-f C-f move to FCC:
280 C-c C-t move to message text.
281 C-c C-y mail-yank-original (insert current message, in Rmail).
282 C-c C-q mail-fill-yanked-message (fill what was yanked).
283 C-c C-v mail-sent-via (add a sent-via field for each To or CC)."
301 paragraph-start))
304 paragraph-separate))
306 \f
307 ;;; Set up keymap.
310 nil
370 \f
372 "Send message like `mail-send', then, if no errors, exit from mail buffer.
373 Prefix arg means don't delete this window."
379 "Don't send the message you have been editing.
380 Prefix arg means don't delete this window."
385 "Bury this mail buffer."
401 rmail-summary-buffer
404 rmail-summary-buffer))))
406 ;; If the Rmail buffer has a summary, show that.
412 "Send the message in the current buffer.
413 If `mail-interactive' is non-nil, wait for success indication
414 or error messages, and inform user.
415 Otherwise any failure is reported in a message back to
416 the user from the mailer."
426 ;; Now perform actions on successful sending.
434 ;; If buffer has no file, mark it as unmodified and delete autosave.
446 resend-to-addresses
447 delimline
455 ;; require one newline at the end.
458 ;; Change header-delimiter to be what sendmail expects.
469 ;; ignore any blank lines in the header
475 ;; Find and handle any FCC fields.
489 resend-to-addresses))))
490 ;;; Apparently this causes a duplicate Sender.
491 ;;; ;; If the From is different than current user, insert Sender.
492 ;;; (goto-char (point-min))
493 ;;; (and (re-search-forward "^From:" delimline t)
494 ;;; (progn
495 ;;; (require 'mail-utils)
496 ;;; (not (string-equal
497 ;;; (mail-strip-quoted-names
498 ;;; (save-restriction
499 ;;; (narrow-to-region (point-min) delimline)
500 ;;; (mail-fetch-field "From")))
501 ;;; (user-login-name))))
502 ;;; (progn
503 ;;; (forward-line 1)
504 ;;; (insert "Sender: " (user-login-name) "\n")))
505 ;; Don't send out a blank subject line
509 ;; Put the "From:" field in unless for some odd reason
510 ;; they put one in themselves.
521 ;; Insert an extra newline if we need it to work around
522 ;; Sun's bug that swallows newlines.
533 sendmail-program
536 ;; Always specify who from,
537 ;; since some systems have broken sendmails.
539 ;;; ;; Don't say "from root" if running under su.
540 ;;; (and (equal (user-real-login-name) "root")
541 ;;; (list "-f" (user-login-name)))
544 ;; These mean "report errors by mail"
545 ;; and "deliver in background".
547 ;; Get the addresses from the message
548 ;; unless this is a resend.
549 ;; We must not do that for a resend
550 ;; because we would find the original addresses.
551 ;; For a resend, include the specific addresses.
567 ;; Return non-nil if file FILE is an Rmail file.
591 fcc-list))
596 ;; This initial newline is written out if the fcc file already exists.
599 ;; Insert the time zone before the year.
606 ;; Make sure messages are separated.
610 ;; ``Quote'' "^From " as ">From "
611 ;; (note that this isn't really quoting, as there is no requirement
612 ;; that "^[>]+From " be quoted in the same transparent way.)
624 ;; File is present in a buffer => append to that buffer.
627 ;; Keep the end of the accessible portion at the same place
628 ;; unless it is the end of the buffer.
632 ;; Code below lifted from rmailout.el
633 ;; function rmail-output-to-rmail-file:
636 rmail-current-message)))
637 ;; If MSG is non-nil, buffer is in RMAIL mode.
655 ;; Output file not in rmail mode
656 ;; => just insert at the end.
661 ;; Else append to the file directly.
664 ;; If the file is a Babyl file,
665 ;; convert the message to Babyl format.
680 "Make a Sent-via header line from each To or CC header line."
684 ;; find the header-separator
687 ;; put a marker at the end of the header
690 to-line)
692 ;; search for the To: lines and make Sent-via: lines from them
693 ;; search for the next To: line
695 ;; Grab this line plus all its continuations, sans the `to:'.
703 ;; Insert a copy, with altered header field name.
705 \f
707 "Move point to end of To-field."
713 "Move point to end of Subject-field."
719 "Move point to end of CC-field. Create a CC field if none."
727 "Move point to end of BCC-field. Create a BCC field if none."
735 "Add a new FCC field, with file name completion."
754 t)
759 nil)))
762 "Move point to beginning of text field."
766 \f
768 "Sign letter with contents of the file `~/.signature'.
769 Prefix arg means put contents at point."
782 "Fill the paragraphs of a message yanked into this one.
783 Numeric argument means justify as well."
790 justifyp
791 t)))
794 "Modify text just inserted from a message to be cited.
795 The inserted text should be the region.
796 When this function returns, the region is again around the modified text.
798 Normally, indent each nonblank line `mail-indentation-spaces' spaces.
799 However, if `mail-yank-prefix' is non-nil, insert that prefix on each line."
811 "Insert the message being replied to, if any (in rmail).
812 Puts point before the text and mark after.
813 Normally, indents each nonblank line ARG spaces (default 3).
814 However, if `mail-yank-prefix' is non-nil, insert that prefix on each line.
817 and don't delete any header fields."
821 ;; If the original message is in another window in the same frame,
822 ;; delete that window to save screen space.
823 ;; t means don't alter other frames.
827 nil
830 mail-indentation-spaces)))
836 ;; This is like exchange-point-and-mark, but doesn't activate the mark.
837 ;; It is cleaner to avoid activation, even though the command
838 ;; loop would deactivate the mark because we inserted text.
857 \f
858 ;; Put these last, to reduce chance of lossage from quitting in middle of loading the file.
860 ;;;###autoload
862 "Edit a message to be sent. Prefix arg means resume editing (don't erase).
863 When this function returns, the buffer `*mail*' is selected.
864 The value is t if the message was newly initialized; otherwise, nil.
866 By default, the signature file `~/.signature' is inserted at the end;
867 see the variable `mail-signature'.
872 Various special commands starting with C-c are available in sendmail mode
873 to move to message header fields:
876 If `mail-self-blind' is non-nil, a BCC to yourself is inserted
877 when the message is initialized.
879 If `mail-default-reply-to' is non-nil, it should be an address (a string);
880 a Reply-to: field with that address is inserted.
882 If `mail-archive-file-name' is non-nil, an FCC field with that file name
883 is inserted.
885 If `mail-setup-hook' is bound, its value is called with no arguments
886 after the message is initialized. It can add more default fields.
888 When calling from a program, the first argument if non-nil says
889 not to erase the existing contents of the `*mail*' buffer.
891 The second through fifth arguments,
892 TO, SUBJECT, IN-REPLY-TO and CC, specify if non-nil
893 the initial contents of those header fields.
894 These arguments should not have final newlines.
895 The sixth argument REPLYBUFFER is a buffer whose contents
896 should be yanked if the user types C-c C-y.
897 The seventh argument ACTIONS is a list of actions to take
898 if/when the message is sent. Each action looks like (FUNCTION . ARGS);
899 when the message is sent, we apply FUNCTION to ARGS.
900 This is how Rmail arranges to mark messages `answered'."
902 ;;; This is commented out because I found it was confusing in practice.
903 ;;; It is easy enough to rename *mail* by hand with rename-buffer
904 ;;; if you want to have multiple mail buffers.
905 ;;; And then you can control which messages to save. --rms.
906 ;;; (let ((index 1)
907 ;;; buffer)
908 ;;; ;; If requested, look for a mail buffer that is modified and go to it.
909 ;;; (if noerase
910 ;;; (progn
911 ;;; (while (and (setq buffer
912 ;;; (get-buffer (if (= 1 index) "*mail*"
913 ;;; (format "*mail*<%d>" index))))
914 ;;; (not (buffer-modified-p buffer)))
915 ;;; (setq index (1+ index)))
916 ;;; (if buffer (switch-to-buffer buffer)
917 ;;; ;; If none exists, start a new message.
918 ;;; ;; This will never re-use an existing unmodified mail buffer
919 ;;; ;; (since index is not 1 anymore). Perhaps it should.
920 ;;; (setq noerase nil))))
921 ;;; ;; Unless we found a modified message and are happy, start a new message.
922 ;;; (if (not noerase)
923 ;;; (progn
924 ;;; ;; Look for existing unmodified mail buffer.
925 ;;; (while (and (setq buffer
926 ;;; (get-buffer (if (= 1 index) "*mail*"
927 ;;; (format "*mail*<%d>" index))))
928 ;;; (buffer-modified-p buffer))
929 ;;; (setq index (1+ index)))
930 ;;; ;; If none, make a new one.
931 ;;; (or buffer
932 ;;; (setq buffer (generate-new-buffer "*mail*")))
933 ;;; ;; Go there and initialize it.
934 ;;; (switch-to-buffer buffer)
935 ;;; (erase-buffer)
936 ;;; (setq default-directory (expand-file-name "~/"))
937 ;;; (auto-save-mode auto-save-default)
938 ;;; (mail-mode)
939 ;;; (mail-setup to subject in-reply-to cc replybuffer actions)
940 ;;; (if (and buffer-auto-save-file-name
941 ;;; (file-exists-p buffer-auto-save-file-name))
942 ;;; (message "Auto save file for draft message exists; consider M-x mail-recover"))
943 ;;; t))
949 ;; Disconnect the buffer from its visited file
950 ;; (in case the user has actually visited a file *mail*).
951 ; (set-visited-file-name nil)
962 initialized))
965 "Reread contents of current buffer from its last auto-save file."
979 ;;;###autoload
981 "Like `mail' command, but display mail buffer in another window."
987 ;;;###autoload
989 "Like `mail' command, but display mail buffer in another frame."
995 ;;; Do not execute these when sendmail.el is loaded,
996 ;;; only in loaddefs.el.
997 ;;;###autoload (define-key ctl-x-map "m" 'mail)
998 ;;;###autoload (define-key ctl-x-4-map "m" 'mail-other-window)
999 ;;;###autoload (define-key ctl-x-5-map "m" 'mail-other-frame)
1001 ;;; Do not add anything but external entries on this page.
1005 ;;; sendmail.el ends here