-*-tm manual-*-
tm manual

GNU Emacs で MIME を楽しむための package である `tm' について説明します。

tm とは

tm は GNU Emacs で MIME を楽しむための package です。tm を使うと、

  * tm-view による MIME message の閲覧・再生

  * tiny-mime による多言語 header の encode/decode

  * mh-e, GNUS, RMAIL, VM での MIME 機能の強化

というようなことが行なえます。

Module 一覧

tm は以下の module からなります。

  * tiny-mime: MIME header encoder/decoder

  * tm-view:   MIME viewer

  * tm-misc: tm-MUA の共通 module

  * tm-mh-e:  mh-e 用の tm-MUA

  * tm-gnus:  GNUS 用の tm-MUA

  * tm-rmail: RMAIL 用の tm-MUA

  * tm-vm:    VM 用の tm-MUA

  * tm-setup: tm-MUA 全般の設定 module

  * mime-setup: MIME 関係全般の設定 module

Emacs version 別の機能および制限

original GNU Emacs 18

動作は保証しません。しかしながら、US-ASCII の範囲では動作すると思われます。

NEmacs, NEpoch

ISO-2022-JP, US-ASCII が使えます。

original GNU Emacs 19

US-ASCII および ISO-8859-1 をサポートします。

また、X window 上の独立した window として動作させる場合、tm-rich による multi face 表示が行なえます。

Mule

ISO-2022-JP, US-ASCII, ISO-8859-1..9, ISO-2022-CN, ISO-2022-KR, EUC-KR などの多くの charset をサポートします。また、関数 mime/set-charset-and-encoding で追加・変更ができます。

また、Mule 2.* を X window 上の独立した window として動作させる場合、 tm-rich による multi face 表示が行なえます。

XEmacs

US-ASCII および ISO-8859-1 をサポートします。

今のところ、tm-rich による multi face 表示はサポートされていませんが、将来的には、multi face 表示と inline image の表示がサポートされる予定です。

Install

Install は次の手順で行ないます。

tl の install

tm は Emacs Lisp library ``tl'' を利用しています。よって、まず最初に、これを install して下さい。

tl の install の仕方は tl/README.eng に書いてありますので、これを読んで適切に install して下さい。

Makefile

Makefile を自分の環境に合わせて書き換えて下さい。

Emacs の実行 file 名の指定

Emacs の実行 file 名を指定して下さい。

  * 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.*)

load-path の指定

Emacs Lisp program を install する directory を指定して下さい。

  * TLDIR18 = for Emacs 18.* (NEMACS, NEpoch or MULE 1)

  * TLDIR19 = for Emacs 19.* (FSF original, XEmacs or MULE 2)

外部 method

methods/ 以下にある method script を sec:method 節を参照して、自分の環境に合うように書き換えて下さい。

make

`make all' して下さい。

install

`make install' して下さい。

Emacs Lisp program の install

NEmacs もしくは NEpoch を使っている場合、`make install-nemacs' を実行して下さい。

Mule 1.* を使っている場合、`install-mule1' を実行して下さい。

Original Emacs 19.* もしくは XEmacs を使っている場合、`make install-orig19' を実行して下さい。

Mule 2.* を使っている場合、`make install-mule2' を実行して下さい。

あるいは、これらがうまくいかなかった場合でも、*.el を load-path で指定された directory に copy すれば OK です。

設定

この package には mime-setup.el と tm-setup.el という簡易設定 file が附属しています。mime-setup.el では encoding も含めた MIME 全般の設定を行ない、tm-setup では tm-MUA に関する設定のみを行ないます。

mime-setup

     (load "mime-setup")

とすると MIME に関する各種設定を行ないます。mime-setup は tm-setup を読んでいるので、mime-setup を使う場合、tm-setup を load する必要はありません。

mime-setup では signature の自動切替え tool も附属しています。 message header の field に合わせて signature の自動切替を行ないたい場合は .emacs に以下のようなものを入れて下さい。（詳しくは signature.el の説明書を参照して下さい）

     (setq signature-file-alist
           '((("Newsgroups" . "jokes")       . "~/.signature-jokes")
             (("Newsgroups" . ("zxr" "nzr")) . "~/.signature-sun")
             (("To" . ("ishimaru" "z-suzuki")) . "~/.signature-sun")
             (("To" . "tea")                 . "~/.signature-jokes")
             (("To" . ("sim" "oku" "takuo")) . "~/.signature-formal")
             ))

mime-setup を使う場合は、mime.el が必要です。また、SuperCite を使う場合は、SuperCite も必要です。

tm-setup

tm-setup は tm-MUA の設定のみを行なう module です。mime-setup を load している場合、これを陽に load する必要はありませんが、mime-setup を使いたくない場合、以下のようにこれを load して下さい。

     (load "tm-setup")

vm

vm を使う場合は .vm か .emacs に

     (load "tm-vm")

を入れて下さい。

設定 file を使わない場合

tm-setup.el を参考にして下さい。

tm-MUA

``tm-MUA'' というのは、mh-e, GNUS, RMAIL などの MUA のための MIME 機能強化 module の総称です。

現在、tm-MUA には、

  * tm-mh-e:  mh-e 用の tm-MUA

  * tm-gnus:  GNUS 用の tm-MUA

  * tm-rmail: RMAIL 用の tm-MUA

  * tm-vm:    VM 用の tm-MUA

があります。この章ではこれらの module に関して説明します。

Summary mode

tm-MUA を使うと、元の MUA の Summary mode に対して以下の機能が追加されます。

M-t
     RFC 1522 MIME encoded-word の decode に関する toggle

v
     mime/viewer-mode に入り、message を閲覧する

mime/viewer-mode

tm-MUA を使うと、Summary mode で v（vm では Z）を押すことによって、mime/viewer-mode という MIME message を閲覧するための mode に入ります。mime/viewer-mode には以下の機能があります。

u
     上の content に戻る（message の一番上の content でこれを行なうと Summary mode に戻る (*1)）

p
     前の content に移動する

n
     次の content に移動する

SPC
     scroll up する

M-SPC
     scroll down する

DEL
     scroll down する

RET
     次の行に移動する

M-RET
     前の行に移動する

v
     content を再生する           (*2)

e
     content から file を取り出す (*2)

C-c C-p
     content を印刷する           (*2)

［注意］

 1. tm-MUA で tm-view の設定をしていない場合、Summary mode には戻りません。

 2. 実際の動作は対応する method に依ります。