tm 7.33.
[elisp/tm.git] / doc / tm_en.texi
index 79d0c18..6b8025c 100644 (file)
@@ -6,26 +6,33 @@
 @titlepage
 @title tm Manual (English Version)
 @author by MORIOKA Tomohiko
-@code{$Id: tm_en.texi,v 7.2 1995/10/18 18:14:25 morioka Exp $}
+@code{$Id: tm_en.texi,v 7.3 1995/12/13 09:26:11 morioka Exp morioka $}
 @end titlepage
 
 
 @node Top, Introduction, (dir), (dir)
 @comment  node-name,  next,  previous,  up
 @ifinfo
-@top tm 7.16 Reference manual
+@top tm 7.32 Reference manual
 @end ifinfo
 
 @menu
-* Introduction::              What is tm?
-* Emacs Versions::            Differences between each emacs variants.
-* Install::
+* Introduction::   What is tm?
+* Emacs Versions:: Differences between each emacs variants.
 * Setting::
-* tm-MUA::                    Extension of mh-e, GNUS, RMAIL and VM
-* tm-view: (tm-view_en.info). MIME message navigator.
-* encoded-word::              
-* 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.
+* 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::
@@ -41,8 +48,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
 
@@ -55,8 +62,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
@@ -67,13 +74,11 @@ The tm package includes the modules listed below.
 @end itemize
 
 @menu
-* tiny-mime:(tm-eword_en.info).
-* tm-view:(tm-view_en.info).
+* tm-view::
 * 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
 
 
@@ -115,75 +120,7 @@ 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.
-
-
-@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.
+In future, we will support inline image.
 
 
 @node Setting, tm-MUA, Install, Top
@@ -197,9 +134,9 @@ related setup including MIME encoding using mime.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
 
@@ -213,18 +150,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.
+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.
 
-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:
-
-@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
@@ -238,7 +169,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
@@ -317,9 +248,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")
@@ -330,12 +262,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
@@ -345,7 +280,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, encoded-word, Setting, Top
+@node tm-MUA, tm-view, Setting, Top
 @comment  node-name,  next,  previous,  up
 @chapter tm-MUA
 @cindex tm-MUA
@@ -373,15 +308,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} is displays
+automatically in default setting.
 
 @menu
 * tm-mh-e: (tm-mh-e_en.info).
@@ -389,66 +324,17 @@ 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 encoded-word, Bug report, tm-MUA, Top
-@comment  node-name,  next,  previous,  up
-@chapter encoded-word
-@cindex encoded-word
-@cindex non-ASCII field
-@cindex message header
-
-tm has functions about encoded-word defined in RFC 1522.
-
-@menu
-* decode: (tm-view_en.info)encoded-word. decode
-* encoded-word encoding::                encode
-* encoded-word utility::
-@end menu
-
-
-@node encoded-word encoding, encoded-word utility, encoded-word, encoded-word
-@comment  node-name,  next,  previous,  up
-@section encoded-word encoding
-
-@deffn{Command} mime/decode-message-header
-
-It encodes message header of current buffer.
-@end deffn
-
-
-@deffn{Function} mime/encode-field str
-
-It encodes @var{str} as a field.
-@end deffn
-
-
-@deffn{Function} mime-eword/encode-string str &optional column mode
-
-It encodes @var{str}.
-
-@var{column} specifies start column. Default value is 0.
-
-@var{mode} specifies where @var{str} is in. Available values are
-@code{text}, @code{comment}, @code{phrase}. Default value is
-@code{phrase}.
-@end deffn
-
-
-@node encoded-word utility,  , encoded-word encoding, encoded-word
-@comment  node-name,  next,  previous,  up
-@section encoded-word utility
+@include tm-view_en.texi
 
-@deffn{Function} mime/exist-encoded-word-in-subject
+@include tm-ew_en.texi
 
-If there are encoded-words in Subject: field in current buffer,
-it returns field-body of the Subject: field.
-@end deffn
+@include tm-util_en.texi
 
 
-@node Bug report, Concept Index, encoded-word, Top
+@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