X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/7229064dbf9dfcb873824a6f2a9af0bdb112b550..ac84042c630254697a5244b11bef4375579bbf3f:/lisp/mail/mail-utils.el diff --git a/lisp/mail/mail-utils.el b/lisp/mail/mail-utils.el index cdfd6ff0b6..96a57b38f0 100644 --- a/lisp/mail/mail-utils.el +++ b/lisp/mail/mail-utils.el @@ -1,11 +1,15 @@ -;; Utility functions used both by rmail and rnews -;; Copyright (C) 1985 Free Software Foundation, Inc. +;;; mail-utils.el --- utility functions used both by rmail and rnews + +;; Copyright (C) 1985, 2001 Free Software Foundation, Inc. + +;; Maintainer: FSF +;; Keywords: mail, news ;; This file is 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 1, or (at your option) +;; 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, @@ -14,17 +18,39 @@ ;; 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: + +;; Utility functions for mail and netnews handling. These handle fine +;; points of header parsing. + +;;; Code: + +;;; We require lisp-mode to make sure that lisp-mode-syntax-table has +;;; been initialized. +(require 'lisp-mode) -(provide 'mail-utils) - ;;;###autoload -(defvar mail-use-rfc822 nil - "*If non-nil, use a full, hairy RFC822 parser on mail addresses. +(defcustom mail-use-rfc822 nil "\ +*If non-nil, use a full, hairy RFC822 parser on mail addresses. Otherwise, (the default) use a smaller, somewhat faster, and -often correct parser.") +often correct parser." + :type 'boolean + :group 'mail) + +;; Returns t if file FILE is an Rmail file. +;;;###autoload +(defun mail-file-babyl-p (file) + (let ((buf (generate-new-buffer " *rmail-file-p*"))) + (unwind-protect + (save-excursion + (set-buffer buf) + (insert-file-contents file nil 0 100) + (looking-at "BABYL OPTIONS:")) + (kill-buffer buf)))) (defun mail-string-delete (string start end) "Returns a string containing all of STRING except the part @@ -33,134 +59,260 @@ from START (inclusive) to END (exclusive)." (concat (substring string 0 start) (substring string end nil)))) +;;;###autoload +(defun mail-quote-printable (string &optional wrapper) + "Convert a string to the \"quoted printable\" Q encoding. +If the optional argument WRAPPER is non-nil, +we add the wrapper characters =?ISO-8859-1?Q?....?=." + (let ((i 0) (result "")) + (save-match-data + (while (string-match "[?=\"\200-\377]" string i) + (setq result + (concat result (substring string i (match-beginning 0)) + (upcase (format "=%02x" + (aref string (match-beginning 0)))))) + (setq i (match-end 0))) + (if wrapper + (concat "=?ISO-8859-1?Q?" + result (substring string i) + "?=") + (concat result (substring string i)))))) + +(defun mail-unquote-printable-hexdigit (char) + (setq char (upcase char)) + (if (>= char ?A) + (+ (- char ?A) 10) + (- char ?0))) + +;;;###autoload +(defun mail-unquote-printable (string &optional wrapper) + "Undo the \"quoted printable\" encoding. +If the optional argument WRAPPER is non-nil, +we expect to find and remove the wrapper characters =?ISO-8859-1?Q?....?=." + (save-match-data + (and wrapper + (string-match "\\`=\\?ISO-8859-1\\?Q\\?\\([^?]*\\)\\?" string) + (setq string (match-string 1 string))) + (let ((i 0) strings) + (while (string-match "=\\(..\\|\n\\)" string i) + (setq strings (cons (substring string i (match-beginning 0)) strings)) + (unless (= (aref string (match-beginning 1)) ?\n) + (setq strings + (cons (make-string 1 + (+ (* 16 (mail-unquote-printable-hexdigit + (aref string (match-beginning 1)))) + (mail-unquote-printable-hexdigit + (aref string (1+ (match-beginning 1)))))) + strings))) + (setq i (match-end 0))) + (apply 'concat (nreverse (cons (substring string i) strings)))))) + +;;;###autoload +(defun mail-unquote-printable-region (beg end &optional wrapper noerror) + "Undo the \"quoted printable\" encoding in buffer from BEG to END. +If the optional argument WRAPPER is non-nil, +we expect to find and remove the wrapper characters =?ISO-8859-1?Q?....?=. +If NOERROR is non-nil, return t if successful." + (interactive "r\nP") + (let (failed) + (save-match-data + (save-excursion + (save-restriction + (narrow-to-region beg end) + (goto-char (point-min)) + (when (and wrapper + (looking-at "\\`=\\?ISO-8859-1\\?Q\\?\\([^?]*\\)\\?")) + (delete-region (match-end 1) end) + (delete-region (point) (match-beginning 1))) + (while (re-search-forward "=\\(\\([0-9A-F][0-9A-F]\\)\\|[=\n]\\|..\\)" nil t) + (goto-char (match-end 0)) + (cond ((= (char-after (match-beginning 1)) ?\n) + (replace-match "")) + ((= (char-after (match-beginning 1)) ?=) + (replace-match "=")) + ((match-beginning 2) + (replace-match + (make-string 1 + (+ (* 16 (mail-unquote-printable-hexdigit + (char-after (match-beginning 2)))) + (mail-unquote-printable-hexdigit + (char-after (1+ (match-beginning 2)))))) + t t)) + (noerror + (setq failed t)) + (t + (error "Malformed MIME quoted-printable message")))) + (not failed)))))) + +(eval-when-compile (require 'rfc822)) + (defun mail-strip-quoted-names (address) "Delete comments and quoted strings in an address list ADDRESS. Also delete leading/trailing whitespace and replace FOO with just BAR. Return a modified address list." - (if mail-use-rfc822 - (progn (require 'rfc822) - (mapconcat 'identity (rfc822-addresses address) ", ")) - (let (pos) - (string-match "\\`[ \t\n]*" address) - ;; strip surrounding whitespace - (setq address (substring address - (match-end 0) - (string-match "[ \t\n]*\\'" address - (match-end 0)))) - - ;; Detect nested comments. - (if (string-match "[ \t]*(\\([^)\"\\]\\|\\\\.\\|\\\\\n\\)*(" address) - ;; Strip nested comments. - (save-excursion - (set-buffer (get-buffer-create " *temp*")) - (erase-buffer) - (insert address) - (set-syntax-table lisp-mode-syntax-table) - (goto-char 1) - (while (search-forward "(" nil t) - (forward-char -1) - (skip-chars-backward " \t") - (delete-region (point) - (save-excursion (forward-sexp 1) (point)))) - (setq address (buffer-string)) - (erase-buffer)) - ;; Strip non-nested comments an easier way. - (while (setq pos (string-match - ;; This doesn't hack rfc822 nested comments - ;; `(xyzzy (foo) whinge)' properly. Big deal. - "[ \t]*(\\([^)\"\\]\\|\\\\.\\|\\\\\n\\)*)" - address)) - (setq address - (mail-string-delete address - pos (match-end 0))))) - - ;; strip `quoted' names (This is supposed to hack `"Foo Bar" ') - (setq pos 0) - (while (setq pos (string-match - "[ \t]*\"\\([^\"\\]\\|\\\\.\\|\\\\\n\\)*\"[ \t\n]*" - address pos)) - ;; If the next thing is "@", we have "foo bar"@host. Leave it. - (if (and (> (length address) (match-end 0)) - (= (aref address (match-end 0)) ?@)) - (setq pos (match-end 0)) - (setq address - (mail-string-delete address - pos (match-end 0))))) - ;; Retain only part of address in <> delims, if there is such a thing. - (while (setq pos (string-match "\\(,\\|\\`\\)[^,]*<\\([^>,]*>\\)" - address)) - (let ((junk-beg (match-end 1)) - (junk-end (match-beginning 2)) - (close (match-end 0))) - (setq address (mail-string-delete address (1- close) close)) - (setq address (mail-string-delete address junk-beg junk-end)))) - address))) - -(or (and (boundp 'rmail-default-dont-reply-to-names) - (not (null rmail-default-dont-reply-to-names))) - (setq rmail-default-dont-reply-to-names "info-")) - -; rmail-dont-reply-to-names is defined in loaddefs -(defun rmail-dont-reply-to (userids) - "Returns string of mail addresses USERIDS sans any recipients -that start with matches for `rmail-dont-reply-to-names'. -Usenet paths ending in an element that matches are removed also." + (if (null address) + nil + (if mail-use-rfc822 + (progn (require 'rfc822) + (mapconcat 'identity (rfc822-addresses address) ", ")) + (let (pos) + + ;; Detect nested comments. + (if (string-match "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*(" address) + ;; Strip nested comments. + (with-current-buffer (get-buffer-create " *temp*") + (erase-buffer) + (insert address) + (set-syntax-table lisp-mode-syntax-table) + (goto-char 1) + (while (search-forward "(" nil t) + (forward-char -1) + (skip-chars-backward " \t") + (delete-region (point) + (save-excursion + (condition-case () + (forward-sexp 1) + (error (goto-char (point-max)))) + (point)))) + (setq address (buffer-string)) + (erase-buffer)) + ;; Strip non-nested comments an easier way. + (while (setq pos (string-match + ;; This doesn't hack rfc822 nested comments + ;; `(xyzzy (foo) whinge)' properly. Big deal. + "[ \t]*(\\([^)\\]\\|\\\\.\\|\\\\\n\\)*)" + address)) + (setq address (replace-match "" nil nil address 0)))) + + ;; strip surrounding whitespace + (string-match "\\`[ \t\n]*" address) + (setq address (substring address + (match-end 0) + (string-match "[ \t\n]*\\'" address + (match-end 0)))) + + ;; strip `quoted' names (This is supposed to hack `"Foo Bar" ') + (setq pos 0) + (while (setq pos (string-match + "\\([ \t]?\\)\\([ \t]*\"\\([^\"\\]\\|\\\\.\\|\\\\\n\\)*\"[ \t\n]*\\)" + address pos)) + ;; If the next thing is "@", we have "foo bar"@host. Leave it. + (if (and (> (length address) (match-end 0)) + (= (aref address (match-end 0)) ?@)) + (setq pos (match-end 0)) + ;; Otherwise discard the "..." part. + (setq address (replace-match "" nil nil address 2)))) + ;; If this address contains <...>, replace it with just + ;; the part between the <...>. + (while (setq pos (string-match "\\(,\\s-*\\|\\`\\)\\([^,]*<\\([^>,:]*\\)>[^,]*\\)\\(\\s-*,\\|\\'\\)" + address)) + (setq address (replace-match (match-string 3 address) + nil 'literal address 2))) + address)))) + +;;; The following piece of ugliness is legacy code. The name was an +;;; unfortunate choice --- a flagrant violation of the Emacs Lisp +;;; coding conventions. `mail-dont-reply-to' would have been +;;; infinitely better. Also, `rmail-dont-reply-to-names' might have +;;; been better named `mail-dont-reply-to-names' and sourced from this +;;; file instead of in rmail.el. Yuck. -pmr +(defun rmail-dont-reply-to (destinations) + "Prune addresses from DESTINATIONS, a list of recipient addresses. +All addresses matching `rmail-dont-reply-to-names' are removed from +the comma-separated list. The pruned list is returned." (if (null rmail-dont-reply-to-names) (setq rmail-dont-reply-to-names (concat (if rmail-default-dont-reply-to-names (concat rmail-default-dont-reply-to-names "\\|") - "") - (concat (regexp-quote (user-original-login-name)) - "\\>")))) - (let ((match (concat "\\(^\\|,\\)[ \t\n]*\\([^,\n]*!\\|\\)\\(" - rmail-dont-reply-to-names - "\\)")) - (case-fold-search t) - pos epos) - (while (setq pos (string-match match userids)) - (if (> pos 0) (setq pos (1+ pos))) - (setq epos - (if (string-match "[ \t\n,]+" userids (match-end 0)) - (match-end 0) - (length userids))) - (setq userids - (mail-string-delete - userids pos epos))) - ;; get rid of any trailing commas - (if (setq pos (string-match "[ ,\t\n]*\\'" userids)) - (setq userids (substring userids 0 pos))) - ;; remove leading spaces. they bother me. - (if (string-match "\\s *" userids) - (substring userids (match-end 0)) - userids))) + "") + (if (and user-mail-address + (not (equal user-mail-address user-login-name))) + ;; Anchor the login name and email address so + ;; that we don't match substrings: if the + ;; login name is "foo", we shouldn't match + ;; "barfoo@baz.com". + (concat "\\`" + (regexp-quote user-mail-address) + "\\'\\|") + "") + (concat "\\`" (regexp-quote user-login-name) "@")))) + ;; Split up DESTINATIONS and match each element separately. + (let ((start-pos 0) (cur-pos 0) + (case-fold-search t)) + (while start-pos + (setq cur-pos (string-match "[,\"]" destinations cur-pos)) + (if (and cur-pos (equal (match-string 0 destinations) "\"")) + ;; Search for matching quote. + (let ((next-pos (string-match "\"" destinations (1+ cur-pos)))) + (if next-pos + (setq cur-pos (1+ next-pos)) + ;; If the open-quote has no close-quote, + ;; delete the open-quote to get something well-defined. + ;; This case is not valid, but it can happen if things + ;; are weird elsewhere. + (setq destinations (concat (substring destinations 0 cur-pos) + (substring destinations (1+ cur-pos)))) + (setq cur-pos start-pos))) + (let* ((address (substring destinations start-pos cur-pos)) + (naked-address (mail-strip-quoted-names address))) + (if (string-match rmail-dont-reply-to-names naked-address) + (setq destinations (concat (substring destinations 0 start-pos) + (and cur-pos (substring destinations + (1+ cur-pos)))) + cur-pos start-pos) + (setq cur-pos (and cur-pos (1+ cur-pos)) + start-pos cur-pos)))))) + ;; get rid of any trailing commas + (let ((pos (string-match "[ ,\t\n]*\\'" destinations))) + (if pos + (setq destinations (substring destinations 0 pos)))) + ;; remove leading spaces. they bother me. + (if (string-match "\\(\\s \\|,\\)*" destinations) + (substring destinations (match-end 0)) + destinations)) + -(defun mail-fetch-field (field-name &optional last all) - "Return the value of the header field FIELD-NAME. -The buffer is expected to be narrowed to just the headers of the message. -If second arg LAST is non-nil, use the last such field if there are several. -If third arg ALL is non-nil, concatenate all such fields with commas between." +;;;###autoload +(defun mail-fetch-field (field-name &optional last all list) + "Return the value of the header field whose type is FIELD-NAME. +The buffer is expected to be narrowed to just the header of the message. +If second arg LAST is non-nil, use the last field of type FIELD-NAME. +If third arg ALL is non-nil, concatenate all such fields with commas between. +If 4th arg LIST is non-nil, return a list of all such fields." (save-excursion (goto-char (point-min)) (let ((case-fold-search t) (name (concat "^" (regexp-quote field-name) "[ \t]*:[ \t]*"))) - (goto-char (point-min)) - (if all - (let ((value "")) + (if (or all list) + (let ((value (if all ""))) (while (re-search-forward name nil t) (let ((opoint (point))) (while (progn (forward-line 1) (looking-at "[ \t]"))) - (setq value (concat value - (if (string= value "") "" ", ") - (buffer-substring opoint (1- (point))))))) - (and (not (string= value "")) value)) + ;; Back up over newline, then trailing spaces or tabs + (forward-char -1) + (skip-chars-backward " \t" opoint) + (if list + (setq value (cons (buffer-substring-no-properties + opoint (point)) + value)) + (setq value (concat value + (if (string= value "") "" ", ") + (buffer-substring-no-properties + opoint (point))))))) + (if list + value + (and (not (string= value "")) value))) (if (re-search-forward name nil t) (progn (if last (while (re-search-forward name nil t))) (let ((opoint (point))) (while (progn (forward-line 1) (looking-at "[ \t]"))) - (buffer-substring opoint (1- (point)))))))))) + ;; Back up over newline, then trailing spaces or tabs + (forward-char -1) + (skip-chars-backward " \t" opoint) + (buffer-substring-no-properties opoint (point))))))))) ;; Parse a list of tokens separated by commas. ;; It runs from point to the end of the visible part of the buffer. @@ -169,16 +321,16 @@ If third arg ALL is non-nil, concatenate all such fields with commas between." (defun mail-parse-comma-list () (let (accumulated beg) - (skip-chars-forward " ") + (skip-chars-forward " \t\n") (while (not (eobp)) (setq beg (point)) (skip-chars-forward "^,") - (skip-chars-backward " ") + (skip-chars-backward " \t\n") (setq accumulated - (cons (buffer-substring beg (point)) + (cons (buffer-substring-no-properties beg (point)) accumulated)) (skip-chars-forward "^,") - (skip-chars-forward ", ")) + (skip-chars-forward ", \t\n")) accumulated)) (defun mail-comma-list-regexp (labels) @@ -193,3 +345,23 @@ If third arg ALL is non-nil, concatenate all such fields with commas between." "\\|" (substring labels (match-end 0)))))) labels) + +(defun mail-rfc822-time-zone (time) + (let* ((sec (or (car (current-time-zone time)) 0)) + (absmin (/ (abs sec) 60))) + (format "%c%02d%02d" (if (< sec 0) ?- ?+) (/ absmin 60) (% absmin 60)))) + +(defun mail-rfc822-date () + (let* ((time (current-time)) + (s (current-time-string time))) + (string-match "[^ ]+ +\\([^ ]+\\) +\\([^ ]+\\) \\([^ ]+\\) \\([^ ]+\\)" s) + (concat (substring s (match-beginning 2) (match-end 2)) " " + (substring s (match-beginning 1) (match-end 1)) " " + (substring s (match-beginning 4) (match-end 4)) " " + (substring s (match-beginning 3) (match-end 3)) " " + (mail-rfc822-time-zone time)))) + +(provide 'mail-utils) + +;;; arch-tag: b24aec2f-fd65-4ceb-9e39-3cc2827036fd +;;; mail-utils.el ends here