[README for tm (English Version)]
by MORIOKA Tomohiko <morioka@jaist.ac.jp>
-$Id: README.eng,v 6.4 1995/08/31 14:22:04 morioka Exp $
+and KOBAYASHI Shuhei <shuhei@cmpt01.phys.tohoku.ac.jp>
+$Id: README.eng,v 7.4 1995/12/06 09:21:07 morioka Exp $
1 What's tm?
-Tm is a MIME package for GNU Emacs. Tm has following functions:
+ 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
+ - MIME message composer (mime/editor-mode)
+ - MIME extenders for mh-e, GNUS, RMAIL and VM
2 Documents
-This package includes following 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/tiny-mime-eng.ol : tiny-mime.el Reference Manual (Emacs Outline)
-- doc/tiny-mime-eng.tex : tiny-mime.el Reference Manual (LaTeX)
-- rel-6eng.ol : notice about major changes of tm 6.* (Emacs Outline)
+- tm/doc/tm_en.texi : tm Reference Manual (TeXinfo)
+- tm/doc/tm-view_en.texi: tm-view Reference Manual (TeXinfo)
+- tm/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.tex : tm-view Reference Manual (TeXinfo)
-- doc/tm-eword_ja.texi : tiny-mime.el Reference Manual (TeXinfo)
-- doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline)
-- doc/signature-jp.tex : signature.el Reference Manual (LaTeX)
-- rel-6jp.ol : notice about major changes of tm 6.* (Emacs Outline)
+- tm/doc/tm_ja.tex : tm Reference Manual (TeXinfo)
+- tm/doc/tm-view_ja.texi : tm-view Reference Manual (TeXinfo)
+- tm/doc/tm-gnus_ja.texi : tm-gnus Reference Manual (TeXinfo)
+- tm/doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline)
+- tm/doc/signature-jp.tex: signature.el Reference Manual (LaTeX)
3 Modules
-Tm has following modules:
+ tm has following modules:
- - tiny-mime : MIME header encoder/decoder
- tm-view : MIME viewer
- - tm-misc : library module for tm-MUAs
+ - tm-parse.el : MIME message parser
+ - tm-play.el : MIME content player
+ - tm-ew-d.el : MIME encoded-word decoder
+ - 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-file : for file extraction
+ - tm-tar : for tar content
+ - tm-latex : for LaTeX
+ - tm-html : for text/html
+ - tm-edit : MIME composer (mime.el and tm-comp.el were merged)
+ - 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
- - extender for tm-view
- - tm-partial : automatic assembler for message/partial
- - tm-ftp : for anonymous ftp
- - tm-rich : for text/enriched and text/richtext
- - tm-comp : extender for mime.el (big message automatic
- splitter, previewer using tm-view, uuencode
- supporter)
- - tm-setup: set up module for tm-MUAs
+ - tm-mail : tm-MUA library module for mail-mode
- mime-setup: set up module for MIME
+ - tm-setup: set up only reading
4 Install
-4.0 install tl
-
-Tm uses Emacs Lisp library ``tl'', so, at first, you install
-tl. Please read tl/README.eng.
-
-
-4.1 Makefile
-
- Please edit Makefile.
-
-4.1.1 specify Emacs executables
-
- Please specify Emacs executable file name.
-
- NEMACS = for NEMACS (or NEpoch)
- MULE1 = for Mule 1.* (based on Emacs 18.*)
- ORIG19 = for Emacs 19.* (FSF original or XEmacs)
- MULE2 = for MULE 2.* (based on Emacs 19.*)
-
-4.1.2 specify Emacs Lisp install path
+4.1 tm/config.tm
- Please specify Emacs Lisp install path.
-
- TLDIR18 = for Emacs 18.* (NEMACS, NEpoch or MULE 1)
- TLDIR19 = for Emacs 19.* (FSF original, XEmacs or MULE 2)
+ Please edit tm/config.tm file.
4.2 External methods
- Edit external methods in `methods/' directory for your environment.
+ Please edit external methods in `tm/methods/' directory for your
+environment.
+
+ tm/methods/tm-au for audio
+ tm/methods/tm-file for file extraction
+ tm/methods/tm-image for image
+ tm/methods/tm-mpeg for MPEG
+ tm/methods/tm-plain for plain text
+ tm/methods/tm-html for HTML
+ tm/methods/tmdecode decoder
4.3 make
4.5 Emacs Lisp modules
- Run `make install-nemacs', if you use NEmacs.
+ Run `make install-18', if you use Emacs 18 (NEmacs, Mule 1.*).
- Run `make install-mule1', if you use Mule 1.* (based on Emacs 18.*).
+ Run `make install-xemacs', if you use Emacs .. 19.28 (Mule 2.* based
+on), or XEmacs.
- 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.*).
+ Run `make install-19_29', if you use Emacs 19.29 or later (Mule 2.*
+based on).
Or copy *.el to your emacs lisp directory.
5.1 tm-gnus
-(1) Please edit gnus/Makefile
+ If you use optional GNUS or Gnus, you must edit and make manually.
+
+(1) Please edit tm/gnus/Makefile.
+
+ If you use Emacs 18.* and GNUS 3.*, please edit tm/gnus/g3-path.
+
+ If you use Emacs 18.* and GNUS 4.*, please edit tm/gnus/g4-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 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.*.
+ Run `make install-19', if you use Emacs .. 19.28 or XEmacs.
+ Run `make install-19_29', if you use Emacs 19.29 or later.
-5.1.1 (ding) GNUS
- If you want to use automatic MIME preview support, please apply a
-patch to (ding) GNUS. This patch is called `with tm patch'. It is
-available from ftp.jaist.ac.jp:/pub/GNU/elisp/dgnus/. Current version
-is dgnus-0.99.23-tm.diff.
+5.1.1 automatic MIME preview support
+ tm-gnus provides automatic MIME preview feature for GNUS 3.15 or
+later, Gnus 5.0.*, Gnus 5.1, and September Gnus.
-5.1 tm-mh-e
+ If you don't want to use automatic MIME preview feature, please
+insert following to ~/.emacs.
-(1) Please edit mh-e/Makefile
+ (setq tm-gnus/automatic-mime-preview nil)
-(2) make
+ In addition, September Gnus has automatic MIME preview supporting
+feature. Of course, tm-gnus provide this feature for other GNUS and
+Gnus, but it is unnatural.
+
+ When automatic MIME preview mode, GNUS and Gnus do MIME processing
+if a message has a Mime-Version field. If it does not have, GNUS and
+Gnus does not do MIME processing, in default.
- Run `make nemacs', if you use NEmacs.
+ Gnus 5.0.*, 5.1 and September Gnus have a variable
+`gnus-strict-mime'. If you insert
- Run `make mule1', if you use Mule 1.* (based on Emacs 18.*).
+ (setq gnus-strict-mime nil)
- Run `make orig19', if you use Original Emacs 19.* or XEmacs.
+Gnus do MIME processing even if a message does not have Mime-Version
+field.
- Run `make mule2', if you use Mule 2.* (based on Emacs 19.*).
+ In September Gnus, if `gnus-strict-mime' is not nil, variable
+`gnus-decode-encoded-word-method' is called. tm-gnus uses it to decode
+RFC 1522 encoded-word. So it is not necessary to reset
+`gnus-strict-mime'.
+
+
+5.2 tm-mh-e
+
+ If you use optional mh-e, you must edit and make manually.
+
+(1) Please edit mh-e/Makefile
+
+(2) make
+
+ Run `make elc'.
(3) install
Run `make install-19', if you use Emacs 19.*.
+* 5.3 VM
-6 .emacs
+ If you use VM, please edit `mk-tm'.
-Please insert (load "mime-setup") or (load "tm-setup") in .emacs. If
-you use mime-setup, you should prepare mime.el.
-6.1 VM
+6 .emacs
-If you want use vm, please insert following in .vm or .emacs:
+ Please insert (load "mime-setup") in ~/.emacs.
- (load "tm-vm")
+6.1 VM
-6.2 XEmacs
+ If you use vm, please insert (require 'tm-vm) in ~/.vm.
-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:
+ tm works well with BBDB: If you use VM, please insert
+(require 'tm-vm) *after* (bbdb-insinuate-vm).
- (load "tm-setup")
- ;; (require 'mh-e) ; if you use mh-e, please use it.
- (load "mime-compose")
-6.3 setting sample for hilit19
+6.2 setting sample for hilit19
======================================================================
(cond (window-system
))
======================================================================
+6.3 setting sample for browse
+
+ If you have browse-url.el (included in Gnus 5.*, September Gnus and
+Emacs 19.30 or later), you can use URL button in
+mime/viewer-mode. Following is setting sample:
+
+======================================================================
+(setq browse-url-browser-function
+ (if (eq window-system 'x)
+ 'browse-url-netscape
+ 'browse-url-w3))
+(autoload browse-url-browser-function "browse-url"
+ "Ask a WWW browser to show a URL." t)
+======================================================================
+
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 the upper content
- p move to the previous content
- n move to the next content
- SPC scroll up
- M-SPC scroll down
- v play the content
- e extract as file the content
- C-c C-p print the content
+`Z' key) in Summary mode. Or automatic MIME previewed buffer's
+major-mode is mime/viewer-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 or browse URL
8 Bug report
fj.editor.emacs (Japanese or English)
fj.editor.mule (Japanese or English; if you use Mule)
gnu.emacs.help (English)
+
+ fj.news.reader.gnus (Japanese or English; about GNUS and Gnus)
+ gnu.emacs.gnus (English; about GNUS and Gnus)
+
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)
+ bug-tm-en@chamonix.jaist.ac.jp (English)
+ bug-tm-ja@chamonix.jaist.ac.jp (Japanese)
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,
body in human-recognizable language (^_^).
-9 TODO
+9 How to get new version
+
+tm is available from following anonymous ftp site:
+
+ ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime/ (Japan)
+
+and its mirrors:
+
+ ftp://ftp.nis.co.jp/pub/gnu/emacs-lisp/tm/ (Japan)
+ ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/ (US)
+
+
+10 TODO
-- better XEmacs support (i.e. richtext filter or inline image)
-- multi frame support
-- improvement of tiny-mime
-- better uuencode support
+- 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.
projects / elisp / tm.git / blobdiff