| blob | 5c33f370e939c9d3a19813fcd1a6e8e6cf7168f5 |
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.
61 The headers should be delimited by a line whose contents
64 ;;;###autoload
68 ;;;###autoload
70 *Name of file to write all outgoing messages in, or nil for none.
73 ;;;###autoload
77 ;;;###autoload
79 "*If non-nil, the name of a file to use instead of `/usr/lib/aliases'.
80 This file defines aliases to be expanded by the mailer; this is a different
81 feature from that of defining aliases in `.mailrc' to be expanded in Emacs.
84 ;;;###autoload
86 "*If non-nil, the name of the user's personal mail alias file.
87 This file typically should be in same format as the `.mailrc' file used by
88 the `Mail' or `mailx' program.
92 "Normal hook, run each time a new outgoing mail message is initialized.
96 "Alist of mail address aliases,
97 or t meaning should be initialized from your mail aliases file.
98 \(The file's name is normally `~/.mailrc', but your MAILRC environment
99 variable can override that name.)
100 The alias definitions in the file have this form:
107 "*Prefix insert on lines of yanked message being replied to.
110 "*Number of spaces to insert at the beginning of each cited line.
113 "Obsolete hook for modifying a citation just inserted in the mail buffer.
114 Each hook function can find the citation between (point) and (mark t).
115 And each hook function should leave point and mark around the citation
116 text as modified.
118 This is a normal hook, misnamed for historical reasons.
122 "*Hook for modifying a citation just inserted in the mail buffer.
123 Each hook function can find the citation between (point) and (mark t).
124 And each hook function should leave point and mark around the citation
125 text as modified.
127 If this hook is entirely empty (nil), a default action is taken
134 "Read mail aliases from user's personal aliases file and set `mail-aliases'."
135 nil)
138 "Expand all mail aliases in suitable header fields found between BEG and END.
139 Suitable header fields are `To', `Cc' and `Bcc' and their `Resent-' variants.
140 Optional second arg EXCLUDE may be a regular expression defining text to be
141 removed from alias expansions."
142 nil)
144 ;;;###autoload
146 "*Text inserted at end of mail buffer when a message is initialized.
154 "*A string containing header lines, to be inserted in outgoing messages.
155 It is inserted before you edit the message,
159 "*If non-nil, try to show RMAIL summary buffer after returning from mail.
161 the RMAIL summary buffer before returning, if it exists and this variable
164 ;; Note: could use /usr/ucb/mail instead of sendmail;
165 ;; options -t, and -v if not interactive.
178 ;; According to RFC822, "The field-name must be composed of printable
179 ;; ASCII characters (i.e. characters that have decimal values between
180 ;; 33 and 126, except colon)", i.e. any chars except ctl chars,
181 ;; space, or colon.
183 "Set this non-nil if the system's mailer runs the header and body together.
184 \(This problem exists on Sunos 4 when sendmail is run in remote mode.)
185 The value should be an expression to test whether the problem will
214 mail-aliases t))))
231 ;; Here removed code to extract names from within <...>
232 ;; on the assumption that mail-strip-quoted-names
233 ;; has been called and has done so.
260 ;; Insert the signature. But remember the beginning of the message.
276 ;;;###autoload
278 "Major mode for editing mail to be sent.
279 Like Text Mode but with these additional commands:
280 C-c C-s mail-send (send the message) C-c C-c mail-send-and-exit
281 C-c C-f move to a header field (and create it if there isn't):
282 C-c C-f C-t move to To: C-c C-f C-s move to Subject:
283 C-c C-f C-c move to CC: C-c C-f C-b move to BCC:
284 C-c C-f C-f move to FCC:
285 C-c C-t mail-text (move to beginning of message text).
286 C-c C-w mail-signature (insert `~/.signature' file).
287 C-c C-y mail-yank-original (insert current message, in Rmail).
288 C-c C-q mail-fill-yanked-message (fill what was yanked).
289 C-c C-v mail-sent-via (add a Sent-via field for each To or CC)."
307 paragraph-start))
310 paragraph-separate))
312 \f
313 ;;; Set up keymap.
316 nil
380 \f
382 "Send message like `mail-send', then, if no errors, exit from mail buffer.
383 Prefix arg means don't delete this window."
389 "Don't send the message you have been editing.
390 Prefix arg means don't delete this window."
395 "Bury this mail buffer."
411 rmail-summary-buffer
414 rmail-summary-buffer))))
416 ;; If the Rmail buffer has a summary, show that.
422 "Send the message in the current buffer.
423 If `mail-interactive' is non-nil, wait for success indication
424 or error messages, and inform user.
425 Otherwise any failure is reported in a message back to
426 the user from the mailer."
436 ;; Now perform actions on successful sending.
444 ;; If buffer has no file, mark it as unmodified and delete autosave.
456 resend-to-addresses
457 delimline
465 ;; require one newline at the end.
468 ;; Change header-delimiter to be what sendmail expects.
479 ;; ignore any blank lines in the header
485 ;; Find and handle any FCC fields.
499 resend-to-addresses))))
500 ;;; Apparently this causes a duplicate Sender.
501 ;;; ;; If the From is different than current user, insert Sender.
502 ;;; (goto-char (point-min))
503 ;;; (and (re-search-forward "^From:" delimline t)
504 ;;; (progn
505 ;;; (require 'mail-utils)
506 ;;; (not (string-equal
507 ;;; (mail-strip-quoted-names
508 ;;; (save-restriction
509 ;;; (narrow-to-region (point-min) delimline)
510 ;;; (mail-fetch-field "From")))
511 ;;; (user-login-name))))
512 ;;; (progn
513 ;;; (forward-line 1)
514 ;;; (insert "Sender: " (user-login-name) "\n")))
515 ;; Don't send out a blank subject line
519 ;; Put the "From:" field in unless for some odd reason
520 ;; they put one in themselves.
530 ;; Look for a character that cannot appear unquoted
531 ;; according to RFC 822.
535 ;; Quote fullname, escaping specials.
549 ;; RFC 822 says \ and nonmatching parentheses
550 ;; must be escaped in comments.
551 ;; Escape every instance of ()\ ...
554 ;; ... then undo escaping of matching parentheses,
555 ;; including matching nested parentheses.
565 ;; Insert an extra newline if we need it to work around
566 ;; Sun's bug that swallows newlines.
577 sendmail-program
580 ;; Always specify who from,
581 ;; since some systems have broken sendmails.
583 ;;; ;; Don't say "from root" if running under su.
584 ;;; (and (equal (user-real-login-name) "root")
585 ;;; (list "-f" (user-login-name)))
588 ;; These mean "report errors by mail"
589 ;; and "deliver in background".
591 ;; Get the addresses from the message
592 ;; unless this is a resend.
593 ;; We must not do that for a resend
594 ;; because we would find the original addresses.
595 ;; For a resend, include the specific addresses.
611 ;; Return non-nil if file FILE is an Rmail file.
635 fcc-list))
640 ;; This initial newline is written out if the fcc file already exists.
643 ;; Insert the time zone before the year.
650 ;; Make sure messages are separated.
654 ;; ``Quote'' "^From " as ">From "
655 ;; (note that this isn't really quoting, as there is no requirement
656 ;; that "^[>]+From " be quoted in the same transparent way.)
668 ;; File is present in a buffer => append to that buffer.
671 ;; Keep the end of the accessible portion at the same place
672 ;; unless it is the end of the buffer.
676 ;; Code below lifted from rmailout.el
677 ;; function rmail-output-to-rmail-file:
680 rmail-current-message)))
681 ;; If MSG is non-nil, buffer is in RMAIL mode.
699 ;; Output file not in rmail mode
700 ;; => just insert at the end.
705 ;; Else append to the file directly.
708 ;; If the file is a Babyl file,
709 ;; convert the message to Babyl format.
724 "Make a Sent-via header line from each To or CC header line."
728 ;; find the header-separator
731 ;; put a marker at the end of the header
734 to-line)
736 ;; search for the To: lines and make Sent-via: lines from them
737 ;; search for the next To: line
739 ;; Grab this line plus all its continuations, sans the `to:'.
747 ;; Insert a copy, with altered header field name.
749 \f
751 "Move point to end of To-field."
757 "Move point to end of Subject-field."
763 "Move point to end of CC-field. Create a CC field if none."
771 "Move point to end of BCC-field. Create a BCC field if none."
779 "Add a new FCC field, with file name completion."
787 "Move point to end of Reply-To-field."
804 t)
809 nil)))
812 "Move point to beginning of message text."
817 \f
819 "Sign letter with contents of the file `~/.signature'.
820 Prefix arg means put contents at point."
833 "Fill the paragraphs of a message yanked into this one.
834 Numeric argument means justify as well."
841 justifyp
842 t)))
845 "Modify text just inserted from a message to be cited.
846 The inserted text should be the region.
847 When this function returns, the region is again around the modified text.
849 Normally, indent each nonblank line `mail-indentation-spaces' spaces.
850 However, if `mail-yank-prefix' is non-nil, insert that prefix on each line."
862 "Insert the message being replied to, if any (in rmail).
863 Puts point before the text and mark after.
864 Normally, indents each nonblank line ARG spaces (default 3).
865 However, if `mail-yank-prefix' is non-nil, insert that prefix on each line.
868 and don't delete any header fields."
872 ;; If the original message is in another window in the same frame,
873 ;; delete that window to save screen space.
874 ;; t means don't alter other frames.
878 nil
881 mail-indentation-spaces)))
887 ;; This is like exchange-point-and-mark, but doesn't activate the mark.
888 ;; It is cleaner to avoid activation, even though the command
889 ;; loop would deactivate the mark because we inserted text.
908 \f
909 ;; Put these last, to reduce chance of lossage from quitting in middle of loading the file.
911 ;;;###autoload
913 "Edit a message to be sent. Prefix arg means resume editing (don't erase).
914 When this function returns, the buffer `*mail*' is selected.
915 The value is t if the message was newly initialized; otherwise, nil.
917 Optionally, the signature file `~/.signature' can be inserted at the end;
918 see the variable `mail-signature'.
923 Various special commands starting with C-c are available in sendmail mode
924 to move to message header fields:
927 If `mail-self-blind' is non-nil, a BCC to yourself is inserted
928 when the message is initialized.
930 If `mail-default-reply-to' is non-nil, it should be an address (a string);
931 a Reply-to: field with that address is inserted.
933 If `mail-archive-file-name' is non-nil, an FCC field with that file name
934 is inserted.
936 The normal hook `mail-setup-hook' is run after the message is
937 initialized. It can add more default fields to the message.
939 When calling from a program, the first argument if non-nil says
940 not to erase the existing contents of the `*mail*' buffer.
942 The second through fifth arguments,
943 TO, SUBJECT, IN-REPLY-TO and CC, specify if non-nil
944 the initial contents of those header fields.
945 These arguments should not have final newlines.
946 The sixth argument REPLYBUFFER is a buffer whose contents
947 should be yanked if the user types C-c C-y.
948 The seventh argument ACTIONS is a list of actions to take
949 if/when the message is sent. Each action looks like (FUNCTION . ARGS);
950 when the message is sent, we apply FUNCTION to ARGS.
951 This is how Rmail arranges to mark messages `answered'."
953 ;;; This is commented out because I found it was confusing in practice.
954 ;;; It is easy enough to rename *mail* by hand with rename-buffer
955 ;;; if you want to have multiple mail buffers.
956 ;;; And then you can control which messages to save. --rms.
957 ;;; (let ((index 1)
958 ;;; buffer)
959 ;;; ;; If requested, look for a mail buffer that is modified and go to it.
960 ;;; (if noerase
961 ;;; (progn
962 ;;; (while (and (setq buffer
963 ;;; (get-buffer (if (= 1 index) "*mail*"
964 ;;; (format "*mail*<%d>" index))))
965 ;;; (not (buffer-modified-p buffer)))
966 ;;; (setq index (1+ index)))
967 ;;; (if buffer (switch-to-buffer buffer)
968 ;;; ;; If none exists, start a new message.
969 ;;; ;; This will never re-use an existing unmodified mail buffer
970 ;;; ;; (since index is not 1 anymore). Perhaps it should.
971 ;;; (setq noerase nil))))
972 ;;; ;; Unless we found a modified message and are happy, start a new message.
973 ;;; (if (not noerase)
974 ;;; (progn
975 ;;; ;; Look for existing unmodified mail buffer.
976 ;;; (while (and (setq buffer
977 ;;; (get-buffer (if (= 1 index) "*mail*"
978 ;;; (format "*mail*<%d>" index))))
979 ;;; (buffer-modified-p buffer))
980 ;;; (setq index (1+ index)))
981 ;;; ;; If none, make a new one.
982 ;;; (or buffer
983 ;;; (setq buffer (generate-new-buffer "*mail*")))
984 ;;; ;; Go there and initialize it.
985 ;;; (switch-to-buffer buffer)
986 ;;; (erase-buffer)
987 ;;; (setq default-directory (expand-file-name "~/"))
988 ;;; (auto-save-mode auto-save-default)
989 ;;; (mail-mode)
990 ;;; (mail-setup to subject in-reply-to cc replybuffer actions)
991 ;;; (if (and buffer-auto-save-file-name
992 ;;; (file-exists-p buffer-auto-save-file-name))
993 ;;; (message "Auto save file for draft message exists; consider M-x mail-recover"))
994 ;;; t))
1000 ;; Disconnect the buffer from its visited file
1001 ;; (in case the user has actually visited a file *mail*).
1002 ; (set-visited-file-name nil)
1013 initialized))
1016 "Reread contents of current buffer from its last auto-save file."
1030 ;;;###autoload
1032 "Like `mail' command, but display mail buffer in another window."
1042 ;;;###autoload
1044 "Like `mail' command, but display mail buffer in another frame."
1054 ;;; Do not execute these when sendmail.el is loaded,
1055 ;;; only in loaddefs.el.
1056 ;;;###autoload (define-key ctl-x-map "m" 'mail)
1057 ;;;###autoload (define-key ctl-x-4-map "m" 'mail-other-window)
1058 ;;;###autoload (define-key ctl-x-5-map "m" 'mail-other-frame)
1060 ;;;###autoload (add-hook 'same-window-buffer-names "*mail*")
1062 ;;; Do not add anything but external entries on this page.
1066 ;;; sendmail.el ends here