(Fxw_color_values): Return 3-element list. Doc fix.
[emacs.git] / lisp / mail / undigest.el
blob2a0ea5ad549aea64d9a1f2b76796b5bb6f78639b
1 ;;; undigest.el --- digest-cracking support for the RMAIL mail reader
3 ;; Copyright (C) 1985, 1986, 1994, 1996, 2001, 2002, 2003, 2004, 2005,
4 ;; 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
6 ;; Maintainer: FSF
7 ;; Keywords: mail
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
24 ;;; Commentary:
26 ;; See Internet RFC 934 and RFC 1153.
27 ;; Also limited support for MIME digest encapsulation.
29 ;;; Code:
31 (require 'rmail)
33 (defcustom rmail-forward-separator-regex
34 "^----.*\\([Ff]orwarded\\|[Oo]riginal\\).*[Mm]essage"
35 "*Regexp to match the string that introduces forwarded messages.
36 This is not a header, but a string contained in the body of the message.
37 You may need to customize it for local needs."
38 :type 'regexp
39 :group 'rmail-headers)
42 (defconst rmail-digest-methods
43 '(rmail-digest-parse-mime
44 rmail-digest-parse-rfc1153strict
45 rmail-digest-parse-rfc1153sloppy
46 rmail-digest-parse-rfc934)
47 "List of digest parsing functions, first tried first.
49 These functions operate on the current narrowing, and take no argument.
50 A function returns nil if it cannot parse the digest. If it can, it
51 returns a list of cons pairs containing the start and end positions of
52 each undigestified message as markers.")
54 (defun rmail-digest-parse-mime ()
55 (goto-char (point-min))
56 (when (let ((head-end (progn (search-forward "\n\n" nil t) (point))))
57 (goto-char (point-min))
58 (and head-end ; FIXME always true
59 (re-search-forward
60 (concat
61 "^Content-type: multipart/digest;"
62 "\\s-* boundary=\"?\\([^\";\n]+\\)[\";\n]") head-end t)
63 (search-forward (match-string 1) nil t)))
64 ;; Ok, prolog separator found
65 (let ((start (make-marker))
66 (end (make-marker))
67 (separator (concat "\n--" (match-string 0) "\n\n"))
68 result)
69 (while (search-forward separator nil t)
70 (move-marker start (match-beginning 0))
71 (move-marker end (match-end 0))
72 (add-to-list 'result (cons (copy-marker start) (copy-marker end t))))
73 ;; Return the list of marker pairs
74 (nreverse result))))
76 (defun rmail-digest-parse-rfc1153strict ()
77 "Parse following strictly the method defined in RFC 1153.
78 See rmail-digest-methods."
79 (rmail-digest-rfc1153
80 "^-\\{70\\}\n\n"
81 "^\n-\\{30\\}\n\n"
82 "^\n-\\{30\\}\n\nEnd of .* Digest.*\n\\*\\{15,\\}\n+\'"))
84 (defun rmail-digest-parse-rfc1153sloppy ()
85 "Parse using the method defined in RFC 1153, allowing for some sloppiness.
86 See rmail-digest-methods."
87 (rmail-digest-rfc1153
88 "^-\\{55,\\}\n\n"
89 "^\n-\\{27,\\}\n\n"
90 ;; GNU Mailman knowingly (see comment at line 353 of ToDigest.py in
91 ;; Mailman source) produces non-conformant rfc 1153 digests, in that
92 ;; the trailer contains a "digest footer" like this:
93 ;; _______________________________________________
94 ;; <one or more lines of list blurb>
96 ;; End of Foo Digest...
97 ;; **************************************
98 "^\nEnd of"))
100 (defun rmail-digest-rfc1153 (prolog-sep message-sep trailer-sep)
101 (goto-char (point-min))
102 (when (re-search-forward prolog-sep nil t)
103 ;; Ok, prolog separator found
104 (let ((start (make-marker))
105 (end (make-marker))
106 separator result)
107 (move-marker start (match-beginning 0))
108 (move-marker end (match-end 0))
109 (setq result (list (cons (copy-marker start) (copy-marker end t))))
110 (when (re-search-forward message-sep nil t)
111 ;; Ok, at least one message separator found
112 (setq separator (match-string 0))
113 (when (re-search-forward trailer-sep nil t)
114 ;; Wonderful, we found a trailer, too. Now, go on splitting
115 ;; the digest into separate rmail messages
116 (goto-char (cdar result))
117 (while (search-forward separator nil t)
118 (move-marker start (match-beginning 0))
119 (move-marker end (match-end 0))
120 (add-to-list 'result
121 (cons (copy-marker start) (copy-marker end t))))
122 ;; Undo masking of separators inside digestified messages
123 (goto-char (point-min))
124 (while (search-forward
125 (replace-regexp-in-string "\n-" "\n " separator) nil t)
126 (replace-match separator))
127 ;; Return the list of marker pairs
128 (nreverse result))))))
130 (defun rmail-digest-parse-rfc934 ()
131 (goto-char (point-min))
132 (when (re-search-forward "^\n?-[^ ].*\n\n?" nil t)
133 ;; Message separator found
134 (let ((start (make-marker))
135 (end (make-marker))
136 (separator (match-string 0))
137 result)
138 (goto-char (point-min))
139 (while (search-forward separator nil t)
140 (move-marker start (match-beginning 0))
141 (move-marker end (match-end 0))
142 (add-to-list 'result (cons (copy-marker start) (copy-marker end t))))
143 ;; Undo masking of separators inside digestified messages
144 (goto-char (point-min))
145 (while (search-forward "\n- -" nil t)
146 (replace-match "\n-"))
147 ;; Return the list of marker pairs
148 (nreverse result))))
150 (declare-function rmail-update-summary "rmailsum" (&rest ignore))
152 ;;;###autoload
153 (defun undigestify-rmail-message ()
154 "Break up a digest message into its constituent messages.
155 Leaves original message, deleted, before the undigestified messages."
156 (interactive)
157 (set-buffer rmail-buffer)
158 (let ((buff (current-buffer))
159 (current rmail-current-message)
160 (msgbeg (rmail-msgbeg rmail-current-message))
161 (msgend (rmail-msgend rmail-current-message)))
162 (if (rmail-buffers-swapped-p) (set-buffer rmail-view-buffer))
163 (widen)
164 (let ((error t)
165 (buffer-read-only nil))
166 (goto-char msgend)
167 (let ((msg-copy (buffer-substring-no-properties msgbeg msgend)))
168 (narrow-to-region (point) (point))
169 (insert "\n" msg-copy))
170 (goto-char (point-min))
171 (unwind-protect
172 (progn
173 (let ((fill-prefix "")
174 (case-fold-search t)
175 digest-name fun-list sep-list start end)
176 (setq digest-name (mail-strip-quoted-names
177 (save-restriction
178 (search-forward "\n\n" nil 'move)
179 (narrow-to-region (point-min) (point))
180 (or (mail-fetch-field "Reply-To")
181 (mail-fetch-field "To")
182 (mail-fetch-field "Apparently-To")
183 (mail-fetch-field "From")))))
184 (unless digest-name
185 (error "Message is not a digest--bad header"))
186 (setq fun-list rmail-digest-methods)
187 (while (and fun-list
188 (null (setq sep-list (funcall (car fun-list)))))
189 (setq fun-list (cdr fun-list)))
190 (unless sep-list
191 (error "Message is not a digest--no messages found"))
192 ;; Split the digest into separate rmail messages.
193 (while sep-list
194 (setq start (caar sep-list)
195 end (cdar sep-list))
196 (delete-region start end)
197 (goto-char start)
198 (search-forward "\n\n" (caar (cdr sep-list)) 'move)
199 (save-restriction
200 (narrow-to-region end (point))
201 (goto-char (point-min))
202 (insert "\nFrom rmail@localhost " (current-time-string) "\n")
203 (save-excursion
204 (forward-line -1)
205 (rmail-add-mbox-headers))
206 (unless (mail-fetch-field "To")
207 (insert "To: " digest-name "\n")))
208 (set-marker start nil)
209 (set-marker end nil)
210 (setq sep-list (cdr sep-list))))
211 (setq error nil)
212 (message "Message successfully undigestified")
213 (set-buffer buff)
214 (rmail-swap-buffers-maybe)
215 (goto-char (point-max))
216 (rmail-set-message-counters)
217 (set-buffer-modified-p t)
218 (rmail-show-message current)
219 (rmail-delete-forward)
220 (if (rmail-summary-exists)
221 (rmail-select-summary (rmail-update-summary))))
222 (when error
223 (delete-region (point-min) (point-max))
224 (set-buffer buff)
225 (rmail-show-message current))))))
227 ;;;###autoload
228 (defun unforward-rmail-message ()
229 "Extract a forwarded message from the containing message.
230 This puts the forwarded message into a separate rmail message
231 following the containing message."
232 (interactive)
233 (set-buffer rmail-buffer)
234 (let ((buff (current-buffer))
235 (current rmail-current-message)
236 (beg (rmail-msgbeg rmail-current-message))
237 (msgend (rmail-msgend rmail-current-message))
238 (error t))
239 (unwind-protect
240 (progn
241 (if (rmail-buffers-swapped-p) (set-buffer rmail-view-buffer))
242 (widen)
243 (goto-char beg)
244 (search-forward "\n\n" msgend)
245 (narrow-to-region beg (point))
246 (let ((old-fwd-from (mail-fetch-field "Forwarded-From" nil nil t))
247 (old-fwd-date (mail-fetch-field "Forwarded-Date" nil nil t))
248 (fwd-from (mail-fetch-field "From"))
249 (fwd-date (mail-fetch-field "Date"))
250 (buffer-read-only nil)
251 prefix forward-msg end)
252 (widen)
253 (narrow-to-region beg msgend)
254 (cond ((re-search-forward rmail-forward-separator-regex nil t)
255 (forward-line 1)
256 (skip-chars-forward "\n")
257 (setq beg (point))
258 (setq end (if (re-search-forward "^----.*[^- \t\n]" nil t)
259 (match-beginning 0) (point-max)))
260 (setq forward-msg
261 (replace-regexp-in-string
262 "^- -" "-" (buffer-substring beg end))))
263 ((and (re-search-forward "^\\(> ?\\)[a-zA-Z-]+: .*\n" nil t)
264 (setq beg (match-beginning 0))
265 (setq prefix (match-string-no-properties 1))
266 (goto-char beg)
267 (looking-at (concat "\\(" prefix ".+\n\\)*"
268 prefix "Date: ."))
269 (looking-at (concat "\\(" prefix ".+\n\\)*"
270 prefix "From: .+\n"
271 "\\(" prefix ".+\n\\)*"
272 "\\(> ?\\)?\n" prefix)))
273 (re-search-forward "^[^>\n]" nil 'move)
274 (backward-char)
275 (skip-chars-backward " \t\n")
276 (forward-line 1)
277 (setq end (point))
278 (setq forward-msg
279 (replace-regexp-in-string
280 (if (string= prefix ">") "^>" "> ?")
281 "" (buffer-substring beg end))))
283 (error "No forwarded message found")))
284 (widen)
285 (goto-char msgend)
286 ;; Insert a fake From line.
287 ;; FIXME we could construct one using the From and Date headers
288 ;; of the forwarded message - is it worth it?
289 (insert "\n\nFrom rmail@localhost " (current-time-string) "\n")
290 (setq beg (point)) ; start of header
291 (while old-fwd-from
292 (insert "Forwarded-From: " (car old-fwd-from) "\n")
293 (insert "Forwarded-Date: " (car old-fwd-date) "\n")
294 (setq old-fwd-from (cdr old-fwd-from))
295 (setq old-fwd-date (cdr old-fwd-date)))
296 (insert "Forwarded-From: " fwd-from "\n")
297 (insert "Forwarded-Date: " fwd-date "\n")
298 (insert forward-msg "\n")
299 (goto-char beg)
300 (re-search-forward "\n$" nil 'move) ; end of header
301 (narrow-to-region beg (point))
302 (goto-char (point-min))
303 (while (not (eobp))
304 (unless (looking-at "^[a-zA-Z-]+: ")
305 (insert "\t"))
306 (forward-line))
307 (widen)
308 (goto-char beg)
309 (forward-line -1)
310 (rmail-add-mbox-headers)) ; marks as unseen
311 (setq error nil)
312 (set-buffer buff)
313 (rmail-swap-buffers-maybe)
314 (goto-char (point-max))
315 (rmail-set-message-counters)
316 (set-buffer-modified-p t)
317 (rmail-show-message current)
318 (if (rmail-summary-exists)
319 (rmail-select-summary (rmail-update-summary))))
320 (when error
321 (set-buffer buff)
322 (rmail-show-message current)))))
324 (provide 'undigest)
326 ;; arch-tag: 3a28b9fb-c1f5-43ef-9278-285f3e4b874d
327 ;;; undigest.el ends here