-;;; mailalias.el --- expand mailing address aliases defined in ~/.mailrc.
+;;; mailalias.el --- expand and complete mailing address aliases
-;; Copyright (C) 1985, 1987 Free Software Foundation, Inc.
+;; Copyright (C) 1985, 1987, 1995, 1996, 1997 Free Software Foundation, Inc.
;; Maintainer: FSF
;; Keywords: mail
;; 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.
+;; along with GNU Emacs; see the file COPYING. If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
;;; Commentary:
(require 'sendmail)
+(defgroup mailalias nil
+ "Expanding mail aliases"
+ :group 'mail)
+
+(defcustom mail-passwd-files '("/etc/passwd")
+ "*List of files from which to determine valid user names."
+ :type '(repeat string)
+ :group 'mailalias)
+
+(defcustom mail-passwd-command nil
+ "*Shell command to retrieve text to add to `/etc/passwd', or nil."
+ :type '(choice string (const nil))
+ :group 'mailalias)
+
+(defvar mail-directory-names t
+ "Alist of mail address directory entries.
+When t this still needs to be initialized.")
+
+(defvar mail-address-field-regexp
+ "^\\(Resent-\\)?\\(To\\|From\\|CC\\|BCC\\|Reply-to\\):")
+
+(defcustom mail-complete-alist
+ ;; Don't use backquote here; we don't want backquote to get loaded
+ ;; just because of loading this file.
+ ;; Don't refer to mail-address-field-regexp here;
+ ;; that confuses some things such as cus-dep.el.
+ (cons '("^\\(Resent-\\)?\\(To\\|From\\|CC\\|BCC\\|Reply-to\\):"
+ . (mail-get-names pattern))
+ '(("Newsgroups:" . (if (boundp 'gnus-active-hashtb)
+ gnus-active-hashtb
+ (if (boundp news-group-article-assoc)
+ news-group-article-assoc)))
+ ("Followup-To:" . (mail-sentto-newsgroups))
+ ;;("Distribution:" ???)
+ ))
+ "*Alist of header field and expression to return alist for completion.
+The expression may reference the variable `pattern'
+which will hold the string being completed.
+If not on matching header, `mail-complete-function' gets called instead."
+ :type 'alist
+ :group 'mailalias)
+(put 'mail-complete-alist 'risky-local-variable t)
+
+;;;###autoload
+(defcustom mail-complete-style 'angles
+ "*Specifies how \\[mail-complete] formats the full name when it completes.
+If `nil', they contain just the return address like:
+ king@grassland.com
+If `parens', they look like:
+ king@grassland.com (Elvis Parsley)
+If `angles', they look like:
+ Elvis Parsley <king@grassland.com>"
+ :type '(choice (const angles) (const parens) (const nil))
+ :group 'mailalias)
+
+(defcustom mail-complete-function 'ispell-complete-word
+ "*Function to call when completing outside `mail-complete-alist'-header."
+ :type '(choice function (const nil))
+ :group 'mailalias)
+
+(defcustom mail-directory-function nil
+ "*Function to get completions from directory service or nil for none.
+See `mail-directory-requery'."
+ :type '(choice function (const nil))
+ :group 'mailalias)
+
+;; This is for when the directory is huge, or changes frequently.
+(defcustom mail-directory-requery nil
+ "*When non-nil call `mail-directory-function' for each completion.
+In that case, one argument gets passed to the function, the partial string
+entered so far."
+ :type 'boolean
+ :group 'mailalias)
+
+(defcustom mail-directory-process nil
+ "*Shell command to get the list of names from a mail directory.
+This value is used when the value of `mail-directory-function'
+is `mail-directory-process'. The value should be a list
+of the form (COMMAND ARG ...), where each of the list elements
+is evaluated. When `mail-directory-requery' is non-nil, during
+evaluation of these elements, the variable `pattern' contains
+the partial input being completed.
+
+The value might look like this:
+
+ '(remote-shell-program \"HOST\" \"-nl\" \"USER\" \"COMMAND\")
+
+or like this:
+
+ '(remote-shell-program \"HOST\" \"-n\" \"COMMAND '^\" pattern \"'\")"
+ :type 'sexp
+ :group 'mailalias)
+(put 'mail-directory-process 'risky-local-variable t)
+
+(defcustom mail-directory-stream nil
+ "*List of (HOST SERVICE) for stream connection to mail directory."
+ :type 'sexp
+ :group 'mailalias)
+(put 'mail-directory-stream 'risky-local-variable t)
+
+(defcustom mail-directory-parser nil
+ "*How to interpret the output of `mail-directory-function'.
+Three types of values are possible:
+
+ - nil means to gather each line as one name
+ - regexp means first \\(grouping\\) in successive matches is name
+ - function called at beginning of buffer that returns an alist of names"
+ :type '(choice (const nil) regexp function)
+ :group 'mailalias)
+(put 'mail-directory-parser 'risky-local-variable t)
+
+;; Internal variables.
+
+(defvar mail-names t
+ "Alist of local users, aliases and directory entries as available.
+Elements have the form (MAILNAME) or (MAILNAME . FULLNAME).
+If the value means t, it means the real value should be calculated
+for the next use. this is used in `mail-complete'.")
+
+(defvar mail-local-names t
+ "Alist of local users.
+When t this still needs to be initialized.")
+\f
+
;; Called from sendmail-send-it, or similar functions,
;; only if some mail aliases are defined.
+;;;###autoload
(defun expand-mail-aliases (beg end &optional exclude)
"Expand all mail aliases in suitable header fields found between BEG and END.
+If interactive, expand in header fields.
Suitable header fields are `To', `From', `CC' and `BCC', `Reply-to', and
their `Resent-' variants.
Optional second arg EXCLUDE may be a regular expression defining text to be
removed from alias expansions."
- (sendmail-synch-aliases)
- (if (eq mail-aliases t)
- (progn (setq mail-aliases nil) (build-mail-aliases)))
- (goto-char beg)
- (setq end (set-marker (make-marker) end))
- (let ((case-fold-search nil))
- (while (let ((case-fold-search t))
- (re-search-forward "^\\(Resent-\\)?\\(To\\|From\\|CC\\|BCC\\|Reply-to\\):" end t))
- (skip-chars-forward " \t")
- (let ((beg1 (point))
- end1 pos epos seplen
- ;; DISABLED-ALIASES records aliases temporarily disabled
- ;; while we scan text that resulted from expanding those aliases.
- ;; Each element is (ALIAS . TILL-WHEN), where TILL-WHEN
- ;; is where to reenable the alias (expressed as number of chars
- ;; counting from END1).
- (disabled-aliases nil))
- (re-search-forward "^[^ \t]" end 'move)
- (beginning-of-line)
- (skip-chars-backward " \t\n")
- (setq end1 (point-marker))
- (goto-char beg1)
- (while (< (point) end1)
- (setq pos (point))
- ;; Reenable any aliases which were disabled for ranges
- ;; that we have passed out of.
- (while (and disabled-aliases (> pos (- end1 (cdr (car disabled-aliases)))))
- (setq disabled-aliases (cdr disabled-aliases)))
- ;; EPOS gets position of end of next name;
- ;; SEPLEN gets length of whitespace&separator that follows it.
- (if (re-search-forward "[ \t]*[\n,][ \t]*" end1 t)
- (setq epos (match-beginning 0)
- seplen (- (point) epos))
- (setq epos (marker-position end1) seplen 0))
- (let (translation
- (string (buffer-substring-no-properties pos epos)))
- (if (and (not (assoc string disabled-aliases))
- (setq translation
- (cdr (assoc string mail-aliases))))
- (progn
- ;; This name is an alias. Disable it.
- (setq disabled-aliases (cons (cons string (- end1 epos))
- disabled-aliases))
- ;; Replace the alias with its expansion
- ;; then rescan the expansion for more aliases.
- (goto-char pos)
- (insert translation)
- (if exclude
- (let ((regexp
- (concat "\\b\\(" exclude "\\)\\b"))
+ (interactive
+ (save-excursion
+ (list (goto-char (point-min))
+ (mail-header-end))))
+ (sendmail-sync-aliases)
+ (when (eq mail-aliases t)
+ (setq mail-aliases nil)
+ (build-mail-aliases))
+ (save-excursion
+ (goto-char beg)
+ (setq end (set-marker (make-marker) end))
+ (let ((case-fold-search nil))
+ (while (let ((case-fold-search t))
+ (re-search-forward mail-address-field-regexp end t))
+ (skip-chars-forward " \t")
+ (let ((beg1 (point))
+ end1 pos epos seplen
+ ;; DISABLED-ALIASES records aliases temporarily disabled
+ ;; while we scan text that resulted from expanding those aliases.
+ ;; Each element is (ALIAS . TILL-WHEN), where TILL-WHEN
+ ;; is where to reenable the alias (expressed as number of chars
+ ;; counting from END1).
+ (disabled-aliases nil))
+ (re-search-forward "^[^ \t]" end 'move)
+ (beginning-of-line)
+ (skip-chars-backward " \t\n")
+ (setq end1 (point-marker))
+ (goto-char beg1)
+ (while (< (point) end1)
+ (setq pos (point))
+ ;; Reenable any aliases which were disabled for ranges
+ ;; that we have passed out of.
+ (while (and disabled-aliases
+ (> pos (- end1 (cdr (car disabled-aliases)))))
+ (setq disabled-aliases (cdr disabled-aliases)))
+ ;; EPOS gets position of end of next name;
+ ;; SEPLEN gets length of whitespace&separator that follows it.
+ (if (re-search-forward "[ \t]*[\n,][ \t]*" end1 t)
+ (setq epos (match-beginning 0)
+ seplen (- (point) epos))
+ (setq epos (marker-position end1) seplen 0))
+ (let ((string (buffer-substring-no-properties pos epos))
+ translation)
+ (if (and (not (assoc string disabled-aliases))
+ (setq translation (cdr (assoc string mail-aliases))))
+ (progn
+ ;; This name is an alias. Disable it.
+ (setq disabled-aliases (cons (cons string (- end1 epos))
+ disabled-aliases))
+ ;; Replace the alias with its expansion
+ ;; then rescan the expansion for more aliases.
+ (goto-char pos)
+ (insert translation)
+ (when exclude
+ (let ((regexp (concat "\\b\\(" exclude "\\)\\b"))
(end (point-marker)))
(goto-char pos)
(while (re-search-forward regexp end t)
(replace-match ""))
(goto-char end)))
- (delete-region (point) (+ (point) (- epos pos)))
- (goto-char pos))
- ;; Name is not an alias. Skip to start of next name.
- (goto-char epos)
- (forward-char seplen))))
- (set-marker end1 nil)))
- (set-marker end nil)))
+ (delete-region (point) (+ (point) (- epos pos)))
+ (goto-char pos))
+ ;; Name is not an alias. Skip to start of next name.
+ (goto-char epos)
+ (forward-char seplen))))
+ (set-marker end1 nil)))
+ (set-marker end nil))))
;; Called by mail-setup, or similar functions, only if the file specified
;; by mail-personal-alias-file (usually `~/.mailrc') exists.
"Read mail aliases from personal aliases file and set `mail-aliases'.
By default, this is the file specified by `mail-personal-alias-file'."
(setq file (expand-file-name (or file mail-personal-alias-file)))
+ ;; In case mail-aliases is t, make sure define-mail-alias
+ ;; does not recursively call build-mail-aliases.
+ (setq mail-aliases nil)
(let ((buffer nil)
(obuf (current-buffer)))
(unwind-protect
(progn
- (setq buffer (generate-new-buffer "mailrc"))
- (buffer-disable-undo buffer)
+ (setq buffer (generate-new-buffer " mailrc"))
(set-buffer buffer)
(while file
(cond ((get-file-buffer file)
(t (setq file nil))))
(goto-char (point-min))
(while (re-search-forward
- "^\\(a\\|alias\\|g\\|group\\)[ \t]+\\([^ \t]+\\)" nil t)
+ "^\\(a\\|alias\\|g\\|group\\)[ \t]+\\([^ \t\n]+\\)" nil t)
(let* ((name (match-string 2))
- (start (progn (skip-chars-forward " \t") (point))))
+ (start (progn (skip-chars-forward " \t") (point)))
+ value)
(end-of-line)
- (define-mail-alias
- name
- (buffer-substring-no-properties start (point))
- t)))
+ (setq value (buffer-substring-no-properties start (point)))
+ (unless (equal value "")
+ (define-mail-alias name value t))))
mail-aliases)
(if buffer (kill-buffer buffer))
(set-buffer obuf))))
This means that sending a message to NAME will actually send to DEFINITION.
Normally, the addresses in DEFINITION must be separated by commas.
-If FROM-MAILRC-FILE is non-nil, then addresses in DEFINITION
+If FROM-MAILRC-FILE is non-nil, then addresses in DEFINITION
can be separated by spaces; an address can contain spaces
if it is quoted with double-quotes."
(interactive "sDefine mail alias: \nsDefine %s as mail alias for: ")
;; Read the defaults first, if we have not done so.
- (sendmail-synch-aliases)
+ ;; But not if we are doing that already right now.
+ (unless from-mailrc-file
+ (sendmail-sync-aliases))
(if (eq mail-aliases t)
(progn
(setq mail-aliases nil)
;; If DEFINITION is null string, avoid looping even once.
(start (and (not (equal definition "")) 0))
(L (length definition))
+ convert-backslash
end tem)
(while start
+ (setq convert-backslash nil)
;; If we're reading from the mailrc file, then addresses are delimited
;; by spaces, and addresses with embedded spaces must be surrounded by
;; double-quotes. Otherwise, addresses are separated by commas.
(if from-mailrc-file
(if (eq ?\" (aref definition start))
- (setq start (1+ start)
- end (string-match "\"[ \t,]*" definition start))
+ ;; The following test on `found' compensates for a bug
+ ;; in match-end, which does not return nil when match
+ ;; failed.
+ (let ((found (string-match "[^\\]\\(\\([\\][\\]\\)*\\)\"[ \t,]*"
+ definition start)))
+ (setq start (1+ start)
+ end (and found (match-end 1))
+ convert-backslash t))
(setq end (string-match "[ \t,]+" definition start)))
(setq end (string-match "[ \t\n,]*,[ \t\n,]*" definition start)))
- (setq result (cons (substring definition start end) result))
- (setq start (and end
- (/= (match-end 0) L)
- (match-end 0))))
+ (let ((temp (substring definition start end))
+ (pos 0))
+ (setq start (and end
+ (/= (match-end 0) L)
+ (match-end 0)))
+ (if convert-backslash
+ (while (string-match "[\\]" temp pos)
+ (setq temp (replace-match "" t t temp))
+ (if start
+ (setq start (1- start)))
+ (setq pos (match-end 0))))
+ (setq result (cons temp result))))
(setq definition (mapconcat (function identity)
(nreverse result)
", "))
(setq tem (assoc name mail-aliases))
(if tem
(rplacd tem definition)
- (setq mail-aliases (cons (cons name definition) mail-aliases)))))
+ (setq mail-aliases (cons (cons name definition) mail-aliases)
+ mail-names t))))
+
+;;;###autoload
+(defun mail-complete (arg)
+ "Perform completion on header field or word preceding point.
+Completable headers are according to `mail-complete-alist'. If none matches
+current header, calls `mail-complete-function' and passes prefix arg if any."
+ (interactive "P")
+ ;; Read the defaults first, if we have not done so.
+ (sendmail-sync-aliases)
+ (if (eq mail-aliases t)
+ (progn
+ (setq mail-aliases nil)
+ (if (file-exists-p mail-personal-alias-file)
+ (build-mail-aliases))))
+ (let ((list mail-complete-alist))
+ (if (and (< 0 (mail-header-end))
+ (save-excursion
+ (if (re-search-backward "^[^\t]" nil t)
+ (while list
+ (if (looking-at (car (car list)))
+ (setq arg (cdr (car list))
+ list ())
+ (setq list (cdr list)))))
+ arg))
+ (let* ((end (point))
+ (beg (save-excursion
+ (skip-chars-backward "^ \t<,:")
+ (point)))
+ (pattern (buffer-substring beg end))
+ completion)
+ (setq list (eval arg)
+ completion (try-completion pattern list))
+ (cond ((eq completion t))
+ ((null completion)
+ (message "Can't find completion for \"%s\"" pattern)
+ (ding))
+ ((not (string= pattern completion))
+ (delete-region beg end)
+ (let ((alist-elt (assoc completion mail-names)))
+ (if (cdr alist-elt)
+ (cond ((eq mail-complete-style 'parens)
+ (insert completion " (" (cdr alist-elt) ")"))
+ ((eq mail-complete-style 'angles)
+ (insert (cdr alist-elt) " <" completion ">"))
+ (t
+ (insert completion)))
+ (insert completion))))
+ (t
+ (message "Making completion list...")
+ (with-output-to-temp-buffer "*Completions*"
+ (display-completion-list
+ (all-completions pattern list)))
+ (message "Making completion list...%s" "done"))))
+ (funcall mail-complete-function arg))))
+
+(defun mail-get-names (pattern)
+ "Fetch local users and global mail addresses for completion.
+Consults `/etc/passwd' and a directory service if one is set up via
+`mail-directory-function'.
+PATTERN is the string we want to complete."
+ (if (eq mail-local-names t)
+ (save-excursion
+ (set-buffer (generate-new-buffer " passwd"))
+ (let ((files mail-passwd-files))
+ (while files
+ (insert-file-contents (car files) nil nil nil t)
+ (setq files (cdr files))))
+ (if mail-passwd-command
+ (call-process shell-file-name nil t nil
+ shell-command-switch mail-passwd-command))
+ (beginning-of-buffer)
+ (setq mail-local-names nil)
+ (while (not (eobp))
+ ;;Recognize lines like
+ ;; nobody:*:65534:65534::/:
+ ;; +demo::::::/bin/csh
+ ;; +ethanb
+ ;;while skipping
+ ;; +@SOFTWARE
+ ;; The second \(...\) matches the user id.
+ (if (looking-at "\\+?\\([^:@\n+]+\\):[^:\n]*:\\([^\n:]*\\):")
+ (add-to-list 'mail-local-names
+ (cons (match-string 1)
+ (user-full-name
+ (string-to-int (match-string 2))))))
+ (beginning-of-line 2))
+ (kill-buffer (current-buffer))))
+ (if (or (eq mail-names t)
+ (eq mail-directory-names t))
+ (let (directory)
+ (and mail-directory-function
+ (eq mail-directory-names t)
+ (setq directory
+ (mail-directory (if mail-directory-requery pattern))))
+ (or mail-directory-requery
+ (setq mail-directory-names directory))
+ (if (or directory
+ (eq mail-names t))
+ (setq mail-names
+ (sort (append (if (consp mail-aliases)
+ (mapcar
+ (function (lambda (a) (list (car a))))
+ mail-aliases))
+ (if (consp mail-local-names)
+ mail-local-names)
+ (or directory mail-directory-names))
+ (lambda (a b)
+ ;; should cache downcased strings
+ (string< (downcase (car a))
+ (downcase (car b)))))))))
+ mail-names)
+
+
+(defun mail-directory (pattern)
+ "Call directory to get names matching PATTERN or all if nil.
+Calls `mail-directory-function' and applies `mail-directory-parser' to output."
+ (save-excursion
+ (message "Querying directory...")
+ (set-buffer (generate-new-buffer " *mail-directory*"))
+ (funcall mail-directory-function pattern)
+ (goto-char 1)
+ (let (directory)
+ (if (stringp mail-directory-parser)
+ (while (re-search-forward mail-directory-parser nil t)
+ (setq directory
+ (cons (match-string 1) directory)))
+ (if mail-directory-parser
+ (setq directory (funcall mail-directory-parser))
+ (while (not (eobp))
+ (setq directory
+ (cons (buffer-substring (point)
+ (progn
+ (forward-line)
+ (if (bolp)
+ (1- (point))
+ (point))))
+ directory)))))
+ (kill-buffer (current-buffer))
+ (message "Querying directory...done")
+ directory)))
+
+
+(defun mail-directory-process (pattern)
+ "Run a shell command to output names in directory.
+See `mail-directory-process'."
+ (apply 'call-process (eval (car mail-directory-process)) nil t nil
+ (mapcar 'eval (cdr mail-directory-process))))
+
+;; This should handle a dialog. Currently expects port to spit out names.
+(defun mail-directory-stream (pattern)
+ "Open a stream to retrieve names in directory.
+See `mail-directory-stream'."
+ (let (mailalias-done)
+ (set-process-sentinel
+ (apply 'open-network-stream "mailalias" (current-buffer)
+ mail-directory-stream)
+ (lambda (x y)
+ (setq mailalias-done t)))
+ (while (not mailalias-done)
+ (sit-for .1))))
+
+(defun mail-sentto-newsgroups ()
+ "Return all entries from Newsgroups: header as completion alist."
+ (save-excursion
+ (if (mail-position-on-field "newsgroups" t)
+ (let ((point (point))
+ list)
+ (while (< (skip-chars-backward "^:, \t\n") 0)
+ (setq list `((,(buffer-substring (point) point))
+ ,@list))
+ (skip-chars-backward ", \t\n")
+ (setq point (point)))
+ list))))
(provide 'mailalias)