1 ;;; mime-view.el --- interactive MIME viewer for GNU Emacs
3 ;; Copyright (C) 1995,1996,1997,1998 Free Software Foundation, Inc.
5 ;; Author: MORIOKA Tomohiko <morioka@jaist.ac.jp>
7 ;; Renamed: 1994/8/31 from tm-body.el
8 ;; Renamed: 1997/02/19 from tm-view.el
9 ;; Keywords: MIME, multimedia, mail, news
11 ;; This file is part of SEMI (Sophisticated Emacs MIME Interfaces).
13 ;; This program is free software; you can redistribute it and/or
14 ;; modify it under the terms of the GNU General Public License as
15 ;; published by the Free Software Foundation; either version 2, or (at
16 ;; your option) any later version.
18 ;; This program is distributed in the hope that it will be useful, but
19 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 ;; General Public License for more details.
23 ;; You should have received a copy of the GNU General Public License
24 ;; along with GNU Emacs; see the file COPYING. If not, write to the
25 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
26 ;; Boston, MA 02111-1307, USA.
32 (require 'eword-decode)
40 (defconst mime-view-version-string
41 `,(concat "SEMI MIME-View "
42 (mapconcat #'number-to-string (cdr semi-version) ".")
43 " (" (car semi-version) ")"))
46 ;;; @ buffer local variables
52 (defvar mime-raw-message-info
53 "Information about structure of message.
54 Please use reference function `mime-entity-SLOT' to get value of SLOT.
56 Following is a list of slots of the structure:
58 node-id reversed entity-number (list of integers)
59 point-min beginning point of region in raw-buffer
60 point-max end point of region in raw-buffer
61 type media-type (symbol)
62 subtype media-subtype (symbol)
63 type/subtype media-type/subtype (string or nil)
64 parameters parameter of Content-Type field (association list)
65 encoding Content-Transfer-Encoding (string or nil)
66 children entities included in this entity (list of content-infos)
68 If an entity includes other entities in its body, such as multipart or
69 message/rfc822, `mime-entity' structures of them are included in
70 `children', so the `mime-entity' structure become a tree.")
71 (make-variable-buffer-local 'mime-raw-message-info)
73 (defvar mime-preview-buffer nil
74 "MIME-preview buffer corresponding with the (raw) buffer.")
75 (make-variable-buffer-local 'mime-preview-buffer)
78 ;;; @@ in preview-buffer
81 (defvar mime-mother-buffer nil
82 "Mother buffer corresponding with the (MIME-preview) buffer.
83 If current MIME-preview buffer is generated by other buffer, such as
84 message/partial, it is called `mother-buffer'.")
85 (make-variable-buffer-local 'mime-mother-buffer)
87 (defvar mime-raw-buffer nil
88 "Raw buffer corresponding with the (MIME-preview) buffer.")
89 (make-variable-buffer-local 'mime-raw-buffer)
91 (defvar mime-preview-original-major-mode nil
92 "Major-mode of mime-raw-buffer.")
93 (make-variable-buffer-local 'mime-preview-original-major-mode)
95 (make-variable-buffer-local 'mime-preview-original-window-configuration)
101 (defvar mime-view-content-button-visible-ctype-list
102 '("application/pgp"))
104 (defun mime-view-insert-entity-button (entity message-info subj)
105 "Insert entity-button of ENTITY."
106 (let ((entity-node-id (mime-entity-node-id entity))
107 (params (mime-entity-parameters entity)))
109 (let ((access-type (assoc "access-type" params))
110 (num (or (cdr (assoc "x-part-number" params))
111 (if (consp entity-node-id)
114 (format "%s" (1+ num))
116 (reverse entity-node-id) ".")
120 (let ((server (assoc "server" params)))
121 (setq access-type (cdr access-type))
123 (format "%s %s ([%s] %s)"
124 num subj access-type (cdr server))
125 (let ((site (cdr (assoc "site" params)))
126 (dir (cdr (assoc "directory" params)))
128 (format "%s %s ([%s] %s:%s)"
129 num subj access-type site dir)
133 (let ((media-type (mime-entity-media-type entity))
134 (media-subtype (mime-entity-media-subtype entity))
135 (charset (cdr (assoc "charset" params)))
136 (encoding (mime-entity-encoding entity)))
140 (format " <%s/%s%s%s>"
141 media-type media-subtype
143 (concat "; " charset)
146 (concat " (" encoding ")")
148 (if (>= (+ (current-column)(length rest))(window-width))
152 (function mime-preview-play-current-entity))
155 (defun mime-view-entity-button-function (entity message-info subj)
156 "Insert entity-button of ENTITY conditionally.
157 Please redefine this function if you want to change default setting."
158 (let ((entity-node-id (mime-entity-node-id entity))
159 (media-type (mime-entity-media-type entity))
160 (media-subtype (mime-entity-media-subtype entity)))
161 (or (null entity-node-id)
162 (and (eq media-type 'application)
163 (or (eq media-subtype 'x-selection)
164 (and (eq media-subtype 'octet-stream)
166 (mime-raw-find-entity-from-node-id
167 (cdr entity-node-id) message-info)))
168 (and (eq (mime-entity-media-type mother-entity)
170 (eq (mime-entity-media-subtype mother-entity)
173 (mime-view-insert-entity-button entity message-info subj)
180 ;;; @@ predicate function
183 (defvar mime-view-childrens-header-showing-Content-Type-list
184 '("message/rfc822" "message/news"))
186 (defun mime-view-header-visible-p (entity message-info)
187 "Return non-nil if header of ENTITY is visible."
188 (let ((entity-node-id (mime-entity-node-id entity)))
189 (or (null entity-node-id)
190 (member (mime-entity-type/subtype
191 (mime-raw-find-entity-from-node-id
192 (cdr entity-node-id) message-info))
193 mime-view-childrens-header-showing-Content-Type-list)
196 ;;; @@ entity header filter
199 (defvar mime-view-content-header-filter-alist nil)
201 (defun mime-view-default-content-header-filter ()
202 (mime-view-cut-header)
203 (eword-decode-header)
206 (defun mime-view-display-header (beg end)
208 (narrow-to-region (point)(point))
209 (insert-buffer-substring mime-raw-buffer beg end)
210 (let ((f (cdr (assq mime-preview-original-major-mode
211 mime-view-content-header-filter-alist))))
214 (mime-view-default-content-header-filter)
216 (run-hooks 'mime-view-content-header-filter-hook)
219 ;;; @@ entity field cutter
222 (defvar mime-view-ignored-field-list
223 '(".*Received" ".*Path" ".*Id" "References"
224 "Replied" "Errors-To"
225 "Lines" "Sender" ".*Host" "Xref"
226 "Content-Type" "Precedence"
228 "All fields that match this list will be hidden in MIME preview buffer.
229 Each elements are regexp of field-name.")
231 (defvar mime-view-ignored-field-regexp
233 (apply (function regexp-or) mime-view-ignored-field-list)
236 (defvar mime-view-visible-field-list '("Dnas.*" "Message-Id")
237 "All fields that match this list will be displayed in MIME preview buffer.
238 Each elements are regexp of field-name.")
240 (defun mime-view-cut-header ()
241 (goto-char (point-min))
242 (while (re-search-forward mime-view-ignored-field-regexp nil t)
243 (let* ((beg (match-beginning 0))
245 (name (buffer-substring beg end))
248 (let ((rest mime-view-visible-field-list))
250 (if (string-match (car rest) name)
253 (setq rest (cdr rest))))
256 (if (re-search-forward "^\\([^ \t]\\|$\\)" nil t)
265 ;;; @@ predicate function
268 (defvar mime-view-visible-media-type-list
269 '("text/plain" nil "text/richtext" "text/enriched"
270 "text/rfc822-headers"
271 "text/x-latex" "application/x-latex"
272 "message/delivery-status"
273 "application/pgp" "text/x-pgp"
274 "application/octet-stream"
275 "application/x-selection" "application/x-comment")
276 "*List of media-types to be able to display in MIME-preview buffer.
277 Each elements are string of TYPE/SUBTYPE, e.g. \"text/plain\".")
279 (defun mime-view-body-visible-p (entity message-info)
280 "Return non-nil if body of ENTITY is visible."
281 (let ((media-type (mime-entity-media-type entity))
282 (media-subtype (mime-entity-media-subtype entity))
283 (ctype (mime-entity-type/subtype entity)))
284 (and (member ctype mime-view-visible-media-type-list)
285 (if (and (eq media-type 'application)
286 (eq media-subtype 'octet-stream))
287 (member (mime-entity-encoding entity) '(nil "7bit" "8bit"))
294 (defvar mime-view-content-filter-alist
295 '(("text/enriched" . mime-view-filter-for-text/enriched)
296 ("text/richtext" . mime-view-filter-for-text/richtext)
297 (t . mime-view-filter-for-text/plain)
299 "Alist of media-types vs. corresponding MIME-preview filter functions.
300 Each element looks like (TYPE/SUBTYPE . FUNCTION) or (t . FUNCTION).
301 TYPE/SUBTYPE is a string of media-type and FUNCTION is a filter
302 function. t means default media-type.")
304 (defun mime-view-display-body (start end entity message-info subj)
306 (narrow-to-region (point-max)(point-max))
307 (insert-buffer-substring mime-raw-buffer start end)
308 (let* ((ctype (mime-entity-type/subtype entity))
309 (params (mime-entity-parameters entity))
310 (encoding (mime-entity-encoding entity))
311 (f (cdr (or (assoc ctype mime-view-content-filter-alist)
312 (assq t mime-view-content-filter-alist)))))
314 (funcall f ctype params encoding))
317 (defvar mime-view-announcement-for-message/partial
318 (if (and (>= emacs-major-version 19) window-system)
320 \[[ This is message/partial style split message. ]]
321 \[[ Please press `v' key in this buffer ]]
322 \[[ or click here by mouse button-2. ]]"
324 \[[ This is message/partial style split message. ]]
325 \[[ Please press `v' key in this buffer. ]]"
328 (defun mime-view-insert-message/partial-button ()
330 (goto-char (point-max))
331 (if (not (search-backward "\n\n" nil t))
334 (goto-char (point-max))
335 (narrow-to-region (point-max)(point-max))
336 (insert mime-view-announcement-for-message/partial)
337 (mime-add-button (point-min)(point-max)
338 #'mime-preview-play-current-entity)
342 ;;; @ entity separator
345 (defun mime-view-entity-separator-function (entity message-info)
346 "Insert entity-separator of ENTITY conditionally.
347 Please redefine this function if you want to change default setting."
348 (or (mime-view-header-visible-p entity message-info)
349 (mime-view-body-visible-p entity message-info)
351 (goto-char (point-max))
356 ;;; @ acting-condition
359 (defvar mime-acting-condition
360 '(((type . text)(subtype . plain)
361 (method "tm-plain" nil 'file "" 'encoding 'mode 'name)
362 (mode "play" "print")
364 ((type . text)(subtype . html)
365 (method "tm-html" nil 'file "" 'encoding 'mode 'name)
368 ((type . text)(subtype . x-rot13-47)
369 (method . mime-method-to-display-caesar)
372 ((type . text)(subtype . x-rot13-47-48)
373 (method . mime-method-to-display-caesar)
377 ((type . audio)(subtype . basic)
378 (method "tm-au" nil 'file "" 'encoding 'mode 'name)
383 (method "tm-image" nil 'file "" 'encoding 'mode 'name)
384 (mode "play" "print")
387 ((type . video)(subtype . mpeg)
388 (method "tm-mpeg" nil 'file "" 'encoding 'mode 'name)
392 ((type . application)(subtype . postscript)
393 (method "tm-ps" nil 'file "" 'encoding 'mode 'name)
394 (mode "play" "print")
396 ((type . application)(subtype . octet-stream)
397 (method . mime-method-to-save)(mode "play" "print")
400 ((type . message)(subtype . external-body)
401 ("access-type" . "anon-ftp")
402 (method . mime-method-to-display-message/external-ftp)
404 ((type . message)(subtype . rfc822)
405 (method . mime-method-to-display-message/rfc822)
408 ((type . message)(subtype . partial)
409 (method . mime-method-to-store-message/partial)
413 ((method "metamail" t "-m" "tm" "-x" "-d" "-z" "-e" 'file)
416 ((method . mime-method-to-save)(mode . "extract"))
420 ;;; @ quitting method
423 (defvar mime-preview-quitting-method-alist
424 '((mime-show-message-mode
425 . mime-preview-quitting-method-for-mime-show-message-mode))
426 "Alist of major-mode vs. quitting-method of mime-view.")
428 (defvar mime-view-over-to-previous-method-alist nil)
429 (defvar mime-view-over-to-next-method-alist nil)
431 (defvar mime-view-show-summary-method nil
432 "Alist of major-mode vs. show-summary-method.")
435 ;;; @ following method
438 (defvar mime-view-following-method-alist nil
439 "Alist of major-mode vs. following-method of mime-view.")
441 (defvar mime-view-following-required-fields-list
448 ;; hack from Gnus 5.0.4.
450 (defvar mime-view-x-face-to-pbm-command
451 "{ echo '/* Width=48, Height=48 */'; uncompface; } | icontopbm")
453 (defvar mime-view-x-face-command
454 (concat mime-view-x-face-to-pbm-command
456 "String to be executed to display an X-Face field.
457 The command will be executed in a sub-shell asynchronously.
458 The compressed face will be piped to this command.")
460 (defun mime-view-x-face-function ()
461 "Function to display X-Face field. You can redefine to customize."
462 ;; 1995/10/12 (c.f. tm-eng:130)
463 ;; fixed by Eric Ding <ericding@San-Jose.ate.slb.com>
465 (narrow-to-region (point-min) (re-search-forward "^$" nil t))
467 (goto-char (point-min))
468 (if (re-search-forward "^X-Face:[ \t]*" nil t)
469 (let ((beg (match-end 0))
470 (end (std11-field-end))
472 (call-process-region beg end "sh" nil 0 nil
473 "-c" mime-view-x-face-command)
480 (defvar mime-view-uuencode-encoding-name-list '("x-uue" "x-uuencode"))
487 (defvar mime-view-redisplay nil)
489 (defun mime-view-setup-buffers (&optional ctl encoding ibuf obuf)
495 (or mime-view-redisplay
496 (setq mime-raw-message-info (mime-parse-message ctl encoding))
498 (let* ((message-info mime-raw-message-info)
499 (pcl (mime-raw-flatten-message-info message-info))
500 (the-buf (current-buffer))
504 (setq obuf (concat "*Preview-" (buffer-name the-buf) "*")))
505 (set-buffer (get-buffer-create obuf))
506 (let ((inhibit-read-only t))
507 ;;(setq buffer-read-only nil)
510 (setq mime-raw-buffer the-buf)
511 (setq mime-preview-original-major-mode mode)
512 (setq major-mode 'mime-view-mode)
513 (setq mode-name "MIME-View")
515 (mime-view-display-entity (car pcl) message-info the-buf obuf)
518 (set-buffer-modified-p nil)
520 (setq buffer-read-only t)
523 (setq mime-preview-buffer obuf)
526 (defun mime-view-display-entity (entity message-info ibuf obuf)
528 (let* ((beg (mime-entity-point-min entity))
529 (end (mime-entity-point-max entity))
530 (media-type (mime-entity-media-type entity))
531 (media-subtype (mime-entity-media-subtype entity))
532 (ctype (if media-type
534 (format "%s/%s" media-type media-subtype)
535 (symbol-name media-type)
537 (params (mime-entity-parameters entity))
538 (encoding (mime-entity-encoding entity))
539 (entity-node-id (mime-entity-node-id entity))
543 (setq he (if (re-search-forward "^$" nil t)
550 (narrow-to-region beg end)
553 (mime-raw-get-subject params encoding)))
557 (narrow-to-region nb nb)
558 (mime-view-entity-button-function entity message-info subj)
559 (if (mime-view-header-visible-p entity message-info)
560 (mime-view-display-header beg he)
562 (if (and (null entity-node-id)
564 ctype mime-view-content-button-visible-ctype-list))
566 (goto-char (point-max))
567 (mime-view-insert-entity-button entity message-info subj)
569 (cond ((mime-view-body-visible-p entity message-info)
570 (mime-view-display-body he end entity message-info subj)
572 ((and (eq media-type 'message)(eq media-subtype 'partial))
573 (mime-view-insert-message/partial-button)
575 ((and (null entity-node-id)
576 (null (mime-entity-children message-info))
578 (goto-char (point-max))
579 (mime-view-insert-entity-button entity message-info subj)
581 (mime-view-entity-separator-function entity message-info)
582 (setq ne (point-max))
584 (put-text-property nb ne 'mime-view-raw-buffer ibuf)
585 (put-text-property nb ne 'mime-view-entity entity)
589 (defun mime-raw-get-uu-filename (param &optional encoding)
590 (if (member (or encoding
591 (cdr (assq 'encoding param))
593 mime-view-uuencode-encoding-name-list)
595 (or (if (re-search-forward "^begin [0-9]+ " nil t)
596 (if (looking-at ".+$")
597 (buffer-substring (match-beginning 0)(match-end 0))
602 (defun mime-raw-get-subject (param &optional encoding)
603 (or (std11-find-field-body '("Content-Description" "Subject"))
605 (if (or (and (setq ret (mime/Content-Disposition))
606 (setq ret (assoc "filename" (cdr ret)))
608 (setq ret (assoc "name" param))
609 (setq ret (assoc "x-name" param))
611 (std11-strip-quoted-string (cdr ret))
613 (mime-raw-get-uu-filename param encoding)
617 ;;; @ entity information
620 (defsubst mime-raw-find-entity-from-node-id (entity-node-id
621 &optional message-info)
622 "Return entity from ENTITY-NODE-ID in mime-raw-buffer.
623 If optional argument MESSAGE-INFO is not specified,
624 `mime-raw-message-info' is used."
625 (mime-raw-find-entity-from-number (reverse entity-node-id) message-info))
627 (defun mime-raw-find-entity-from-number (entity-number &optional message-info)
628 "Return entity from ENTITY-NUMBER in mime-raw-buffer.
629 If optional argument MESSAGE-INFO is not specified,
630 `mime-raw-message-info' is used."
632 (setq message-info mime-raw-message-info))
633 (if (eq entity-number t)
635 (let ((sn (car entity-number)))
638 (let ((rc (nth sn (mime-entity-children message-info))))
640 (mime-raw-find-entity-from-number (cdr entity-number) rc)
644 (defun mime-raw-find-entity-from-point (point &optional message-info)
645 "Return entity from POINT in mime-raw-buffer.
646 If optional argument MESSAGE-INFO is not specified,
647 `mime-raw-message-info' is used."
649 (setq message-info mime-raw-message-info))
650 (if (and (<= (mime-entity-point-min message-info) point)
651 (<= point (mime-entity-point-max message-info)))
652 (let ((children (mime-entity-children message-info)))
656 (mime-raw-find-entity-from-point point (car children))))
660 (setq children (cdr children)))
663 (defsubst mime-raw-point-to-entity-node-id (point &optional message-info)
664 "Return entity-node-id from POINT in mime-raw-buffer.
665 If optional argument MESSAGE-INFO is not specified,
666 `mime-raw-message-info' is used."
667 (mime-entity-node-id (mime-raw-find-entity-from-point point message-info)))
669 (defsubst mime-raw-point-to-entity-number (point &optional message-info)
670 "Return entity-number from POINT in mime-raw-buffer.
671 If optional argument MESSAGE-INFO is not specified,
672 `mime-raw-message-info' is used."
673 (reverse (mime-raw-point-to-entity-node-id point message-id)))
675 (defun mime-raw-flatten-message-info (&optional message-info)
676 "Return list of entity in mime-raw-buffer.
677 If optional argument MESSAGE-INFO is not specified,
678 `mime-raw-message-info' is used."
680 (setq message-info mime-raw-message-info))
681 (let ((dest (list message-info))
682 (rcl (mime-entity-children message-info)))
684 (setq dest (nconc dest (mime-raw-flatten-message-info (car rcl))))
685 (setq rcl (cdr rcl)))
689 ;;; @ MIME viewer mode
692 (defconst mime-view-menu-title "MIME-View")
693 (defconst mime-view-menu-list
694 '((up "Move to upper entity" mime-preview-move-to-upper)
695 (previous "Move to previous entity" mime-preview-move-to-previous)
696 (next "Move to next entity" mime-preview-move-to-next)
697 (scroll-down "Scroll-down" mime-preview-scroll-down-entity)
698 (scroll-up "Scroll-up" mime-preview-scroll-up-entity)
699 (play "Play current entity" mime-preview-play-current-entity)
700 (extract "Extract current entity" mime-preview-extract-current-entity)
701 (print "Print current entity" mime-preview-print-current-entity)
702 (x-face "Show X Face" mime-preview-display-x-face)
704 "Menu for MIME Viewer")
706 (cond (running-xemacs
707 (defvar mime-view-xemacs-popup-menu
708 (cons mime-view-menu-title
711 (vector (nth 1 item)(nth 2 item) t)
713 mime-view-menu-list)))
714 (defun mime-view-xemacs-popup-menu (event)
715 "Popup the menu in the MIME Viewer buffer"
717 (select-window (event-window event))
718 (set-buffer (event-buffer event))
719 (popup-menu 'mime-view-xemacs-popup-menu))
720 (defvar mouse-button-2 'button2)
723 (defvar mouse-button-2 [mouse-2])
726 (defun mime-view-define-keymap (&optional default)
727 (let ((mime-view-mode-map (if (keymapp default)
728 (copy-keymap default)
731 (define-key mime-view-mode-map
732 "u" (function mime-preview-move-to-upper))
733 (define-key mime-view-mode-map
734 "p" (function mime-preview-move-to-previous))
735 (define-key mime-view-mode-map
736 "n" (function mime-preview-move-to-next))
737 (define-key mime-view-mode-map
738 "\e\t" (function mime-preview-move-to-previous))
739 (define-key mime-view-mode-map
740 "\t" (function mime-preview-move-to-next))
741 (define-key mime-view-mode-map
742 " " (function mime-preview-scroll-up-entity))
743 (define-key mime-view-mode-map
744 "\M- " (function mime-preview-scroll-down-entity))
745 (define-key mime-view-mode-map
746 "\177" (function mime-preview-scroll-down-entity))
747 (define-key mime-view-mode-map
748 "\C-m" (function mime-preview-next-line-entity))
749 (define-key mime-view-mode-map
750 "\C-\M-m" (function mime-preview-previous-line-entity))
751 (define-key mime-view-mode-map
752 "v" (function mime-preview-play-current-entity))
753 (define-key mime-view-mode-map
754 "e" (function mime-preview-extract-current-entity))
755 (define-key mime-view-mode-map
756 "\C-c\C-p" (function mime-preview-print-current-entity))
757 (define-key mime-view-mode-map
758 "a" (function mime-preview-follow-current-entity))
759 (define-key mime-view-mode-map
760 "q" (function mime-preview-quit))
761 (define-key mime-view-mode-map
762 "h" (function mime-preview-show-summary))
763 (define-key mime-view-mode-map
764 "\C-c\C-x" (function mime-preview-kill-buffer))
765 ;; (define-key mime-view-mode-map
766 ;; "<" (function beginning-of-buffer))
767 ;; (define-key mime-view-mode-map
768 ;; ">" (function end-of-buffer))
769 (define-key mime-view-mode-map
770 "?" (function describe-mode))
771 (define-key mime-view-mode-map
772 [tab] (function mime-preview-move-to-next))
773 (define-key mime-view-mode-map
774 [delete] (function mime-preview-scroll-down-entity))
775 (define-key mime-view-mode-map
776 [backspace] (function mime-preview-scroll-down-entity))
777 (if (functionp default)
778 (cond (running-xemacs
779 (set-keymap-default-binding mime-view-mode-map default)
782 (setq mime-view-mode-map
783 (append mime-view-mode-map (list (cons t default))))
786 (define-key mime-view-mode-map
787 mouse-button-2 (function mime-button-dispatcher))
789 (cond (running-xemacs
790 (define-key mime-view-mode-map
791 mouse-button-3 (function mime-view-xemacs-popup-menu))
793 ((>= emacs-major-version 19)
794 (define-key mime-view-mode-map [menu-bar mime-view]
795 (cons mime-view-menu-title
796 (make-sparse-keymap mime-view-menu-title)))
799 (define-key mime-view-mode-map
800 (vector 'menu-bar 'mime-view (car item))
801 (cons (nth 1 item)(nth 2 item))
804 (reverse mime-view-menu-list)
807 (use-local-map mime-view-mode-map)
808 (run-hooks 'mime-view-define-keymap-hook)
811 (defsubst mime-maybe-hide-echo-buffer ()
812 "Clear mime-echo buffer and delete window for it."
813 (let ((buf (get-buffer mime-echo-buffer-name)))
818 (let ((win (get-buffer-window buf)))
825 (defun mime-view-mode (&optional mother ctl encoding ibuf obuf
826 default-keymap-or-function)
827 "Major mode for viewing MIME message.
829 Here is a list of the standard keys for mime-view-mode.
834 u Move to upper content
835 p or M-TAB Move to previous content
836 n or TAB Move to next content
837 SPC Scroll up or move to next content
838 M-SPC or DEL Scroll down or move to previous content
839 RET Move to next line
840 M-RET Move to previous line
841 v Decode current content as `play mode'
842 e Decode current content as `extract mode'
843 C-c C-p Decode current content as `print mode'
844 a Followup to current content.
847 button-2 Move to point under the mouse cursor
848 and decode current content as `play mode'
851 (mime-maybe-hide-echo-buffer)
852 (let ((ret (mime-view-setup-buffers ctl encoding ibuf obuf))
853 (win-conf (current-window-configuration))
856 (switch-to-buffer ret)
857 (setq mime-preview-original-window-configuration win-conf)
860 (setq mime-mother-buffer mother)
862 (mime-view-define-keymap default-keymap-or-function)
864 (next-single-property-change (point-min) 'mime-view-entity)))
867 (goto-char (point-min))
868 (search-forward "\n\n" nil t)
870 (run-hooks 'mime-view-mode-hook)
877 (autoload 'mime-preview-play-current-entity "mime-play"
878 "Play current entity." t)
880 (defun mime-preview-extract-current-entity ()
881 "Extract current entity into file (maybe).
882 It decodes current entity to call internal or external method as
883 \"extract\" mode. The method is selected from variable
884 `mime-acting-condition'."
886 (mime-preview-play-current-entity "extract")
889 (defun mime-preview-print-current-entity ()
890 "Print current entity (maybe).
891 It decodes current entity to call internal or external method as
892 \"print\" mode. The method is selected from variable
893 `mime-acting-condition'."
895 (mime-preview-play-current-entity "print")
902 (defun mime-preview-original-major-mode ()
903 "Return major-mode of original buffer.
904 If a current buffer has mime-mother-buffer, return original major-mode
905 of the mother-buffer."
906 (if mime-mother-buffer
908 (set-buffer mime-mother-buffer)
909 (mime-preview-original-major-mode)
911 mime-preview-original-major-mode))
913 (defun mime-preview-follow-current-entity ()
914 "Write follow message to current entity.
915 It calls following-method selected from variable
916 `mime-view-following-method-alist'."
918 (let ((message-info (get-text-property (point-min) 'mime-view-entity))
920 (while (null (setq entity
921 (get-text-property (point) 'mime-view-entity)))
925 (previous-single-property-change (point) 'mime-view-entity))
927 (entity-node-id (mime-entity-node-id entity))
928 (len (length entity-node-id))
932 (if (eq (next-single-property-change (point-min)
938 ((eq (next-single-property-change p-beg 'mime-view-entity)
942 (setq p-end (next-single-property-change p-beg 'mime-view-entity))
944 (setq p-end (point-max))
946 ((null entity-node-id)
947 (setq p-end (point-max))
955 (next-single-property-change
956 (point) 'mime-view-entity))
958 (let ((rc (mime-entity-node-id
959 (get-text-property (point)
960 'mime-view-entity))))
961 (or (equal entity-node-id
962 (nthcdr (- (length rc) len) rc))
967 (setq p-end (point-max))
970 (let* ((mode (mime-preview-original-major-mode))
972 (format "%s-%s" (buffer-name) (reverse entity-node-id)))
974 (the-buf (current-buffer))
975 (a-buf mime-raw-buffer)
978 (set-buffer (setq new-buf (get-buffer-create new-name)))
980 (insert-buffer-substring the-buf p-beg p-end)
981 (goto-char (point-min))
982 (if (mime-view-header-visible-p entity message-info)
983 (delete-region (goto-char (point-min))
984 (if (re-search-forward "^$" nil t)
988 (goto-char (point-min))
990 (goto-char (point-min))
991 (let ((entity-node-id (mime-entity-node-id entity)) ci str)
999 (mime-raw-find-entity-from-node-id entity-node-id))
1002 (mime-entity-point-min ci)
1003 (mime-entity-point-max ci)
1005 (std11-header-string-except
1007 (apply (function regexp-or) fields)
1010 (eq (mime-entity-media-type ci) 'message)
1011 (eq (mime-entity-media-subtype ci) 'rfc822))
1017 (setq fields (std11-collect-field-names)
1018 entity-node-id (cdr entity-node-id))
1021 (let ((rest mime-view-following-required-fields-list))
1023 (let ((field-name (car rest)))
1024 (or (std11-field-body field-name)
1030 (set-buffer the-buf)
1031 (set-buffer mime-mother-buffer)
1032 (set-buffer mime-raw-buffer)
1033 (std11-field-body field-name)
1037 (setq rest (cdr rest))
1039 (eword-decode-header)
1041 (let ((f (cdr (assq mode mime-view-following-method-alist))))
1046 "Sorry, following method for %s is not implemented yet."
1055 (defun mime-preview-display-x-face ()
1057 (save-window-excursion
1058 (set-buffer mime-raw-buffer)
1059 (mime-view-x-face-function)
1066 (defun mime-preview-move-to-upper ()
1067 "Move to upper entity.
1068 If there is no upper entity, call function `mime-preview-quit'."
1071 (while (null (setq cinfo
1072 (get-text-property (point) 'mime-view-entity)))
1075 (let ((r (mime-raw-find-entity-from-node-id
1076 (cdr (mime-entity-node-id cinfo))
1077 (get-text-property 1 'mime-view-entity)))
1080 (while (setq point (previous-single-property-change
1081 (point) 'mime-view-entity))
1083 (if (eq r (get-text-property (point) 'mime-view-entity))
1090 (defun mime-preview-move-to-previous ()
1091 "Move to previous entity.
1092 If there is no previous entity, it calls function registered in
1093 variable `mime-view-over-to-previous-method-alist'."
1095 (while (null (get-text-property (point) 'mime-view-entity))
1099 (previous-single-property-change (point) 'mime-view-entity)))
1102 (let ((f (assq mime-preview-original-major-mode
1103 mime-view-over-to-previous-method-alist)))
1109 (defun mime-preview-move-to-next ()
1110 "Move to next entity.
1111 If there is no previous entity, it calls function registered in
1112 variable `mime-view-over-to-next-method-alist'."
1114 (let ((point (next-single-property-change (point) 'mime-view-entity)))
1117 (let ((f (assq mime-preview-original-major-mode
1118 mime-view-over-to-next-method-alist)))
1124 (defun mime-preview-scroll-up-entity (&optional h)
1125 "Scroll up current entity.
1126 If reached to (point-max), it calls function registered in variable
1127 `mime-view-over-to-next-method-alist'."
1130 (setq h (1- (window-height)))
1132 (if (= (point) (point-max))
1133 (let ((f (assq mime-preview-original-major-mode
1134 mime-view-over-to-next-method-alist)))
1139 (or (next-single-property-change (point) 'mime-view-entity)
1142 (if (> (point) point)
1147 (defun mime-preview-scroll-down-entity (&optional h)
1148 "Scroll down current entity.
1149 If reached to (point-min), it calls function registered in variable
1150 `mime-view-over-to-previous-method-alist'."
1153 (setq h (1- (window-height)))
1155 (if (= (point) (point-min))
1156 (let ((f (assq mime-preview-original-major-mode
1157 mime-view-over-to-previous-method-alist)))
1164 (while (> (point) 1)
1166 (previous-single-property-change (point)
1172 (setq point (point-min))
1174 (forward-line (- h))
1175 (if (< (point) point)
1179 (defun mime-preview-next-line-entity ()
1181 (mime-preview-scroll-up-entity 1)
1184 (defun mime-preview-previous-line-entity ()
1186 (mime-preview-scroll-down-entity 1)
1193 (defun mime-preview-quit ()
1194 "Quit from MIME-preview buffer.
1195 It calls function registered in variable
1196 `mime-preview-quitting-method-alist'."
1198 (let ((r (assq mime-preview-original-major-mode
1199 mime-preview-quitting-method-alist)))
1204 (defun mime-preview-show-summary ()
1206 It calls function registered in variable
1207 `mime-view-show-summary-method'."
1209 (let ((r (assq mime-preview-original-major-mode
1210 mime-view-show-summary-method)))
1215 (defun mime-preview-kill-buffer ()
1217 (kill-buffer (current-buffer))
1224 (provide 'mime-view)
1226 (run-hooks 'mime-view-load-hook)
1228 ;;; mime-view.el ends here