[README for tm (English Version)] by MORIOKA Tomohiko $Id: README.eng,v 7.0 1995/10/05 06:57:02 morioka Exp $ 1 What's tm? Tm is a MIME package for GNU Emacs. Tm has following functions: - MIME style multilingual header - MIME message viewer (mime/viewer-mode) - MIME extenders for mh-e, GNUS, RMAIL and vm 2 Documents This package includes following documents. (1) English edition - doc/tm_en.texi : tm Reference Manual (TeXinfo) - doc/tm-view_en.texi : tm-view Reference Manual (TeXinfo) - doc/tm-gnus_en.texi : tm-gnus Reference Manual (TeXinfo) (2) Japanese edition - doc/tm_ja.tex : tm Reference Manual (TeXinfo) - doc/tm-view_ja.texi : tm-view Reference Manual (TeXinfo) - doc/tm-eword_ja.texi : tm-eword.el Reference Manual (TeXinfo) - doc/tm-gnus_ja.texi : tm-gnus Reference Manual (TeXinfo) - doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline) - doc/signature-jp.tex : signature.el Reference Manual (LaTeX) 3 Modules Tm has following modules: - tm-view : MIME viewer - tm-parse.el : MIME message parser - tm-play.el : MIME content player - tm-eword : MIME encoded-word encoder/decoder - tm-ew-d.el : MIME encoded-word decoder - tm-ew-e.el : MIME encoded-word encoder - tm-def : definition module for tm - tm-nemacs.el : NEmacs depended part of tm - tm-orig.el : FSF original Emacs and XEmacs depended part of tm - tm-mule.el : Mule depended part of tm - tm-MUAs : MIME extender for MUAs - tm-mh-e : tm-MUA for mh-e - tm-gnus : tm-MUA for GNUS - tm-rmail : tm-MUA for RMAIL - tm-vm : tm-MUA for vm - preview filter for tm-view - tm-rich : for text/enriched and text/richtext - internal methods for tm-view - tm-partial : automatic assembler for message/partial - tm-ftp : for anonymous ftp - tm-w3 : for text/html (using w3) - tm-tar : for tar content - tm-comp : extender for mime.el (big message automatic splitter, previewer using tm-view, uuencode supporter) - tm-setup: set up module for tm-MUAs - mime-setup: set up module for MIME +---------+-----------------+------------------+ | tm-MUAs | preview filters | internal methods | +---------+-----------------+------------------+ | tm-view | +-----------------------+-------+-----+--------+ | tm-word | | | | +-----------------------+ | | | | tm-def | | | +-------------------------------+ MEL |external| | tl | | | +-------------------------------+ |methods | | emu | | | +-------------------------------+-----+ | | Emacs variants | | +-------------------------------------+--------+ 4 Install 4.1 tm/config.tm Please edit tm/config.tm file. 4.2 External methods Please edit external methods in `methods/' directory for your environment. 4.3 make Run `make all'. 4.4 install Run `make install'. 4.5 Emacs Lisp modules Run `make install-nemacs', if you use NEmacs. Run `make install-mule1', if you use Mule 1.* (based on Emacs 18.*). Run `make install-orig19', if you use Original Emacs 19.* or XEmacs. Run `make install-mule2', if you use Mule 2.* (based on Emacs 19.*). Or copy *.el to your emacs lisp directory. 5 tm-MUA 5.1 tm-gnus (1) Please edit tm/gnus/Makefile. If you use GNUS 3.*, please edit tm/gnus/g3-path. If you use GNUS 4.*, please edit tm/gnus/g4-path. If you use (ding) Gnus, please edit tm/gnus/d-path. If you use Gnus 5.0.*, please edit tm/gnus/g5-path. If you use September Gnus, please edit tm/gnus/s-path. (2) make Run `make gnus3', if you use GNUS 3.*. Run `make gnus4', if you use GNUS 4.*. Run `make dgnus', if you use (ding) GNUS. Run `make gnus5', if you use Gnus 5.0.*. Run `make sgnus', if you use September Gnus. (3) install Run `make install-18', if you use Emacs 18.*. Run `make install-19', if you use Emacs 19.*. 5.1.1 Gnus 5.0.6 If you want to use automatic MIME preview support, please apply a patch to Gnus 5.*. This patch is called `with September patch'. It provides September Gnus like article buffer feature. It is available from ftp.jaist.ac.jp:/pub/GNU/elisp/dgnus/. Current version is gnus-5.0.6-September.diff. 5.1.2 September Gnus For current September Gnus, automatic MIME preview feature is available without any patches. 5.2 tm-mh-e (1) Please edit mh-e/Makefile (2) make Run `make nemacs', if you use NEmacs. Run `make mule1', if you use Mule 1.* (based on Emacs 18.*). Run `make orig19', if you use Original Emacs 19.* or XEmacs. Run `make mule2', if you use Mule 2.* (based on Emacs 19.*). (3) install Run `make install-18', if you use Emacs 18.*. Run `make install-19', if you use Emacs 19.*. 6 .emacs Please insert (load "mime-setup") or (load "tm-setup") in .emacs. If you use mime-setup, you should prepare mime.el. mime.el is included in emacs-mime-tools.shar written by UMEDA Masanobu. It is available by anonymous ftp: ftp.kyutech.ac.jp /pub/MultiMedia/mime/ ftp.jaist.ac.jp /pub/GNU/elisp/mime/ or a lot of anonymous ftp sites. Please try archie. 6.1 VM If you want use vm, please insert following in .vm or .emacs: (load "tm-vm") 6.2 XEmacs In XEmacs, current mime.el can not work, so you should use tm-setup.el and another MIME composer, such as mime-compose.el. Following is a example: (load "tm-setup") ;; (require 'mh-e) ; if you use mh-e, please use it. (load "mime-compose") 6.3 setting sample for hilit19 ====================================================================== (cond (window-system (let* ((header-patterns '(("^Subject:.*$" nil msg-subject) ("^From:.*$" nil msg-from) ("^--text follows this line--$" nil msg-separator) ("^[A-Za-z][A-Za-z0-9-]+:" nil msg-header) )) (body-patterns '(("^\\(In article\\|[ \t]*\\w*[]<>}|]\\).*$" nil msg-quote))) (message-patterns (append header-patterns body-patterns)) ) (hilit-set-mode-patterns 'msg-header header-patterns) (hilit-set-mode-patterns 'msg-body body-patterns) (hilit-set-mode-patterns 'mime/viewer-mode message-patterns 'hilit-rehighlight-message) ) (add-hook 'mime-viewer/content-header-filter-hook (function hilit-rehighlight-buffer-quietly)) (add-hook 'mime-viewer/plain-text-preview-hook (function hilit-rehighlight-buffer-quietly)) )) ====================================================================== 7 How to use mime/viewer-mode In tm-MUAs, you can use mime/viewer-mode if you press `v' key (in VM, `Z' key) in Summary mode. mime/viewer-mode has following functions: q quit from mime/viewer-mode u move to upper content p move to previous content n move to next content SPC scroll up or move to next content M-SPC scroll down or move to previous content DEL scroll down or move to previous content RET move to next line M-RET move to previous line v play current content e extract as file current content C-c C-p print current content button-2 move to point under the mouse cursor and play current content 8 Bug report If you write bug-reports and/or propositions for improvement, please post them to following news groups: fj.editor.emacs (Japanese or English) fj.editor.mule (Japanese or English; if you use Mule) gnu.emacs.help (English) gnu.emacs.vm.info (English; about tm-vm) or send to tm ML: tm@chamonix.jaist.ac.jp (Japanese or English) tm-eng@chamonix.jaist.ac.jp (English) Via tm ML, You can report bugs of tm, obtain the latest release of tm package, and discuss the future enhancements to tm. To join tm ML, send a mail to tm-admin@chamonix.jaist.ac.jp (Japanese or English) tm-eng-admin@chamonix.jaist.ac.jp (English) Since the user registration is manually done, please write the mail body in human-recognizable language (^_^). 9 TODO - automatic MIME preview support for another MUA - better XEmacs support (e.g. inline image) - development of internal method for message/external-body based on tm-ftp - development good MIME composer - etc.