-*-tm manual-*-
tm manual

tm 7.32 Reference manual
************************

This file documents tm, a MIME package for GNU Emacs.

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

tm とは
*****

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

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

  * tm-edit による MIME message の作成

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

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

Module 一覧
=========

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

  - tm-view:   MIME viewer

  - tm-edit:   MIME composer

  - tm-def:    tm のための定義 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 の種類別の機能および制限
******************

original GNU Emacs 18 and Epoch
===============================

動作は保証しません。しかしながら、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 をサポートします。

将来的には、inline image の表示がサポートされる予定です。

設定
**

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

mime-setup.el
=============

tm の一般的な設定を行いたい場合は、mime-setup.el という標準設定 file を使ってください。例えば、~/.emacs 等で、

     (load "mime-setup")

とするだけで OK です。

mime-setup.el は tm-setup.el を呼んでいるので、tm-setup.el を load する必要はありません。（過去の Gnus FAQ の記述は間違っています！）

Memo: あるいは、September Gnus に付属している gnus-setup.el を使っても良いかも知れません。これは tm も含めた各種の設定を行ってくれます。 default で tm を使う事になっているので

     (load "gnus-setup")

とすると mime-setup.el を load する必要はないでしょう。

mime-setup.el の変数
-----------------

SuperCite
.........

 -- Variable: mime-setup-use-sc

     この変数が nil 以外の時、sc-setup.el を使って SuperCite の設定を行ないます。既定値は nil です。なお、SuperCite を使う場合は、SuperCite も必要です。

signature
.........

tm には signature の自動切替え tool が附属しており、mime-setup.el はこの設定も行ないます。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")
             ))

 -- Variable: mime-setup-use-signature

     この変数が nil 以外の時、signature.el を使います。既定値は t です。

 -- Variable: mime-setup-signature-key-alist

     各 major-mode において signature 挿入命令を設定すべき key を指定します。既定値は

          	((mail-mode . "\C-c\C-w"))

     です。

     これを変更したい場合は、関数 set-alist などを使ってこの変数を書き換えて下さい。

          (set-alist 'mime-setup-signature-key-alist 'news-reply-mode "\C-c\C-w")

 -- Variable: mime-setup-default-signature-key

     ある major-mode において signature 挿入命令を設定すべき key が見つからない場合、この変数に設定された key が用いられます。既定値は、 ``\C-c\C-s'' です。

GNUS の場合の注意
-----------

signature.el を使う場合、mime-setup.el は変数 gnus-signature-file を nil に設定します。よって、送信時に自動的に signature が付く機能は抑制されます。このようなことをしているのは以下の理由からです。

GNUS が signature を付けるのは tm-edit.el によって MIME message が作成された後です。よって、GNUS が付けた signature は MIME message として正しく処理されていません。例えば multipart message の場合、MIME message の外の非 MIME part に付きます。よって、MIME 対応 MUA で見た場合、 signature は表示されないかも知れません。

もう一つの注意は標準設定では signature を挿入する key は C-c C-w ではなく mh-e と同じ C-c C-s に割り当てられていることです。これは

     (set-alist 'mime-setup-signature-key-alist 'news-reply-mode "\C-c\C-w")

によって GNUS の標準に戻すことができます。

tm-setup.el
===========

tm-setup は tm-MUA の設定のみを行なう module です。この設定 file では tm-edit を使った MIME message の作成に関する設定は行われず、MIME message の閲覧に関する設定のみが行われます。MIME message を読みたいが自分では作成しないとか、tm-edit 以外の MIME composer を使いたい場合には mime-setup.el の代わりにこの設定 file を使ってください。

例えば、~/.emacs 等に

     (load "tm-setup")

を入れれば OK です。

Memo: mime-setup.el を load している場合、これを陽に load する必要はありません。

vm
==

vm を使う場合は ~/.vm に

     (require 'tm-vm)

を入れて下さい。

注意： BBDB を使う場合は (bbdb-insinuate-vm) の後に (require 'tm-vm) を入れてください。

設定 file を使わない場合
===============

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

Memo: 現在の tm では tm-edit の使用を仮定した幾つかの便利な機能が存在し、これらの機能は mime-setup.el を使わないと利用できません。もし、 tm-edit を使う独自の設定を行う場合は、

     (provide 'mime-setup)

という宣言を行ってください。

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
     MIME message の表示に関する toggle

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

但し、tm-vm では v ではなく Z で mime/viewer-mode に入ります。また、tm-mh-e, tm-vm, および、GNUS 3.15 以降での tm-gnus では automatic MIME preview 機能が support され、標準では常に mime/viewer-mode の preview buffer が表示されます。

MIME forwarding
===============

mime-setup.el を使っている場合、message/rfc822 形式による forward が support されます。

     [file tm-view=ja.texi not included]

     [file tm-edit=ja.texi not included]

     [file tm-ew=ja.texi not included]

     [file tm-util=ja.texi not included]

bug 報告の仕方と mailing list について
****************************

tm のバグを見つけたら fj.editor.emacs に post するか、以下の address に mail を送ってください：

  * 日本語

     <bug-tm@chamonix.jaist.ac.jp>

  * 英語

     <bug-tm-eng@chamonix.jaist.ac.jp>

tm ML では tm のバグ情報の交換や最新版の配布、tm の改良に関する議論を行なっています。tm ML に参加したい方は

  * Japanese or English

     <tm-admin@chamonix.jaist.ac.jp>

  * English

     <tm-eng-admin@chamonix.jaist.ac.jp>

まで mail を送って下さい。登録は手動ですので、できれば、自然言語で書いて下さい。(^_^)