tm 7.77.
[elisp/tm.git] / doc / tm_en.texi
index 77da73b..2bea890 100644 (file)
@@ -6,24 +6,37 @@
 @titlepage
 @title tm Manual (English Version)
 @author by MORIOKA Tomohiko
-@code{$Id: tm_en.texi,v 7.0 1995/10/04 15:16:13 morioka Exp $}
+@code{$Id: tm_en.texi,v 7.17 1996/05/15 19:31:39 morioka Exp morioka $}
 @end titlepage
 
 
 @node Top, Introduction, (dir), (dir)
+@top tm 7.32 Reference manual
+
 @comment  node-name,  next,  previous,  up
 @ifinfo
-@top tm 6.78 Reference manual
+This file documents tm, a MIME package for GNU Emacs.
+
 @end ifinfo
 
 @menu
 * Introduction::   What is tm?
 * Emacs Versions:: Differences between each emacs variants.
-* Install::
 * Setting::
-* tm-MUA::
-* tm-view: (tm-view_en.info).
-* Bug report:: How to report bug and about mailing list of tm.
+
+* tm-MUA::         Extension of mh-e, GNUS, RMAIL and VM
+* tm-mh-e: (tm-mh-e_en.info).   mh-e
+* tm-gnus: (tm-gnus_en.info).   GNUS and Gnus
+* tm-rmail: (tm-rmail_en.info). RMAIL
+* tm-vm: (tm-vm_en.info).       VM
+
+* tm-view::        MIME message navigator.
+* tm-edit::        MIME message composer.
+* encoded-word::   multi lingual characters in message header
+* customize::
+
+* Bug report::     How to report bug and about mailing list of tm.
+
 * Concept Index::
 * Command Index::
 * Variable Index::
@@ -39,8 +52,8 @@ The tm package is a set of modules to enjoy MIME on GNU Emacs.  Using tm,
 you can
 
 @itemize @bullet
-@item playback or view the MIME messages using mime/viewer-mode
-@item encode and decode the multi-lingual headers using tiny-mime
+@item playback or view the MIME messages using tm-view
+@item compose MIME message using tm-edit
 @item use the enhanced MIME features with mh-e, GNUS, RMAIL and VM
 @end itemize
 
@@ -53,8 +66,8 @@ and more.
 The tm package includes the modules listed below.
 
 @itemize @minus
-@item @strong{tiny-mime:} MIME header encoder/decoder
 @item @strong{tm-view:}   MIME viewer
+@item @strong{tm-edit:}   MIME composer
 @item @strong{tm-def:}    definition module for tm
         @item @strong{tm-mh-e:}  tm-MUA for mh-e
         @item @strong{tm-gnus:}  tm-MUA for GNUS
@@ -64,18 +77,8 @@ The tm package includes the modules listed below.
 @item @strong{mime-setup:} MIME setup module
 @end itemize
 
-@menu
-* tiny-mime:(tm-eword_en.info).
-* tm-view:(tm-view_en.info).
-* tm-mh-e:(tm-mh-e_en.info).
-* tm-gnus:(tm-gnus_en.info).
-* tm-rmail:(tm-rmail_en.info).
-* tm-vm:(tm-vm_en.info).
-* chain-mail:(tm-cmail_en.info).
-@end menu
-
 
-@node Emacs Versions, Install, Introduction, Top
+@node Emacs Versions, Setting, Introduction, Top
 @comment  node-name,  next,  previous,  up
 @chapter Considerations for each emacs variants
 @cindex Considerations for each emacs variants
@@ -99,7 +102,7 @@ messages.
 
 @section Mule
 
-Mule can handle the multi-lingual text.  With Mule, tiny-mime supports
+Mule can handle the multi-lingual text.  With Mule, tm supports
 ISO-2022-JP, ISO-2022-JP-2, US-ASCII, ISO-8859-1..9, ISO-2022-CN,
 ISO-2022-KR, EUC-KR, etc.  You can also add or change
 encoding/decoding for character sets by mime/set-charset-and-encoding
@@ -113,91 +116,23 @@ richtext messages.
 
 US-ASCII and ISO-8859-1 can be used if you use the XEmacs.
 
-In future, we will support multi face and inline image.
+In future, we will support inline image.
 
 
-@node Install, Setting, Emacs Versions, Top
-@comment  node-name,  next,  previous,  up
-@chapter Install
-@cindex Install
-
-You can install tm by following the procedures below.
-
-@section tl install
-
-tm requires the Emacs Lisp library ``tl'', so please install this at
-first.
-
-How to install tl is written in tl/README.eng.
-
-
-@section Makefile
-
-Please modify Makefile to your environment.
-
-@subsection Specification executable file name of emacs
-
-Please specify executable file name of emacs.
-
-@itemize @bullet
-@item NEMACS   = for NEMACS (or NEpoch)
-@item MULE1    = for Mule 1.* (based on Emacs 18.*)
-@item ORIG19   = for Emacs 19.* (FSF original or XEmacs)
-@item MULE2    = for MULE 2.* (based on Emacs 19.*)
-@end itemize
-
-@subsection Specification load-path
-
-Please specify directory to install Emacs Lisp program.
-
-@itemize @bullet
-@item TLDIR18 = for Emacs 18.* (NEMACS, NEpoch or MULE 1)
-@item TLDIR19 = for Emacs 19.* (FSF original, XEmacs or MULE 2)
-@end itemize
-
-
-@section External method
-
-Please modify method script in tm/methods/ to your environment.
-
-
-@section make
-
-Run `make all'.
-
-
-@section install
-
-Run `make install'.
-
-
-@section install Emacs Lisp program
-
-Run `make install-nemacs', if you use NEmacs or NEpoch.
-
-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.
-
-
-@node Setting, tm-MUA, Install, Top
+@node Setting, tm-MUA, Emacs Versions, Top
 @comment  node-name,  next,  previous,  up
 @chapter Setting
 @cindex Setting
 
 In the tm package, two files, mime-setup.el and tm-setup.el, are
-provided to ease the setup. A mime-setup.el is used for the whole MIME
-related setup including MIME encoding using mime.el, while tm-setup is
+provided to ease the setup. The mime-setup.el is used for the whole MIME
+related setup including MIME encoding using tm-edit.el, while tm-setup is
 used to set up tm-MUA only.
 
 @menu
-* mime-setup::
-* tm-setup::
-* tm-vm::
+* mime-setup::     normal setting
+* tm-setup::       setting not to use tm-edit
+* tm-vm::          setting for VM
 * manual setting::
 @end menu
 
@@ -211,18 +146,12 @@ used to set up tm-MUA only.
 (load "mime-setup")
 @end lisp
 
-will perform various settings of MIME.  As mime-setup loads
-tm-setup, you do not need to load tm-setup when you use mime-setup.
-
-mime-setup.el requires mime.el. mime.el is included in
-emacs-mime-tools.shar. It is available lots of anonymous-ftp sites,
-for example:
+will perform various settings of MIME.  As mime-setup.el loads
+tm-setup.el, you do not need to load tm-setup.el when you use
+mime-setup.el.
 
-@example
-       ftp://ftp.kyutech.ac.jp/pub/MultiMedia/mime
-       ftp://ftp.jaist.ac.jp/pub/GNU/elisp/mime
-@end example
 
+@subsection variable of mime-setup.el
 
 @subsection SuperCite
 @cindex SuperCite
@@ -236,7 +165,7 @@ If you set up SuperCite, you need the SuperCite package.
 @end defvar
 
 
-@subsection signature
+@subsubsection signature
 @cindex signature
 
 You can set up the "automatic signature selection tool" using
@@ -297,7 +226,7 @@ When mime-setup.el sets up for signature.el, it sets variable
 signature automatically when it is sending a message. Reason of this
 setting is following:
 
-GNUS inserts signature after mime.el composed as MIME
+GNUS inserts signature after tm-edit.el composed as MIME
 message. Therefore signature inserted by GNUS is not processed as a
 valid MIME part. In particular, for multipart message, signature
 places in outside of MIME part. So MIME MUA might not display it.
@@ -315,9 +244,10 @@ you change to GNUS's default, please set following:
 @comment  node-name,  next,  previous,  up
 @section tm-setup
 
-tm-setup only sets up tm-MUAs.  You do not need to explicitly load
-tm-setup if you are using mime-setup for your setup.  tm-setup is useful
-when you do not want to use mime-setup but want to set up tm-MUAs.
+tm-setup.el only sets up tm-MUAs.  You do not need to explicitly load
+tm-setup.el if you are using mime-setup.el for your setup.
+tm-setup.el is useful when you do not want to use mime-setup.el but
+want to set up tm-MUAs.
 
 @lisp
 (load "tm-setup")
@@ -328,12 +258,15 @@ when you do not want to use mime-setup but want to set up tm-MUAs.
 @comment  node-name,  next,  previous,  up
 @section vm
 
-If you use vm, please insert following in .vm:
+If you use vm, please insert following in ~/.vm:
 
 @lisp
-(load "tm-vm")
+(require 'tm-vm)
 @end lisp
 
+Notice: If you use BBDB, please insert @code{(require 'tm-vm)}
+@strong{after} @code{(bbdb-insinuate-vm)}.
+
 
 @node manual setting,  , tm-vm, Setting
 @comment  node-name,  next,  previous,  up
@@ -343,7 +276,7 @@ You may find the valuable hints in tm-setup.el if you want to set up
 MIME environment without loading the tm-provided setup files.
 
 
-@node tm-MUA, Bug report, Setting, Top
+@node tm-MUA, tm-view, Setting, Top
 @comment  node-name,  next,  previous,  up
 @chapter tm-MUA
 @cindex tm-MUA
@@ -371,15 +304,15 @@ Summary mode of the MUA.
 
 @table @kbd 
 @item @key{M-t}
-        toggles decoding of MIME headers
+toggles decoding of MIME headers
 @item @key{v}
-       enters @code{mime/viewer-mode} to view a message
+enters @code{mime/viewer-mode} to view a message
 @end table
 
 Notice: In tm-vm, key to enter @code{mime/viewer-mode} is @key{Z}
-instead of @key{v}. In tm-mh-e and tm-gnus for (ding) GNUS, preview
-buffer of @code{mime/viewer-mode} is displays automatically in default 
-setting.
+instead of @key{v}. In tm-mh-e, tm-vm and tm-gnus in Gnus 3.15 or
+later, preview buffer of @code{mime/viewer-mode} displays
+automatically in default setting.
 
 @menu
 * tm-mh-e: (tm-mh-e_en.info).
@@ -387,27 +320,34 @@ setting.
 * tm-rmail: (tm-rmail_en.info).
 * tm-vm: (tm-vm_en.info).
 * tm-cmail: (tm-cmail_en.info).
-* mime/viewer-mode: (tm-view_en.info)how-to-use.
 @end menu
 
 
-@node Bug report, Concept Index, tm-MUA, Top
+@include tm-view=en.texi
+
+@include tm-edit-en.texi
+
+@include tm-ew=en.texi
+
+@include tm-util=en.texi
+
+
+@node Bug report, Concept Index, customize, Top
 @comment  node-name,  next,  previous,  up
 @chapter How to report bug and about mailing list of tm
 @cindex bug report
 @cindex mailing list
 
-Please report tm bugs you find to fj.editor.emacs or send a mail to
-tm ML:
+Please report tm bugs you find to fj.editor.emacs or send a mail to:
 
 @itemize @bullet
 @item Japanese or English
 
-        <tm@@chamonix.jaist.ac.jp>
+        <bug-tm-ja@@chamonix.jaist.ac.jp>
 
 @item English
 
-        <tm-eng@@chamonix.jaist.ac.jp>
+        <bug-tm-en@@chamonix.jaist.ac.jp>
 @end itemize
 
 Via tm ML, You can report bugs of tm, obtain the latest release of tm
@@ -415,13 +355,13 @@ package, and discuss the future enhancements to tm.  To join tm ML,
 send a mail to
 
 @itemize @bullet
-@item Japanese or English
+@item Japanese
 
-        <tm-admin@@chamonix.jaist.ac.jp>
+        <tm-ja-admin@@chamonix.jaist.ac.jp>
 
 @item English
 
-        <tm-eng-admin@@chamonix.jaist.ac.jp>
+        <tm-en-admin@@chamonix.jaist.ac.jp>
 @end itemize
 
 Since the user registration is manually done, please write