* mime-edit.el (mime-edit-pgp-use): New variable.
[elisp/semi.git] / mime-view.el
1 ;;; mime-view.el --- interactive MIME viewer for GNU Emacs
2
3 ;; Copyright (C) 1995,96,97,98,99,2000 Free Software Foundation, Inc.
4
5 ;; Author: MORIOKA Tomohiko <tomo@m17n.org>
6 ;; Created: 1994/07/13
7 ;;      Renamed: 1994/08/31 from tm-body.el
8 ;;      Renamed: 1997/02/19 from tm-view.el
9 ;; Keywords: MIME, multimedia, mail, news
10
11 ;; This file is part of SEMI (Sample of Elastic MIME Interfaces).
12
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.
17
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.
22
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., 51 Franklin Street, Fifth Floor,
26 ;; Boston, MA 02110-1301, USA.
27
28 ;;; Code:
29
30 (require 'mime)
31 (require 'semi-def)
32 (require 'calist)
33 (require 'alist)
34 (require 'mime-conf)
35 (require 'mcharset)
36
37 (eval-when-compile (require 'static))
38
39
40 ;;; @ version
41 ;;;
42
43 (defconst mime-view-version
44   (concat (mime-product-name mime-user-interface-product) " MIME-View "
45           (mapconcat #'number-to-string
46                      (mime-product-version mime-user-interface-product) ".")
47           " (" (mime-product-code-name mime-user-interface-product) ")"))
48
49
50 ;;; @ variables
51 ;;;
52
53 (defgroup mime-view nil
54   "MIME view mode"
55   :group 'mime)
56
57 (defcustom mime-situation-examples-file "~/.mime-example"
58   "*File name of situation-examples demonstrated by user."
59   :group 'mime-view
60   :type 'file)
61
62 (defcustom mime-preview-move-scroll nil
63   "*Decides whether to scroll when moving to next entity.
64 When t, scroll the buffer. Non-nil but not t means scroll when
65 the next entity is within next-screen-context-lines from top or
66 buttom. Nil means don't scroll at all."
67   :group 'mime-view
68   :type '(choice (const :tag "Off" nil)
69                  (const :tag "On" t)
70                  (sexp :tag "Situation" 1)))
71
72 (defcustom mime-view-mailcap-files
73   (let ((files '("/etc/mailcap" "/usr/etc/mailcap" "~/.mailcap")))
74     (or (member mime-mailcap-file files)
75         (setq files (cons mime-mailcap-file files)))
76     files)
77   "List of mailcap files."
78   :group 'mime-view
79   :type '(repeat file))
80
81 (defvar mime-view-automatic-conversion 'undecided)
82
83
84 ;;; @ in raw-buffer (representation space)
85 ;;;
86
87 (defvar mime-preview-buffer nil
88   "MIME-preview buffer corresponding with the (raw) buffer.")
89 (make-variable-buffer-local 'mime-preview-buffer)
90
91
92 (defvar mime-raw-representation-type-alist
93   '((mime-show-message-mode     . binary)
94     (mime-temp-message-mode     . binary)
95     (t                          . cooked))
96   "Alist of major-mode vs. representation-type of mime-raw-buffer.
97 Each element looks like (SYMBOL . REPRESENTATION-TYPE).  SYMBOL is
98 major-mode or t.  t means default.  REPRESENTATION-TYPE must be
99 `binary' or `cooked'.")
100
101
102 ;;; @ in preview-buffer (presentation space)
103 ;;;
104
105 (defvar mime-mother-buffer nil
106   "Mother buffer corresponding with the (MIME-preview) buffer.
107 If current MIME-preview buffer is generated by other buffer, such as
108 message/partial, it is called `mother-buffer'.")
109 (make-variable-buffer-local 'mime-mother-buffer)
110
111 ;; (defvar mime-raw-buffer nil
112 ;;   "Raw buffer corresponding with the (MIME-preview) buffer.")
113 ;; (make-variable-buffer-local 'mime-raw-buffer)
114
115 (defvar mime-preview-original-window-configuration nil
116   "Window-configuration before mime-view-mode is called.")
117 (make-variable-buffer-local 'mime-preview-original-window-configuration)
118
119 (defun mime-preview-original-major-mode (&optional recursive point)
120   "Return major-mode of original buffer.
121 If optional argument RECURSIVE is non-nil and current buffer has
122 mime-mother-buffer, it returns original major-mode of the
123 mother-buffer."
124   (if (and recursive mime-mother-buffer)
125       (save-excursion
126         (set-buffer mime-mother-buffer)
127         (mime-preview-original-major-mode recursive))
128     (cdr (assq 'major-mode
129                (get-text-property (or point
130                                       (if (> (point) (buffer-size))
131                                           (max (1- (point-max)) (point-min))
132                                         (point)))
133                                   'mime-view-situation)))))
134
135
136 ;;; @ entity information
137 ;;;
138
139 (defun mime-entity-situation (entity &optional situation)
140   "Return situation of ENTITY."
141   (let (rest param name)
142     ;; Content-Type
143     (unless (assq 'type situation)
144       (setq rest (or (mime-entity-content-type entity)
145                      (make-mime-content-type 'text 'plain))
146             situation (cons (car rest) situation)
147             rest (cdr rest)))
148     (unless (assq 'subtype situation)
149       (or rest
150           (setq rest (or (cdr (mime-entity-content-type entity))
151                          '((subtype . plain)))))
152       (setq situation (cons (car rest) situation)
153             rest (cdr rest)))
154     (while rest
155       (setq param (car rest))
156       (or (assoc (car param) situation)
157           (setq situation (cons param situation)))
158       (setq rest (cdr rest)))
159     
160     ;; Content-Disposition
161     (setq rest nil)
162     (unless (assq 'disposition-type situation)
163       (setq rest (mime-entity-content-disposition entity))
164       (if rest
165           (setq situation (cons (cons 'disposition-type
166                                       (mime-content-disposition-type rest))
167                                 situation)
168                 rest (mime-content-disposition-parameters rest))))
169     (while rest
170       (setq param (car rest)
171             name (car param))
172       (if (cond ((string= name "filename")
173                  (if (assq 'filename situation)
174                      nil
175                    (setq name 'filename)))
176                 ((string= name "creation-date")
177                  (if (assq 'creation-date situation)
178                      nil
179                    (setq name 'creation-date)))
180                 ((string= name "modification-date")
181                  (if (assq 'modification-date situation)
182                      nil
183                    (setq name 'modification-date)))
184                 ((string= name "read-date")
185                  (if (assq 'read-date situation)
186                      nil
187                    (setq name 'read-date)))
188                 ((string= name "size")
189                  (if (assq 'size situation)
190                      nil
191                    (setq name 'size)))
192                 (t (setq name (cons 'disposition name))
193                    (if (assoc name situation)
194                        nil
195                      name)))
196           (setq situation
197                 (cons (cons name (cdr param))
198                       situation)))
199       (setq rest (cdr rest)))
200     
201     ;; Content-Transfer-Encoding
202     (or (assq 'encoding situation)
203         (setq situation
204               (cons (cons 'encoding (or (mime-entity-encoding entity)
205                                         "7bit"))
206                     situation)))
207     
208     situation))
209
210 (defsubst mime-delq-null-situation (situations field
211                                                &rest ignored-values)
212   (let (dest)
213     (while situations
214       (let* ((situation (car situations))
215              (cell (assq field situation)))
216         (if cell
217             (or (memq (cdr cell) ignored-values)
218                 (setq dest (cons situation dest)))))
219       (setq situations (cdr situations)))
220     dest))
221
222 (defun mime-compare-situation-with-example (situation example)
223   (let ((example (copy-alist example))
224         (match 0))
225     (while situation
226       (let* ((cell (car situation))
227              (key (car cell))
228              (ecell (assoc key example)))
229         (when ecell
230           (if (equal cell ecell)
231               (setq match (1+ match))
232             (setq example (delq ecell example)))))
233       (setq situation (cdr situation)))
234     (cons match example)))
235
236 (defun mime-sort-situation (situation)
237   (sort situation
238         #'(lambda (a b)
239             (let ((a-t (car a))
240                   (b-t (car b))
241                   (order '((type . 1)
242                            (subtype . 2)
243                            (mode . 3)
244                            (method . 4)
245                            (major-mode . 5)
246                            (disposition-type . 6)))
247                   a-order b-order)
248               (if (symbolp a-t)
249                   (let ((ret (assq a-t order)))
250                     (if ret
251                         (setq a-order (cdr ret))
252                       (setq a-order 7)))
253                 (setq a-order 8))
254               (if (symbolp b-t)
255                   (let ((ret (assq b-t order)))
256                     (if ret
257                         (setq b-order (cdr ret))
258                       (setq b-order 7)))
259                 (setq b-order 8))
260               (if (= a-order b-order)
261                   (string< (format "%s" a-t)(format "%s" b-t))
262                 (< a-order b-order))))))
263
264 (defun mime-unify-situations (entity-situation
265                               condition situation-examples
266                               &optional required-name ignored-value
267                               every-situations)
268   (let (ret)
269     (in-calist-package 'mime-view)
270     (setq ret
271           (ctree-find-calist condition entity-situation
272                              every-situations))
273     (if required-name
274         (setq ret (mime-delq-null-situation ret required-name
275                                             ignored-value t)))
276     (or (assq 'ignore-examples entity-situation)
277         (if (cdr ret)
278             (let ((rest ret)
279                   (max-score 0)
280                   (max-escore 0)
281                   max-examples
282                   max-situations)
283               (while rest
284                 (let ((situation (car rest))
285                       (examples situation-examples))
286                   (while examples
287                     (let* ((ret
288                             (mime-compare-situation-with-example
289                              situation (caar examples)))
290                            (ret-score (car ret)))
291                       (cond ((> ret-score max-score)
292                              (setq max-score ret-score
293                                    max-escore (cdar examples)
294                                    max-examples (list (cdr ret))
295                                    max-situations (list situation)))
296                             ((= ret-score max-score)
297                              (cond ((> (cdar examples) max-escore)
298                                     (setq max-escore (cdar examples)
299                                           max-examples (list (cdr ret))
300                                           max-situations (list situation)))
301                                    ((= (cdar examples) max-escore)
302                                     (setq max-examples
303                                           (cons (cdr ret) max-examples))
304                                     (or (member situation max-situations)
305                                         (setq max-situations
306                                               (cons situation max-situations))))))))
307                     (setq examples (cdr examples))))
308                 (setq rest (cdr rest)))
309               (when max-situations
310                 (setq ret max-situations)
311                 (while max-examples
312                   (let* ((example (car max-examples))
313                          (cell
314                           (assoc example situation-examples)))
315                     (if cell
316                         (setcdr cell (1+ (cdr cell)))
317                       (setq situation-examples
318                             (cons (cons example 0)
319                                   situation-examples))))
320                   (setq max-examples (cdr max-examples)))))))
321     (cons ret situation-examples)
322     ;; ret: list of situations
323     ;; situation-examples: new examples (notoce that contents of
324     ;;                     argument `situation-examples' has bees modified)
325     ))
326
327 (defun mime-view-entity-title (entity)
328   (or (mime-entity-read-field entity 'Content-Description)
329       (mime-entity-read-field entity 'Subject)
330       (mime-entity-filename entity)
331       ""))
332
333 (defvar mime-preview-situation-example-list nil)
334 (defvar mime-preview-situation-example-list-max-size 16)
335 ;; (defvar mime-preview-situation-example-condition nil)
336
337 (defun mime-find-entity-preview-situation (entity
338                                            &optional default-situation)
339   (or (let ((ret
340              (mime-unify-situations
341               (append (mime-entity-situation entity)
342                       default-situation)
343               mime-preview-condition
344               mime-preview-situation-example-list)))
345         (setq mime-preview-situation-example-list
346               (cdr ret))
347         (caar ret))
348       default-situation))
349
350   
351 (defvar mime-acting-situation-example-list nil)
352 (defvar mime-acting-situation-example-list-max-size 16)
353 (defvar mime-situation-examples-file-coding-system nil)
354
355 (defun mime-view-read-situation-examples-file (&optional file)
356   (or file
357       (setq file mime-situation-examples-file))
358   (if (and file
359            (file-readable-p file))
360       (with-temp-buffer
361         (insert-file-contents file)
362         (setq mime-situation-examples-file-coding-system
363               (static-cond
364                ((boundp 'buffer-file-coding-system)
365                 (symbol-value 'buffer-file-coding-system))
366                ((boundp 'file-coding-system)
367                 (symbol-value 'file-coding-system))
368                (t nil))
369               ;; (and (boundp 'buffer-file-coding-system)
370               ;;      buffer-file-coding-system)
371               )
372         (condition-case error
373             (eval-buffer)
374           (error (message "%s is broken: %s" file (cdr error))))
375         ;; format check
376         (condition-case nil
377             (let ((i 0))
378               (while (and (> (length mime-preview-situation-example-list)
379                              mime-preview-situation-example-list-max-size)
380                           (< i 16))
381                 (setq mime-preview-situation-example-list
382                       (mime-reduce-situation-examples
383                        mime-preview-situation-example-list))
384                 (setq i (1+ i))))
385           (error (setq mime-preview-situation-example-list nil)))
386         ;; (let ((rest mime-preview-situation-example-list))
387         ;;   (while rest
388         ;;     (ctree-set-calist-strictly 'mime-preview-condition
389         ;;                                (caar rest))
390         ;;     (setq rest (cdr rest))))
391         (condition-case nil
392             (let ((i 0))
393               (while (and (> (length mime-acting-situation-example-list)
394                              mime-acting-situation-example-list-max-size)
395                           (< i 16))
396                 (setq mime-acting-situation-example-list
397                       (mime-reduce-situation-examples
398                        mime-acting-situation-example-list))
399                 (setq i (1+ i))))
400           (error (setq mime-acting-situation-example-list nil))))))
401
402 (defun mime-save-situation-examples ()
403   (if (or mime-preview-situation-example-list
404           mime-acting-situation-example-list)
405       (let ((file mime-situation-examples-file)
406             print-length print-level)
407         (with-temp-buffer
408           (insert ";;; " (file-name-nondirectory file) "\n")
409           (insert "\n;; This file is generated automatically by "
410                   mime-view-version "\n\n")
411           (insert ";;; Code:\n\n")
412           (if mime-preview-situation-example-list
413               (pp `(setq mime-preview-situation-example-list
414                          ',mime-preview-situation-example-list)
415                   (current-buffer)))
416           (if mime-acting-situation-example-list
417               (pp `(setq mime-acting-situation-example-list
418                          ',mime-acting-situation-example-list)
419                   (current-buffer)))
420           (insert "\n;;; "
421                   (file-name-nondirectory file)
422                   " ends here.\n")
423           (static-cond
424            ((boundp 'buffer-file-coding-system)
425             (setq buffer-file-coding-system
426                   mime-situation-examples-file-coding-system))
427            ((boundp 'file-coding-system)
428             (setq file-coding-system
429                   mime-situation-examples-file-coding-system)))
430           ;; (setq buffer-file-coding-system
431           ;;       mime-situation-examples-file-coding-system)
432           (setq buffer-file-name file)
433           (save-buffer)))))
434
435 (add-hook 'kill-emacs-hook 'mime-save-situation-examples)
436
437 (defun mime-reduce-situation-examples (situation-examples)
438   (let ((len (length situation-examples))
439         i ir ic j jr jc ret
440         dest d-i d-j
441         (max-sim 0) sim
442         min-det-ret det-ret
443         min-det-org det-org
444         min-freq freq)
445     (setq i 0
446           ir situation-examples)
447     (while (< i len)
448       (setq ic (car ir)
449             j 0
450             jr situation-examples)
451       (while (< j len)
452         (unless (= i j)
453           (setq jc (car jr))
454           (setq ret (mime-compare-situation-with-example (car ic)(car jc))
455                 sim (car ret)
456                 det-ret (+ (length (car ic))(length (car jc)))
457                 det-org (length (cdr ret))
458                 freq (+ (cdr ic)(cdr jc)))
459           (cond ((< max-sim sim)
460                  (setq max-sim sim
461                        min-det-ret det-ret
462                        min-det-org det-org
463                        min-freq freq
464                        d-i i
465                        d-j j
466                        dest (cons (cdr ret) freq)))
467                 ((= max-sim sim)
468                  (cond ((> min-det-ret det-ret)
469                         (setq min-det-ret det-ret
470                               min-det-org det-org
471                               min-freq freq
472                               d-i i
473                               d-j j
474                               dest (cons (cdr ret) freq)))
475                        ((= min-det-ret det-ret)
476                         (cond ((> min-det-org det-org)
477                                (setq min-det-org det-org
478                                      min-freq freq
479                                      d-i i
480                                      d-j j
481                                      dest (cons (cdr ret) freq)))
482                               ((= min-det-org det-org)
483                                (cond ((> min-freq freq)
484                                       (setq min-freq freq
485                                             d-i i
486                                             d-j j
487                                             dest (cons (cdr ret) freq)))))))))))
488         (setq jr (cdr jr)
489               j (1+ j)))
490       (setq ir (cdr ir)
491             i (1+ i)))
492     (if (> d-i d-j)
493         (setq i d-i
494               d-i d-j
495               d-j i))
496     (setq jr (nthcdr (1- d-j) situation-examples))
497     (setcdr jr (cddr jr))
498     (if (= d-i 0)
499         (setq situation-examples
500               (cdr situation-examples))
501       (setq ir (nthcdr (1- d-i) situation-examples))
502       (setcdr ir (cddr ir)))
503     (if (setq ir (assoc (car dest) situation-examples))
504         (progn
505           (setcdr ir (+ (cdr ir)(cdr dest)))
506           situation-examples)
507       (cons dest situation-examples)
508       ;; situation-examples may be modified.
509       )))
510
511
512 ;;; @ presentation of preview
513 ;;;
514
515 ;;; @@ entity-button
516 ;;;
517
518 ;;; @@@ predicate function
519 ;;;
520
521 ;; (defun mime-view-entity-button-visible-p (entity)
522 ;;   "Return non-nil if header of ENTITY is visible.
523 ;; Please redefine this function if you want to change default setting."
524 ;;   (let ((media-type (mime-entity-media-type entity))
525 ;;         (media-subtype (mime-entity-media-subtype entity)))
526 ;;     (or (not (eq media-type 'application))
527 ;;         (and (not (eq media-subtype 'x-selection))
528 ;;              (or (not (eq media-subtype 'octet-stream))
529 ;;                  (let ((mother-entity (mime-entity-parent entity)))
530 ;;                    (or (not (eq (mime-entity-media-type mother-entity)
531 ;;                                 'multipart))
532 ;;                        (not (eq (mime-entity-media-subtype mother-entity)
533 ;;                                 'encrypted)))
534 ;;                    )
535 ;;                  )))))
536
537 ;;; @@@ entity button generator
538 ;;;
539
540 (defun mime-view-insert-entity-button (entity)
541   "Insert entity-button of ENTITY."
542   (let ((entity-node-id (mime-entity-node-id entity))
543         (params (mime-entity-parameters entity))
544         (subject (mime-view-entity-title entity)))
545     (mime-insert-button
546      (let ((access-type (assoc "access-type" params))
547            (num (or (cdr (assoc "x-part-number" params))
548                     (if (consp entity-node-id)
549                         (mapconcat (function
550                                     (lambda (num)
551                                       (format "%s" (1+ num))))
552                                    (reverse entity-node-id) ".")
553                       "0"))))
554        (cond (access-type
555               (let ((server (assoc "server" params)))
556                 (setq access-type (cdr access-type))
557                 (if server
558                     (format "%s %s ([%s] %s)"
559                             num subject access-type (cdr server))
560                 (let ((site (cdr (assoc "site" params)))
561                       (dir (cdr (assoc "directory" params)))
562                       (url (cdr (assoc "url" params))))
563                   (if url
564                       (format "%s %s ([%s] %s)"
565                               num subject access-type url)
566                     (format "%s %s ([%s] %s:%s)"
567                             num subject access-type site dir))))))
568            (t
569             (let ((media-type (mime-entity-media-type entity))
570                   (media-subtype (mime-entity-media-subtype entity))
571                   (charset (cdr (assoc "charset" params)))
572                   (encoding (mime-entity-encoding entity)))
573               (concat
574                num " " subject
575                (let ((rest
576                       (format " <%s/%s%s%s>"
577                               media-type media-subtype
578                               (if charset
579                                   (concat "; " charset)
580                                 "")
581                               (if encoding
582                                   (concat " (" encoding ")")
583                                 ""))))
584                  (if (>= (+ (current-column)(length rest))(window-width))
585                      "\n\t")
586                  rest))))))
587      (function mime-preview-play-current-entity))))
588
589
590 ;;; @@ entity-header
591 ;;;
592
593 (defvar mime-header-presentation-method-alist nil
594   "Alist of major mode vs. corresponding header-presentation-method functions.
595 Each element looks like (SYMBOL . FUNCTION).
596 SYMBOL must be major mode in raw-buffer or t.  t means default.
597 Interface of FUNCTION must be (ENTITY SITUATION).")
598
599 (defvar mime-view-ignored-field-list
600   '(".*Received:" ".*Path:" ".*Id:" "^References:"
601     "^Replied:" "^Errors-To:"
602     "^Lines:" "^Sender:" ".*Host:" "^Xref:"
603     "^Content-Type:" "^Precedence:"
604     "^Status:" "^X-VM-.*:")
605   "All fields that match this list will be hidden in MIME preview buffer.
606 Each elements are regexp of field-name.")
607
608 (defvar mime-view-visible-field-list '("^Dnas.*:" "^Message-Id:")
609   "All fields that match this list will be displayed in MIME preview buffer.
610 Each elements are regexp of field-name.")
611
612
613 ;;; @@ entity-body
614 ;;;
615
616 ;;; @@@ predicate function
617 ;;;
618
619 (in-calist-package 'mime-view)
620
621 (defun mime-calist::field-match-method-as-default-rule (calist
622                                                         field-type field-value)
623   (let ((s-field (assq field-type calist)))
624     (cond ((null s-field)
625            (cons (cons field-type field-value) calist))
626           (t calist))))
627
628 (define-calist-field-match-method
629   'header #'mime-calist::field-match-method-as-default-rule)
630
631 (define-calist-field-match-method
632   'body #'mime-calist::field-match-method-as-default-rule)
633
634
635 (defvar mime-preview-condition nil
636   "Condition-tree about how to display entity.")
637
638 (ctree-set-calist-strictly
639  'mime-preview-condition '((type . application)(subtype . octet-stream)
640                            (encoding . nil)
641                            (body . visible)))
642 (ctree-set-calist-strictly
643  'mime-preview-condition '((type . application)(subtype . octet-stream)
644                            (encoding . "7bit")
645                            (body . visible)))
646 (ctree-set-calist-strictly
647  'mime-preview-condition '((type . application)(subtype . octet-stream)
648                            (encoding . "8bit")
649                            (body . visible)))
650
651 (ctree-set-calist-strictly
652  'mime-preview-condition '((type . application)(subtype . pgp)
653                            (body . visible)))
654
655 (ctree-set-calist-strictly
656  'mime-preview-condition '((type . application)(subtype . x-latex)
657                            (body . visible)))
658
659 (ctree-set-calist-strictly
660  'mime-preview-condition '((type . application)(subtype . x-selection)
661                            (body . visible)))
662
663 (ctree-set-calist-strictly
664  'mime-preview-condition '((type . application)(subtype . x-comment)
665                            (body . visible)))
666
667 (ctree-set-calist-strictly
668  'mime-preview-condition '((type . message)(subtype . delivery-status)
669                            (body . visible)))
670
671 (ctree-set-calist-strictly
672  'mime-preview-condition
673  '((body . visible)
674    (body-presentation-method . mime-display-text/plain)))
675
676 (defvar mime-preview-fill-flowed-text
677   (module-installed-p 'flow-fill)
678   "If non-nil, fill RFC2646 \"flowed\" text.")
679
680 (autoload 'fill-flowed "flow-fill")
681
682 (defvar mime-preview-inline-fontify t
683   "If non-nil, fontify the inline part.")
684
685 (ctree-set-calist-strictly
686  'mime-preview-condition
687  '((type . nil)
688    (body . visible)
689    (body-presentation-method . mime-display-text/plain)))
690
691 (ctree-set-calist-strictly
692  'mime-preview-condition
693  '((type . text)(subtype . enriched)
694    (body . visible)
695    (body-presentation-method . mime-display-text/enriched)))
696
697 (ctree-set-calist-strictly
698  'mime-preview-condition
699  '((type . text)(subtype . richtext)
700    (body . visible)
701    (body-presentation-method . mime-display-text/richtext)))
702
703 (autoload 'mime-display-application/x-postpet "postpet")
704
705 (ctree-set-calist-strictly
706  'mime-preview-condition
707  '((type . application)(subtype . x-postpet)
708    (body . visible)
709    (body-presentation-method . mime-display-application/x-postpet)))
710
711 (ctree-set-calist-strictly
712  'mime-preview-condition
713  '((type . application)(subtype . emacs-lisp)
714    (body . visible)
715    (body-presentation-method . mime-display-application/emacs-lisp)))
716
717 (ctree-set-calist-strictly
718  'mime-preview-condition
719  '((type . text)(subtype . t)
720    (body . visible)
721    (body-presentation-method . mime-display-text/plain)))
722
723 (ctree-set-calist-strictly
724  'mime-preview-condition
725  '((type . multipart)(subtype . alternative)
726    (body . visible)
727    (body-presentation-method . mime-display-multipart/alternative)))
728
729 (ctree-set-calist-strictly
730  'mime-preview-condition
731  '((type . multipart)(subtype . related)
732    (body . visible)
733    (body-presentation-method . mime-display-multipart/related)))
734
735 (ctree-set-calist-strictly
736  'mime-preview-condition
737  '((type . multipart)(subtype . t)
738    (body . visible)
739    (body-presentation-method . mime-display-multipart/mixed)))
740
741 (ctree-set-calist-strictly
742  'mime-preview-condition
743  '((type . message)(subtype . partial)
744    (body . visible)
745    (body-presentation-method . mime-display-message/partial-button)))
746
747 (ctree-set-calist-strictly
748  'mime-preview-condition
749  '((type . message)(subtype . rfc822)
750    (body . visible)
751    (body-presentation-method . mime-display-multipart/mixed)
752    (childrens-situation (header . visible)
753                         (entity-button . invisible))))
754
755 (ctree-set-calist-strictly
756  'mime-preview-condition
757  '((type . message)(subtype . news)
758    (body . visible)
759    (body-presentation-method . mime-display-multipart/mixed)
760    (childrens-situation (header . visible)
761                         (entity-button . invisible))))
762
763
764 ;;; @@@ entity presentation
765 ;;;
766
767 (defun mime-display-text/plain (entity situation)
768   (save-restriction
769     (narrow-to-region (point-max)(point-max))
770     (condition-case nil
771         (if (and mime-preview-inline-fontify
772                  (mime-entity-filename entity)) ;should be an attachment.
773             (mime-view-insert-fontified-text-content entity situation)
774           (mime-view-insert-text-content entity situation))
775       (error (progn
776                (message "Can't decode current entity.")
777                (sit-for 1))))
778     (run-hooks 'mime-text-decode-hook)
779     (goto-char (point-max))
780     (if (not (eq (char-after (1- (point))) ?\n))
781         (insert "\n"))
782     (if (and mime-preview-fill-flowed-text
783              (equal (cdr (assoc "format" situation)) "flowed"))
784         (fill-flowed))
785     (mime-add-url-buttons)
786     (run-hooks 'mime-display-text/plain-hook)))
787
788 (defun mime-display-text/richtext (entity situation)
789   (save-restriction
790     (narrow-to-region (point-max)(point-max))
791     (mime-view-insert-text-content entity situation)
792     (run-hooks 'mime-text-decode-hook)
793     (let ((beg (point-min)))
794       (remove-text-properties beg (point-max) '(face nil))
795       (richtext-decode beg (point-max)))))
796
797 (defun mime-display-text/enriched (entity situation)
798   (save-restriction
799     (narrow-to-region (point-max)(point-max))
800     (mime-view-insert-text-content entity situation)
801     (run-hooks 'mime-text-decode-hook)
802     (let ((beg (point-min)))
803       (remove-text-properties beg (point-max) '(face nil))
804       (enriched-decode beg (point-max)))))
805
806 (defvar mime-view-announcement-for-message/partial
807   "This is message/partial style split message.")
808
809 (defun mime-display-message/partial-button (&optional entity situation)
810   (save-restriction
811     (goto-char (point-max))
812     (if (not (search-backward "\n\n" nil t))
813         (insert "\n"))
814     (goto-char (point-max))
815     (mime-insert-button mime-view-announcement-for-message/partial
816                         #'mime-preview-play-current-entity)))
817
818 (defun mime-display-multipart/mixed (entity situation)
819   (let ((children (mime-entity-children entity))
820         (original-major-mode-cell (assq 'major-mode situation))
821         (default-situation
822           (cdr (assq 'childrens-situation situation))))
823     (if original-major-mode-cell
824         (setq default-situation
825               (cons original-major-mode-cell default-situation)))
826     (while children
827       (mime-display-entity (car children) nil default-situation)
828       (setq children (cdr children)))))
829
830 (defcustom mime-view-type-subtype-score-alist
831   '(((text . enriched) . 3)
832     ((text . richtext) . 2)
833     ((text . plain)    . 1)
834     (t . 0))
835   "Alist MEDIA-TYPE vs corresponding score.
836 MEDIA-TYPE must be (TYPE . SUBTYPE), TYPE or t.  t means default."
837   :group 'mime-view
838   :type '(repeat (cons (choice :tag "Media-Type"
839                                (cons :tag "Type/Subtype"
840                                      (symbol :tag "Primary-type")
841                                      (symbol :tag "Subtype"))
842                                (symbol :tag "Type")
843                                (const :tag "Default" t))
844                        integer)))
845
846 (defun mime-display-multipart/alternative (entity situation)
847   (let* ((children (mime-entity-children entity))
848          (original-major-mode-cell (assq 'major-mode situation))
849          (default-situation
850            (cdr (assq 'childrens-situation situation)))
851          (i 0)
852          (p 0)
853          (max-score 0)
854          situations)
855     (if original-major-mode-cell
856         (setq default-situation
857               (cons original-major-mode-cell default-situation)))
858     (setq situations
859           (mapcar (function
860                    (lambda (child)
861                      (let ((situation
862                             (mime-find-entity-preview-situation
863                              child default-situation)))
864                        (if (cdr (assq 'body-presentation-method situation))
865                            (let ((score
866                                   (cdr
867                                    (or (assoc
868                                         (cons
869                                          (cdr (assq 'type situation))
870                                          (cdr (assq 'subtype situation)))
871                                         mime-view-type-subtype-score-alist)
872                                        (assq
873                                         (cdr (assq 'type situation))
874                                         mime-view-type-subtype-score-alist)
875                                        (assq
876                                         t
877                                         mime-view-type-subtype-score-alist)))))
878                              (if (> score max-score)
879                                  (setq p i
880                                        max-score score))))
881                        (setq i (1+ i))
882                        situation)))
883                   children))
884     (setq i 0)
885     (while children
886       (let ((child (car children))
887             (situation (car situations)))
888         (mime-display-entity child (if (= i p)
889                                        situation
890                                      (put-alist 'body 'invisible
891                                                 (copy-alist situation)))))
892       (setq children (cdr children)
893             situations (cdr situations)
894             i (1+ i)))))
895
896 (defun mime-display-multipart/related (entity situation)
897   (let* ((param-start (mime-parse-msg-id
898                        (std11-lexical-analyze
899                         (cdr (assoc "start"
900                                     (mime-content-type-parameters
901                                      (mime-entity-content-type entity)))))))
902          (start (or (and param-start (mime-find-entity-from-content-id
903                                       param-start
904                                       entity))
905                     (car (mime-entity-children entity))))
906          (original-major-mode-cell (assq 'major-mode situation))
907          (default-situation (cdr (assq 'childrens-situation situation))))
908     (when start
909       (if original-major-mode-cell
910           (setq default-situation
911                 (cons original-major-mode-cell default-situation)))
912       (mime-display-entity start nil default-situation))))
913
914 (defun mime-view-entity-content (entity situation)
915   (mime-decode-string
916    (mime-entity-body entity)
917    (mime-view-guess-encoding entity situation)))
918   
919 (defun mime-view-insert-text-content (entity situation)
920   (let (compression-info)
921     (cond
922      ((and (mime-entity-filename entity)
923            (featurep 'jka-compr)
924            (jka-compr-installed-p)
925            (setq compression-info (jka-compr-get-compression-info
926                                    (mime-entity-filename entity))))
927       (insert
928        (mime-view-filter-text-content
929         (mime-view-entity-content entity situation)
930         (jka-compr-info-uncompress-program compression-info)
931         (jka-compr-info-uncompress-args compression-info))))
932      ((or (assq '*encoding situation)   ;should be specified by user
933           (assq '*charset situation))   ;should be specified by user
934       (insert
935        (decode-mime-charset-string
936         (mime-view-entity-content entity situation)
937         (mime-view-guess-charset entity situation)
938         'CRLF)))
939      (t
940       (mime-insert-text-content entity)))))
941
942 ;;; stolen (and renamed) from `mime-display-gzipped' of EMY 1.13.
943 (defun mime-view-filter-text-content (content program args)
944   (with-temp-buffer
945     (static-cond
946      ((featurep 'xemacs)
947       (insert content)
948       (apply #'binary-to-text-funcall
949              mime-view-automatic-conversion
950              #'call-process-region (point-min)(point-max)
951              program t t args))
952      (t
953       (if (not (multibyte-string-p content))
954           (set-buffer-multibyte nil))
955       (insert content)
956       (apply #'binary-funcall
957              #'call-process-region (point-min)(point-max)
958              program t t args)
959       (set-buffer-multibyte t)
960       (decode-coding-region (point-min)(point-max)
961                             mime-view-automatic-conversion)))
962     (buffer-string)))
963
964 ;;; stolen (and renamed) from mm-view.el.
965 (defun mime-view-insert-fontified-text-content (entity situation
966                                                        &optional mode)
967   ;; XEmacs @#$@ version of font-lock refuses to fully turn itself
968   ;; on for buffers whose name begins with " ".  That's why we use
969   ;; save-current-buffer/get-buffer-create rather than
970   ;; with-temp-buffer.
971   (let ((buffer (generate-new-buffer "*fontification*"))
972         filename)
973     (unwind-protect
974         (progn
975           (save-current-buffer
976             (set-buffer buffer)
977             (buffer-disable-undo)
978             (kill-all-local-variables)
979             (mime-view-insert-text-content entity situation)
980             (require 'font-lock)
981             (let ((font-lock-maximum-size nil)
982                   ;; Disable support modes, e.g., jit-lock, lazy-lock, etc.
983                   (font-lock-mode-hook nil)
984                   (font-lock-support-mode nil)
985                   ;; I find font-lock a bit too verbose.
986                   (font-lock-verbose nil))
987               (cond (mode
988                      (funcall mode))
989                     ((setq filename (mime-entity-filename entity))
990                      (let ((buffer-file-name
991                             (expand-file-name (file-name-nondirectory filename)
992                                               temporary-file-directory)))
993                        (set-auto-mode))))
994               ;; The mode function might have already turned on font-lock.
995               (unless (symbol-value 'font-lock-mode)
996                 (font-lock-fontify-buffer)))
997             ;; By default, XEmacs font-lock uses non-duplicable text
998             ;; properties.  This code forces all the text properties
999             ;; to be copied along with the text.
1000             (static-when (fboundp 'extent-list)
1001               (map-extents (lambda (ext ignored)
1002                              (set-extent-property ext 'duplicable t)
1003                              nil)
1004                            nil nil nil nil nil 'text-prop)))
1005           (insert-buffer-substring buffer))
1006       (kill-buffer buffer))))
1007
1008 (defun mime-display-application/emacs-lisp (entity situation)
1009   (save-restriction
1010     (narrow-to-region (point-max)(point-max))
1011     (mime-view-insert-fontified-text-content entity situation 'emacs-lisp-mode)
1012     (run-hooks 'mime-text-decode-hook 'mime-display-text/plain-hook)))
1013
1014
1015 ;;; @ acting-condition
1016 ;;;
1017
1018 (defvar mime-acting-condition nil
1019   "Condition-tree about how to process entity.")
1020
1021 (defun mime-view-read-mailcap-files (&optional files)
1022   (or files
1023       (setq files mime-view-mailcap-files))
1024   (let (entries file)
1025     (while files
1026       (setq file (car files))
1027       (if (file-readable-p file)
1028           (setq entries (append entries (mime-parse-mailcap-file file))))
1029       (setq files (cdr files)))
1030     (while entries
1031       (let ((entry (car entries))
1032             view print shared)
1033         (while entry
1034           (let* ((field (car entry))
1035                  (field-type (car field)))
1036             (cond ((eq field-type 'view)  (setq view field))
1037                   ((eq field-type 'print) (setq print field))
1038                   ((memq field-type '(compose composetyped edit)))
1039                   (t (setq shared (cons field shared))))
1040             )
1041           (setq entry (cdr entry)))
1042         (setq shared (nreverse shared))
1043         (ctree-set-calist-with-default
1044          'mime-acting-condition
1045          (append shared (list '(mode . "play")(cons 'method (cdr view)))))
1046         (if print
1047             (ctree-set-calist-with-default
1048              'mime-acting-condition
1049              (append shared
1050                      (list '(mode . "print")(cons 'method (cdr view)))))))
1051       (setq entries (cdr entries)))))
1052
1053 (mime-view-read-mailcap-files)
1054
1055 (ctree-set-calist-strictly
1056  'mime-acting-condition
1057  '((type . application)(subtype . octet-stream)
1058    (mode . "play")
1059    (method . mime-detect-content)))
1060
1061 (ctree-set-calist-with-default
1062  'mime-acting-condition
1063  '((mode . "extract")
1064    (method . mime-save-content)))
1065
1066 (ctree-set-calist-strictly
1067  'mime-acting-condition
1068  '((type . text)(subtype . x-rot13-47)(mode . "play")
1069    (method . mime-view-caesar)))
1070 (ctree-set-calist-strictly
1071  'mime-acting-condition
1072  '((type . text)(subtype . x-rot13-47-48)(mode . "play")
1073    (method . mime-view-caesar)))
1074
1075 (ctree-set-calist-strictly
1076  'mime-acting-condition
1077  '((type . message)(subtype . rfc822)(mode . "play")
1078    (method . mime-view-message/rfc822)))
1079 (ctree-set-calist-strictly
1080  'mime-acting-condition
1081  '((type . message)(subtype . partial)(mode . "play")
1082    (method . mime-store-message/partial-piece)))
1083
1084 (ctree-set-calist-strictly
1085  'mime-acting-condition
1086  '((type . message)(subtype . external-body)
1087    ("access-type" . "anon-ftp")
1088    (method . mime-view-message/external-anon-ftp)))
1089
1090 (ctree-set-calist-strictly
1091  'mime-acting-condition
1092  '((type . message)(subtype . external-body)
1093    ("access-type" . "url")
1094    (method . mime-view-message/external-url)))
1095
1096 (ctree-set-calist-strictly
1097  'mime-acting-condition
1098  '((type . application)(subtype . octet-stream)
1099    (method . mime-save-content)))
1100
1101
1102 ;;; @ quitting method
1103 ;;;
1104
1105 (defvar mime-preview-quitting-method-alist
1106   '((mime-show-message-mode
1107      . mime-preview-quitting-method-for-mime-show-message-mode))
1108   "Alist of major-mode vs. quitting-method of mime-view.")
1109
1110 (defvar mime-preview-over-to-previous-method-alist nil
1111   "Alist of major-mode vs. over-to-previous-method of mime-view.")
1112
1113 (defvar mime-preview-over-to-next-method-alist nil
1114   "Alist of major-mode vs. over-to-next-method of mime-view.")
1115
1116
1117 ;;; @ following method
1118 ;;;
1119
1120 (defvar mime-preview-following-method-alist nil
1121   "Alist of major-mode vs. following-method of mime-view.")
1122
1123 (defvar mime-view-following-required-fields-list
1124   '("From"))
1125
1126
1127 ;;; @ buffer setup
1128 ;;;
1129
1130 (defun mime-display-entity (entity &optional situation
1131                                    default-situation preview-buffer)
1132   (or preview-buffer
1133       (setq preview-buffer (current-buffer)))
1134   (let* (e nb ne nhb nbb)
1135     (in-calist-package 'mime-view)
1136     (or situation
1137         (setq situation
1138               (mime-find-entity-preview-situation entity default-situation)))
1139     (let ((button-is-invisible
1140            (eq (cdr (or (assq '*entity-button situation)
1141                         (assq 'entity-button situation)))
1142                'invisible))
1143           (header-is-visible
1144            (eq (cdr (or (assq '*header situation)
1145                         (assq 'header situation)))
1146                'visible))
1147           (body-is-visible
1148            (eq (cdr (or (assq '*body situation)
1149                         (assq 'body situation)))
1150                'visible))
1151           (children (mime-entity-children entity)))
1152       (set-buffer preview-buffer)
1153       (setq nb (point))
1154       (narrow-to-region nb nb)
1155       (or button-is-invisible
1156           ;; (if (mime-view-entity-button-visible-p entity)
1157           (mime-view-insert-entity-button entity)
1158           ;;   )
1159           )
1160       (if header-is-visible
1161           (let ((header-presentation-method
1162                  (or (cdr (assq 'header-presentation-method situation))
1163                      (cdr (assq (cdr (assq 'major-mode situation))
1164                                 mime-header-presentation-method-alist)))))
1165             (setq nhb (point))
1166             (if header-presentation-method
1167                 (funcall header-presentation-method entity situation)
1168               (mime-insert-header entity
1169                                   mime-view-ignored-field-list
1170                                   mime-view-visible-field-list))
1171             (mime-add-url-buttons)
1172             (run-hooks 'mime-display-header-hook)
1173             (put-text-property nhb (point-max) 'mime-view-entity-header entity)
1174             (goto-char (point-max))
1175             (insert "\n")))
1176       (setq nbb (point))
1177       (unless children
1178         (if body-is-visible
1179             (let ((body-presentation-method
1180                    (cdr (assq 'body-presentation-method situation))))
1181               (if (functionp body-presentation-method)
1182                   (funcall body-presentation-method entity situation)
1183                 (mime-display-text/plain entity situation)))
1184           (when button-is-invisible
1185             (goto-char (point-max))
1186             (mime-view-insert-entity-button entity))
1187           (unless header-is-visible
1188             (goto-char (point-max))
1189             (insert "\n"))))
1190       (setq ne (point-max))
1191       (widen)
1192       (put-text-property nb ne 'mime-view-entity entity)
1193       (put-text-property nb ne 'mime-view-situation situation)
1194       (put-text-property nbb ne 'mime-view-entity-body entity)
1195       (goto-char ne)
1196       (if (and children body-is-visible)
1197           (let ((body-presentation-method
1198                  (cdr (assq 'body-presentation-method situation))))
1199             (if (functionp body-presentation-method)
1200                 (funcall body-presentation-method entity situation)
1201               (mime-display-multipart/mixed entity situation)))))))
1202
1203
1204 ;;; @ MIME viewer mode
1205 ;;;
1206
1207 (defconst mime-view-popup-menu-list
1208   '("MIME-View"
1209     ["Move to upper entity" mime-preview-move-to-upper]
1210     ["Move to previous entity" mime-preview-move-to-previous]
1211     ["Move to next entity" mime-preview-move-to-next]
1212     ["Scroll-down" mime-preview-scroll-down-entity]
1213     ["Scroll-up" mime-preview-scroll-up-entity]
1214     ["Play current entity" mime-preview-play-current-entity]
1215     ["Extract current entity" mime-preview-extract-current-entity]
1216     ["Print current entity" mime-preview-print-current-entity])
1217   "Menu for MIME Viewer")
1218
1219 (defun mime-view-popup-menu (event)
1220   "Popup the menu in the MIME Viewer buffer"
1221   (interactive "@e")
1222   (mime-popup-menu-popup mime-view-popup-menu-list event))
1223
1224 ;;; The current local map is taken precendence over `widget-keymap',
1225 ;;; because GNU Emacs' widget implementation doesn't set `local-map' property.
1226 ;;;  So we need to specify derivation.
1227 (defvar widget-keymap)
1228 (defun mime-view-maybe-inherit-widget-keymap ()
1229   (when (boundp 'widget-keymap)
1230     (set-keymap-parent (current-local-map) widget-keymap)))
1231
1232 (add-hook 'mime-view-mode-hook 'mime-view-maybe-inherit-widget-keymap)
1233           
1234 (defun mime-view-define-keymap (&optional default)
1235   (let ((mime-view-mode-map (if (keymapp default)
1236                                 (copy-keymap default)
1237                               (make-sparse-keymap))))
1238     (define-key mime-view-mode-map
1239       "u"        (function mime-preview-move-to-upper))
1240     (define-key mime-view-mode-map
1241       "p"        (function mime-preview-move-to-previous))
1242     (define-key mime-view-mode-map
1243       "n"        (function mime-preview-move-to-next))
1244     (define-key mime-view-mode-map
1245       "\e\t"     (function mime-preview-move-to-previous))
1246     (define-key mime-view-mode-map
1247       "\t"       (function mime-preview-move-to-next))
1248     (define-key mime-view-mode-map
1249       " "        (function mime-preview-scroll-up-entity))
1250     (define-key mime-view-mode-map
1251       "\M- "     (function mime-preview-scroll-down-entity))
1252     (define-key mime-view-mode-map
1253       "\177"     (function mime-preview-scroll-down-entity))
1254     (define-key mime-view-mode-map
1255       "\C-m"     (function mime-preview-next-line-entity))
1256     (define-key mime-view-mode-map
1257       "\C-\M-m"  (function mime-preview-previous-line-entity))
1258     (define-key mime-view-mode-map
1259       "v"        (function mime-preview-play-current-entity))
1260     (define-key mime-view-mode-map
1261       "e"        (function mime-preview-extract-current-entity))
1262     (define-key mime-view-mode-map
1263       "\C-c\C-p" (function mime-preview-print-current-entity))
1264
1265     (define-key mime-view-mode-map
1266       "\C-c\C-t\C-f" (function mime-preview-toggle-header))
1267     (define-key mime-view-mode-map
1268       "\C-c\C-th" (function mime-preview-toggle-header))
1269     (define-key mime-view-mode-map
1270       "\C-c\C-t\C-c" (function mime-preview-toggle-content))
1271
1272     (define-key mime-view-mode-map
1273       "\C-c\C-v\C-f" (function mime-preview-show-header))
1274     (define-key mime-view-mode-map
1275       "\C-c\C-vh" (function mime-preview-show-header))
1276     (define-key mime-view-mode-map
1277       "\C-c\C-v\C-c" (function mime-preview-show-content))
1278
1279     (define-key mime-view-mode-map
1280       "\C-c\C-d\C-f" (function mime-preview-hide-header))
1281     (define-key mime-view-mode-map
1282       "\C-c\C-dh" (function mime-preview-hide-header))
1283     (define-key mime-view-mode-map
1284       "\C-c\C-d\C-c" (function mime-preview-hide-content))
1285
1286     (define-key mime-view-mode-map
1287       "a"        (function mime-preview-follow-current-entity))
1288     (define-key mime-view-mode-map
1289       "q"        (function mime-preview-quit))
1290     (define-key mime-view-mode-map
1291       "\C-c\C-x" (function mime-preview-kill-buffer))
1292     ;; (define-key mime-view-mode-map
1293     ;;   "<"        (function beginning-of-buffer))
1294     ;; (define-key mime-view-mode-map
1295     ;;   ">"        (function end-of-buffer))
1296     (define-key mime-view-mode-map
1297       "?"        (function describe-mode))
1298     (define-key mime-view-mode-map
1299       [tab] (function mime-preview-move-to-next))
1300     (define-key mime-view-mode-map
1301       [delete] (function mime-preview-scroll-down-entity))
1302     (define-key mime-view-mode-map
1303       [backspace] (function mime-preview-scroll-down-entity))
1304     (if (functionp default)
1305         (if (featurep 'xemacs)
1306             (set-keymap-default-binding mime-view-mode-map default)
1307           (setq mime-view-mode-map
1308                 (append mime-view-mode-map (list (cons t default))))))
1309     (define-key mime-view-mode-map
1310       [down-mouse-3] (function mime-view-popup-menu))
1311     ;; (run-hooks 'mime-view-define-keymap-hook)
1312     mime-view-mode-map))
1313
1314 (defvar mime-view-mode-default-map (mime-view-define-keymap))
1315
1316
1317 (defsubst mime-maybe-hide-echo-buffer ()
1318   "Clear mime-echo buffer and delete window for it."
1319   (let ((buf (get-buffer mime-echo-buffer-name)))
1320     (if buf
1321         (save-excursion
1322           (set-buffer buf)
1323           (erase-buffer)
1324           (let ((win (get-buffer-window buf)))
1325             (if win
1326                 (delete-window win)))
1327           (bury-buffer buf)))))
1328
1329 (defvar mime-view-redisplay nil)
1330
1331 ;;;###autoload
1332 (defun mime-display-message (message &optional preview-buffer
1333                                      mother default-keymap-or-function
1334                                      original-major-mode keymap)
1335   "View MESSAGE in MIME-View mode.
1336
1337 Optional argument PREVIEW-BUFFER specifies the buffer of the
1338 presentation.  It must be either nil or a name of preview buffer.
1339
1340 Optional argument MOTHER specifies mother-buffer of the preview-buffer.
1341
1342 Optional argument DEFAULT-KEYMAP-OR-FUNCTION is nil, keymap or
1343 function.  If it is a keymap, keymap of MIME-View mode will be added
1344 to it.  If it is a function, it will be bound as default binding of
1345 keymap of MIME-View mode.
1346
1347 Optional argument ORIGINAL-MAJOR-MODE is major-mode of representation
1348 buffer of MESSAGE.  If it is nil, current `major-mode' is used.
1349
1350 Optional argument KEYMAP is keymap of MIME-View mode.  If it is
1351 non-nil, DEFAULT-KEYMAP-OR-FUNCTION is ignored.  If it is nil,
1352 `mime-view-mode-default-map' is used."
1353   (mime-maybe-hide-echo-buffer)
1354   (let ((win-conf (current-window-configuration)))
1355     (or preview-buffer
1356         (setq preview-buffer
1357               (concat "*Preview-" (mime-entity-name message) "*")))
1358     (or original-major-mode
1359         (setq original-major-mode major-mode))
1360     (let ((inhibit-read-only t))
1361       (set-buffer (get-buffer-create preview-buffer))
1362       (widen)
1363       (erase-buffer)
1364       (if mother
1365           (setq mime-mother-buffer mother))
1366       (setq mime-preview-original-window-configuration win-conf)
1367       (setq major-mode 'mime-view-mode)
1368       (setq mode-name "MIME-View")
1369       (mime-display-entity message nil
1370                            `((entity-button . invisible)
1371                              (header . visible)
1372                              (major-mode . ,original-major-mode))
1373                            preview-buffer)
1374       (use-local-map
1375        (or keymap
1376            (if default-keymap-or-function
1377                (mime-view-define-keymap default-keymap-or-function)
1378              mime-view-mode-default-map)))
1379       (let ((point
1380              (next-single-property-change (point-min) 'mime-view-entity)))
1381         (if point
1382             (goto-char point)
1383           (goto-char (point-min))
1384           (search-forward "\n\n" nil t)))
1385       (run-hooks 'mime-view-mode-hook)
1386       (set-buffer-modified-p nil)
1387       (setq buffer-read-only t)
1388       preview-buffer)))
1389
1390 ;;;###autoload
1391 (defun mime-view-buffer (&optional raw-buffer preview-buffer mother
1392                                    default-keymap-or-function
1393                                    representation-type)
1394   "View RAW-BUFFER in MIME-View mode.
1395 Optional argument PREVIEW-BUFFER is either nil or a name of preview
1396 buffer.
1397 Optional argument DEFAULT-KEYMAP-OR-FUNCTION is nil, keymap or
1398 function.  If it is a keymap, keymap of MIME-View mode will be added
1399 to it.  If it is a function, it will be bound as default binding of
1400 keymap of MIME-View mode.
1401 Optional argument REPRESENTATION-TYPE is representation-type of
1402 message.  It must be nil, `binary' or `cooked'.  If it is nil,
1403 `cooked' is used as default."
1404   (interactive)
1405   (or raw-buffer
1406       (setq raw-buffer (current-buffer)))
1407   (or representation-type
1408       (setq representation-type
1409             (save-excursion
1410               (set-buffer raw-buffer)
1411               (cdr (or (assq major-mode mime-raw-representation-type-alist)
1412                        (assq t mime-raw-representation-type-alist))))))
1413   (if (eq representation-type 'binary)
1414       (setq representation-type 'buffer))
1415   (setq preview-buffer (mime-display-message
1416                         (mime-open-entity representation-type raw-buffer)
1417                         preview-buffer mother default-keymap-or-function))
1418   (or (get-buffer-window preview-buffer)
1419       (let ((r-win (get-buffer-window raw-buffer)))
1420         (if r-win
1421             (set-window-buffer r-win preview-buffer)
1422           (let ((m-win (and mother (get-buffer-window mother))))
1423             (if m-win
1424                 (set-window-buffer m-win preview-buffer)
1425               (switch-to-buffer preview-buffer)))))))
1426
1427 (defun mime-view-mode (&optional mother ctl encoding
1428                                  raw-buffer preview-buffer
1429                                  default-keymap-or-function)
1430   "Major mode for viewing MIME message.
1431
1432 Here is a list of the standard keys for mime-view-mode.
1433
1434 key             feature
1435 ---             -------
1436
1437 u               Move to upper content
1438 p or M-TAB      Move to previous content
1439 n or TAB        Move to next content
1440 SPC             Scroll up or move to next content
1441 M-SPC or DEL    Scroll down or move to previous content
1442 RET             Move to next line
1443 M-RET           Move to previous line
1444 v               Decode current content as `play mode'
1445 e               Decode current content as `extract mode'
1446 C-c C-p         Decode current content as `print mode'
1447 a               Followup to current content.
1448 q               Quit
1449 button-2        Move to point under the mouse cursor
1450                 and decode current content as `play mode'
1451 "
1452   (interactive)
1453   (unless mime-view-redisplay
1454     (save-excursion
1455       (if raw-buffer (set-buffer raw-buffer))
1456       (let ((type
1457              (cdr
1458               (or (assq major-mode mime-raw-representation-type-alist)
1459                   (assq t mime-raw-representation-type-alist)))))
1460         (if (eq type 'binary)
1461             (setq type 'buffer))
1462         (setq mime-message-structure (mime-open-entity type raw-buffer))
1463         (or (mime-entity-content-type mime-message-structure)
1464             (mime-entity-set-content-type mime-message-structure ctl)))
1465       (or (mime-entity-encoding mime-message-structure)
1466           (mime-entity-set-encoding mime-message-structure encoding))))
1467   (mime-display-message mime-message-structure preview-buffer
1468                         mother default-keymap-or-function))
1469
1470
1471 ;;; @@ utility
1472 ;;;
1473
1474 (defun mime-preview-find-boundary-info (&optional with-children)
1475   "Return boundary information of current part.
1476 If WITH-CHILDREN, refer boundary surrounding current part and its branches."
1477   (let (entity
1478         p-beg p-end
1479         entity-node-id len)
1480     (while (and
1481             (null (setq entity
1482                         (get-text-property (point) 'mime-view-entity)))
1483             (> (point) (point-min)))
1484       (backward-char))
1485     (setq p-beg (previous-single-property-change (point) 'mime-view-entity))
1486     (setq entity-node-id (and entity (mime-entity-node-id entity)))
1487     (setq len (length entity-node-id))
1488     (cond ((null p-beg)
1489            (setq p-beg
1490                  (if (eq (next-single-property-change (point-min)
1491                                                       'mime-view-entity)
1492                          (point))
1493                      (point)
1494                    (point-min))))
1495           ((eq (next-single-property-change p-beg 'mime-view-entity)
1496                (point))
1497            (setq p-beg (point))))
1498     (setq p-end (next-single-property-change p-beg 'mime-view-entity))
1499     (cond ((null p-end)
1500            (setq p-end (point-max)))
1501           ((null entity-node-id)
1502            (setq p-end (point-max)))
1503           (with-children
1504            (save-excursion
1505              (catch 'tag
1506                (let (e i)
1507                  (while (setq e
1508                               (next-single-property-change
1509                                (point) 'mime-view-entity))
1510                    (goto-char e)
1511                    (let ((rc (mime-entity-node-id
1512                               (get-text-property (point)
1513                                                  'mime-view-entity))))
1514                      (or (and (>= (setq i (- (length rc) len)) 0)
1515                               (equal entity-node-id (nthcdr i rc)))
1516                          (throw 'tag nil)))
1517                    (setq p-end (or (next-single-property-change
1518                                     (point) 'mime-view-entity)
1519                                    (point-max)))))
1520                (setq p-end (point-max))))))
1521     (vector p-beg p-end entity)))
1522
1523
1524 ;;; @@ playing
1525 ;;;
1526
1527 (autoload 'mime-preview-play-current-entity "mime-play"
1528   "Play current entity." t)
1529
1530 (defun mime-preview-extract-current-entity (&optional ignore-examples)
1531   "Extract current entity into file (maybe).
1532 It decodes current entity to call internal or external method as
1533 \"extract\" mode.  The method is selected from variable
1534 `mime-acting-condition'."
1535   (interactive "P")
1536   (mime-preview-play-current-entity ignore-examples "extract"))
1537
1538 (defun mime-preview-print-current-entity (&optional ignore-examples)
1539   "Print current entity (maybe).
1540 It decodes current entity to call internal or external method as
1541 \"print\" mode.  The method is selected from variable
1542 `mime-acting-condition'."
1543   (interactive "P")
1544   (mime-preview-play-current-entity ignore-examples "print"))
1545
1546
1547 ;;; @@ following
1548 ;;;
1549
1550 (defun mime-preview-follow-current-entity ()
1551   "Write follow message to current entity.
1552 It calls following-method selected from variable
1553 `mime-preview-following-method-alist'."
1554   (interactive)
1555   (let* ((boundary-info (mime-preview-find-boundary-info t))
1556          (p-beg (aref boundary-info 0))
1557          (p-end (aref boundary-info 1))
1558          (entity (aref boundary-info 2))
1559          pb-beg)
1560     (if (or (get-text-property p-beg 'mime-view-entity-body)
1561             (null entity))
1562         (setq pb-beg p-beg)
1563       (setq pb-beg
1564             (next-single-property-change
1565              p-beg 'mime-view-entity-body nil
1566              (or (next-single-property-change p-beg 'mime-view-entity)
1567                  p-end))))
1568     (let* ((mode (mime-preview-original-major-mode 'recursive))
1569            (entity-node-id (and entity (mime-entity-node-id entity)))
1570            (new-name
1571             (format "%s-%s" (buffer-name) (reverse entity-node-id)))
1572            new-buf
1573            (the-buf (current-buffer))
1574            fields)
1575       (save-excursion
1576         (set-buffer (setq new-buf (get-buffer-create new-name)))
1577         (erase-buffer)
1578         (insert ?\n)
1579         (insert-buffer-substring the-buf pb-beg p-end)
1580         (goto-char (point-min))
1581         (let ((current-entity
1582                (if (and entity
1583                         (eq (mime-entity-media-type entity) 'message)
1584                         (eq (mime-entity-media-subtype entity) 'rfc822))
1585                    (car (mime-entity-children entity))
1586                  entity)))
1587           (while (and current-entity
1588                       (if (and (eq (mime-entity-media-type
1589                                     current-entity) 'message)
1590                                (eq (mime-entity-media-subtype
1591                                     current-entity) 'rfc822))
1592                           nil
1593                         (mime-insert-header current-entity fields)
1594                         t))
1595             (setq fields (std11-collect-field-names)
1596                   current-entity (mime-entity-parent current-entity))))
1597         (let ((rest mime-view-following-required-fields-list)
1598               field-name ret)
1599           (while rest
1600             (setq field-name (car rest))
1601             (or (std11-field-body field-name)
1602                 (progn
1603                   (save-excursion
1604                     (set-buffer the-buf)
1605                     (let ((entity (when mime-mother-buffer
1606                                     (set-buffer mime-mother-buffer)
1607                                     (get-text-property (point)
1608                                                        'mime-view-entity))))
1609                       (while (and entity
1610                                   (null (setq ret (mime-entity-fetch-field
1611                                                    entity field-name))))
1612                         (setq entity (mime-entity-parent entity)))))
1613                   (if ret
1614                       (insert (concat field-name ": " ret "\n")))))
1615             (setq rest (cdr rest)))))
1616       (let ((f (cdr (assq mode mime-preview-following-method-alist))))
1617         (if (functionp f)
1618             (funcall f new-buf)
1619           (message
1620            "Sorry, following method for %s is not implemented yet."
1621             mode))))))
1622
1623
1624 ;;; @@ moving
1625 ;;;
1626
1627 (defun mime-preview-move-to-upper ()
1628   "Move to upper entity.
1629 If there is no upper entity, call function `mime-preview-quit'."
1630   (interactive)
1631   (let (cinfo)
1632     (while (null (setq cinfo
1633                        (get-text-property (point) 'mime-view-entity)))
1634       (backward-char))
1635     (let ((r (mime-entity-parent cinfo))
1636           point)
1637       (catch 'tag
1638         (while (setq point (previous-single-property-change
1639                             (point) 'mime-view-entity))
1640           (goto-char point)
1641           (when (eq r (get-text-property (point) 'mime-view-entity))
1642             (if (or (eq mime-preview-move-scroll t)
1643                     (and mime-preview-move-scroll
1644                          (>= point
1645                              (save-excursion
1646                                (move-to-window-line -1)
1647                                (forward-line (* -1 next-screen-context-lines))
1648                                (beginning-of-line)
1649                                (point)))))
1650                 (recenter next-screen-context-lines))
1651             (throw 'tag t)))
1652         (mime-preview-quit)))))
1653
1654 (defun mime-preview-move-to-previous ()
1655   "Move to previous entity.
1656 If there is no previous entity, it calls function registered in
1657 variable `mime-preview-over-to-previous-method-alist'."
1658   (interactive)
1659   (while (and (not (bobp))
1660               (null (get-text-property (point) 'mime-view-entity)))
1661     (backward-char))
1662   (let ((point (previous-single-property-change (point) 'mime-view-entity)))
1663     (if (and point
1664              (>= point (point-min)))
1665         (if (get-text-property (1- point) 'mime-view-entity)
1666             (progn (goto-char point)
1667                    (if
1668                     (or (eq mime-preview-move-scroll t)
1669                         (and mime-preview-move-scroll
1670                              (<= point
1671                                 (save-excursion
1672                                   (move-to-window-line 0)
1673                                   (forward-line next-screen-context-lines)
1674                                   (end-of-line)
1675                                   (point)))))
1676                         (recenter (* -1 next-screen-context-lines))))
1677           (goto-char (1- point))
1678           (mime-preview-move-to-previous))
1679       (let ((f (assq (mime-preview-original-major-mode)
1680                      mime-preview-over-to-previous-method-alist)))
1681         (if f
1682             (funcall (cdr f)))))))
1683
1684 (defun mime-preview-move-to-next ()
1685   "Move to next entity.
1686 If there is no previous entity, it calls function registered in
1687 variable `mime-preview-over-to-next-method-alist'."
1688   (interactive)
1689   (while (and (not (eobp))
1690               (null (get-text-property (point) 'mime-view-entity)))
1691     (forward-char))
1692   (let ((point (next-single-property-change (point) 'mime-view-entity)))
1693     (if (and point
1694              (<= point (point-max)))
1695         (progn
1696           (goto-char point)
1697           (if (null (get-text-property point 'mime-view-entity))
1698               (mime-preview-move-to-next)
1699             (and
1700              (or (eq mime-preview-move-scroll t)
1701                  (and mime-preview-move-scroll
1702                       (>= point
1703                          (save-excursion
1704                            (move-to-window-line -1)
1705                            (forward-line
1706                             (* -1 next-screen-context-lines))
1707                            (beginning-of-line)
1708                            (point)))))
1709                  (recenter next-screen-context-lines))))
1710       (let ((f (assq (mime-preview-original-major-mode)
1711                      mime-preview-over-to-next-method-alist)))
1712         (if f
1713             (funcall (cdr f)))))))
1714
1715 (defun mime-preview-scroll-up-entity (&optional h)
1716   "Scroll up current entity.
1717 If reached to (point-max), it calls function registered in variable
1718 `mime-preview-over-to-next-method-alist'."
1719   (interactive)
1720   (if (eobp)
1721       (let ((f (assq (mime-preview-original-major-mode)
1722                      mime-preview-over-to-next-method-alist)))
1723         (if f
1724             (funcall (cdr f))))
1725     (let ((point
1726            (or (next-single-property-change (point) 'mime-view-entity)
1727                (point-max)))
1728           (bottom (window-end (selected-window))))
1729       (if (and (not h)
1730                (> bottom point))
1731           (progn (goto-char point)
1732                  (recenter next-screen-context-lines))
1733         (condition-case nil
1734             (scroll-up h)
1735           (end-of-buffer
1736            (goto-char (point-max))))))))
1737
1738 (defun mime-preview-scroll-down-entity (&optional h)
1739   "Scroll down current entity.
1740 If reached to (point-min), it calls function registered in variable
1741 `mime-preview-over-to-previous-method-alist'."
1742   (interactive)
1743   (if (bobp)
1744       (let ((f (assq (mime-preview-original-major-mode)
1745                      mime-preview-over-to-previous-method-alist)))
1746         (if f
1747             (funcall (cdr f))))
1748     (let ((point
1749            (or (previous-single-property-change (point) 'mime-view-entity)
1750                (point-min)))
1751           (top (window-start (selected-window))))
1752       (if (and (not h)
1753                (< top point))
1754           (progn (goto-char point)
1755                  (recenter (* -1 next-screen-context-lines)))
1756         (condition-case nil
1757             (scroll-down h)
1758           (beginning-of-buffer
1759            (goto-char (point-min))))))))
1760
1761 (defun mime-preview-next-line-entity (&optional lines)
1762   "Scroll up one line (or prefix LINES lines).
1763 If LINES is negative, scroll down LINES lines."
1764   (interactive "p")
1765   (mime-preview-scroll-up-entity (or lines 1)))
1766
1767 (defun mime-preview-previous-line-entity (&optional lines)
1768   "Scrroll down one line (or prefix LINES lines).
1769 If LINES is negative, scroll up LINES lines."
1770   (interactive "p")
1771   (mime-preview-scroll-down-entity (or lines 1)))
1772
1773
1774 ;;; @@ display
1775 ;;;
1776
1777 (defun mime-view-guess-encoding (entity situation)
1778   (or (cdr (assq '*encoding situation))
1779       (cdr (assq 'encoding situation))
1780       (mime-entity-encoding entity)
1781       "7bit"))
1782
1783 (defun mime-view-read-encoding (entity situation)
1784   (let* ((default-encoding
1785            (mime-view-guess-encoding entity situation))
1786          (encoding
1787           (completing-read
1788            "Content Transfer Encoding: "
1789            (mime-encoding-alist) nil t default-encoding)))
1790     (unless (or (string= encoding "")
1791                 (string= encoding default-encoding))
1792       encoding)))
1793
1794 (defun mime-view-guess-charset (entity situation)
1795   (or (static-if (fboundp 'coding-system-to-mime-charset)
1796           ;; might be overridden by `universal-coding-system-argument'.
1797           (and coding-system-for-read
1798                (coding-system-to-mime-charset coding-system-for-read)))
1799       (cdr (assq '*charset situation))
1800       (cdr (assq 'charset situation))
1801       (let ((charset (cdr (assoc "charset" (mime-entity-parameters entity)))))
1802         (if charset
1803             (intern (downcase charset))))
1804       default-mime-charset))
1805
1806 (defun mime-view-read-charset (entity situation)
1807   (static-if (featurep 'mule)
1808       (let* ((default-charset
1809                (mime-view-guess-charset entity situation))
1810              (charset
1811               (intern (completing-read "MIME-charset: "
1812                                        (mapcar
1813                                         (lambda (sym)
1814                                           (list (symbol-name sym)))
1815                                         (mime-charset-list))
1816                                        nil t
1817                                        (symbol-name default-charset)))))
1818         (unless (eq charset default-charset)
1819           charset))
1820     default-charset))
1821
1822 (defun mime-preview-toggle-display (type &optional display)
1823   (let ((situation (mime-preview-find-boundary-info t))
1824         (sym (intern (concat "*" (symbol-name type))))
1825         entity p-beg p-end encoding charset)
1826     (setq p-beg (aref situation 0)
1827           p-end (aref situation 1)
1828           entity (aref situation 2)
1829           situation (get-text-property p-beg 'mime-view-situation))
1830     (cond ((eq display 'invisible)
1831            (setq display nil))
1832           (display)
1833           (t
1834            (setq display
1835                  (memq (cdr (or (assq sym situation)
1836                                 (assq type situation)))
1837                        '(nil invisible)))))
1838     (setq situation (put-alist sym (if display
1839                                        'visible
1840                                      'invisible)
1841                                situation))
1842     (when (and current-prefix-arg
1843                (eq (cdr (assq sym situation)) 'visible))
1844       (if (setq encoding (mime-view-read-encoding entity situation))
1845           (setq situation (put-alist '*encoding encoding situation)))
1846       (if (setq charset (mime-view-read-charset entity situation))
1847           (setq situation (put-alist '*charset charset situation))))
1848     (save-excursion
1849       (let ((inhibit-read-only t))
1850         (delete-region p-beg p-end)
1851         (mime-display-entity entity situation)))
1852     (let ((ret (assoc situation mime-preview-situation-example-list)))
1853       (if ret
1854           (setcdr ret (1+ (cdr ret)))
1855         (add-to-list 'mime-preview-situation-example-list
1856                      (cons situation 0))))))
1857
1858 (defun mime-preview-toggle-header (&optional force-visible)
1859   (interactive "P")
1860   (mime-preview-toggle-display 'header force-visible))
1861
1862 (defun mime-preview-toggle-content (&optional force-visible)
1863   (interactive "P")
1864   (mime-preview-toggle-display 'body force-visible))
1865
1866 (defun mime-preview-show-header ()
1867   (interactive)
1868   (mime-preview-toggle-display 'header 'visible))
1869
1870 (defun mime-preview-show-content ()
1871   (interactive)
1872   (mime-preview-toggle-display 'body 'visible))
1873
1874 (defun mime-preview-hide-header ()
1875   (interactive)
1876   (mime-preview-toggle-display 'header 'invisible))
1877
1878 (defun mime-preview-hide-content ()
1879   (interactive)
1880   (mime-preview-toggle-display 'body 'invisible))
1881
1882     
1883 ;;; @@ quitting
1884 ;;;
1885
1886 (defun mime-preview-quit ()
1887   "Quit from MIME-preview buffer.
1888 It calls function registered in variable
1889 `mime-preview-quitting-method-alist'."
1890   (interactive)
1891   (let ((r (assq (mime-preview-original-major-mode)
1892                  mime-preview-quitting-method-alist)))
1893     (if r
1894         (funcall (cdr r)))))
1895
1896 (defun mime-preview-kill-buffer ()
1897   (interactive)
1898   (kill-buffer (current-buffer)))
1899
1900
1901 ;;; @ end
1902 ;;;
1903
1904 (provide 'mime-view)
1905
1906 (eval-when-compile
1907   (setq mime-situation-examples-file nil)
1908   ;; to avoid to read situation-examples-file at compile time.
1909   )
1910
1911 (mime-view-read-situation-examples-file)
1912
1913 ;;; mime-view.el ends here