1 [README for tm (English Version)]
2 by MORIOKA Tomohiko <morioka@jaist.ac.jp>
3 $Id: README.eng,v 6.3 1995/08/14 17:46:22 morioka Exp $
7 Tm is a MIME package for GNU Emacs. Tm has following functions:
9 - MIME style multilingual header
10 - MIME message viewer (mime/viewer-mode)
11 - MIME extenders for mh-e, GNUS, RMAIL and vm
16 This package includes following documents.
20 - doc/tm_en.texi : tm Reference Manual (TeXinfo)
21 - doc/tm-view_en.texi : tm-view Reference Manual (TeXinfo)
22 - doc/tiny-mime-eng.ol : tiny-mime.el Reference Manual (Emacs Outline)
23 - doc/tiny-mime-eng.tex : tiny-mime.el Reference Manual (LaTeX)
24 - rel-6eng.ol : notice about major changes of tm 6.* (Emacs Outline)
28 - doc/tm_ja.tex : tm Reference Manual (TeXinfo)
29 - doc/tm-view_ja.tex : tm-view Reference Manual (TeXinfo)
30 - doc/tm-eword_ja.texi : tiny-mime.el Reference Manual (TeXinfo)
31 - doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline)
32 - doc/signature-jp.tex : signature.el Reference Manual (LaTeX)
33 - rel-6jp.ol : notice about major changes of tm 6.* (Emacs Outline)
38 Tm has following modules:
40 - tiny-mime : MIME header encoder/decoder
41 - tm-view : MIME viewer
42 - tm-misc : library module for tm-MUAs
43 - tm-MUAs : MIME extender for MUAs
44 - tm-mh-e : tm-MUA for mh-e
45 - tm-gnus : tm-MUA for GNUS
46 - tm-rmail : tm-MUA for RMAIL
47 - tm-vm : tm-MUA for vm
48 - extender for tm-view
49 - tm-partial : automatic assembler for message/partial
50 - tm-ftp : for anonymous ftp
51 - tm-rich : for text/enriched and text/richtext
52 - tm-comp : extender for mime.el (big message automatic
53 splitter, previewer using tm-view, uuencode
55 - tm-setup: set up module for tm-MUAs
56 - mime-setup: set up module for MIME
63 Tm uses Emacs Lisp library ``tl'', so, at first, you install
64 tl. Please read tl/README.eng.
71 4.1.1 specify Emacs executables
73 Please specify Emacs executable file name.
75 NEMACS = for NEMACS (or NEpoch)
76 MULE1 = for Mule 1.* (based on Emacs 18.*)
77 ORIG19 = for Emacs 19.* (FSF original or XEmacs)
78 MULE2 = for MULE 2.* (based on Emacs 19.*)
80 4.1.2 specify Emacs Lisp install path
82 Please specify Emacs Lisp install path.
84 TLDIR18 = for Emacs 18.* (NEMACS, NEpoch or MULE 1)
85 TLDIR19 = for Emacs 19.* (FSF original, XEmacs or MULE 2)
90 Edit external methods in `methods/' directory for your environment.
103 4.5 Emacs Lisp modules
105 Run `make install-nemacs', if you use NEmacs.
107 Run `make install-mule1', if you use Mule 1.* (based on Emacs 18.*).
109 Run `make install-orig19', if you use Original Emacs 19.* or XEmacs.
111 Run `make install-mule2', if you use Mule 2.* (based on Emacs 19.*).
113 Or copy *.el to your emacs lisp directory.
120 (1) Please edit gnus/Makefile
124 Run `make gnus3', if you use GNUS 3.*.
126 Run `make gnus4', if you use GNUS 4.*.
128 Run `make dgnus', if you use (ding) GNUS.
132 Run `make install-18', if you use Emacs 18.*.
134 Run `make install-19', if you use Emacs 19.*.
139 If you want to use automatic MIME preview support, please apply a
140 patch to (ding) GNUS. This patch is called `with tm patch'. It is
141 available from ftp.jaist.ac.jp:/pub/GNU/elisp/dgnus/. Current version
142 is dgnus-0.98.7-tm.diff.
147 (1) Please edit mh-e/Makefile
151 Run `make nemacs', if you use NEmacs.
153 Run `make mule1', if you use Mule 1.* (based on Emacs 18.*).
155 Run `make orig19', if you use Original Emacs 19.* or XEmacs.
157 Run `make mule2', if you use Mule 2.* (based on Emacs 19.*).
161 Run `make install-18', if you use Emacs 18.*.
163 Run `make install-19', if you use Emacs 19.*.
168 Please insert (load "mime-setup") or (load "tm-setup") in .emacs. If
169 you use mime-setup, you should prepare mime.el.
173 If you want use vm, please insert following in .vm or .emacs:
179 In XEmacs, current mime.el can not work, so you should use tm-setup.el
180 and another MIME composer, such as mime-compose.el. Following is a
184 ;; (require 'mh-e) ; if you use mh-e, please use it.
185 (load "mime-compose")
187 6.3 setting sample for hilit19
189 ======================================================================
191 (let* ((header-patterns '(("^Subject:.*$" nil msg-subject)
192 ("^From:.*$" nil msg-from)
193 ("^--text follows this line--$"
195 ("^[A-Za-z][A-Za-z0-9-]+:" nil msg-header)
197 (body-patterns '(("^\\(In article\\|[ \t]*\\w*[]<>}|]\\).*$"
199 (message-patterns (append header-patterns body-patterns))
201 (hilit-set-mode-patterns 'msg-header header-patterns)
202 (hilit-set-mode-patterns 'msg-body body-patterns)
203 (hilit-set-mode-patterns 'mime/viewer-mode
205 'hilit-rehighlight-message)
207 (add-hook 'mime-viewer/content-header-filter-hook
208 (function hilit-rehighlight-buffer-quietly))
209 (add-hook 'mime-viewer/plain-text-preview-hook
210 (function hilit-rehighlight-buffer-quietly))
212 ======================================================================
215 7 How to use mime/viewer-mode
217 In tm-MUAs, you can use mime/viewer-mode if you press `v' key (in VM,
218 `Z' key) in Summary mode. mime/viewer-mode has following functions:
220 q quit from mime/viewer-mode
221 u move to the upper content
222 p move to the previous content
223 n move to the next content
227 e extract as file the content
228 C-c C-p print the content
233 If you write bug-reports and/or propositions for improvement, please
234 post them to following news groups:
236 fj.editor.emacs (Japanese or English)
237 fj.editor.mule (Japanese or English; if you use Mule)
238 gnu.emacs.help (English)
239 gnu.emacs.vm.info (English; about tm-vm)
243 tm@chamonix.jaist.ac.jp (Japanese or English)
244 tm-eng@chamonix.jaist.ac.jp (English)
246 Via tm ML, You can report bugs of tm, obtain the latest release of tm
247 package, and discuss the future enhancements to tm. To join tm ML,
250 tm-admin@chamonix.jaist.ac.jp (Japanese or English)
251 tm-eng-admin@chamonix.jaist.ac.jp (English)
253 Since the user registration is manually done, please write the mail
254 body in human-recognizable language (^_^).
259 - better XEmacs support (i.e. richtext filter or inline image)
260 - multi frame support
261 - improvement of tiny-mime
262 - better uuencode support
263 - development of internal method for message/external-body based on
265 - development good MIME composer