tm 7.102.
[elisp/tm.git] / README.en
index 1e92bc7..0cd7fa5 100644 (file)
--- a/README.en
+++ b/README.en
@@ -1,7 +1,7 @@
 [README for tm (English Version)]
 by MORIOKA Tomohiko <morioka@jaist.ac.jp>
 and KOBAYASHI Shuhei <shuhei-k@jaist.ac.jp>
-$Id: README.en,v 7.24 1996/10/14 09:33:14 morioka Exp $
+$Id: README.en,v 7.28 1997/01/30 11:40:09 morioka Exp $
 
 1 What's tm?
 
@@ -19,17 +19,57 @@ $Id: README.en,v 7.24 1996/10/14 09:33:14 morioka Exp $
 
 (1) English edition
 
-- tm/doc/tm_en.texi    : tm Reference Manual (TeXinfo)
-- tm/doc/tm-gnus_en.texi: tm-gnus Reference Manual (TeXinfo)
-- tm/doc/tm-mh-e_en.texi: tm-mh-e Reference Manual (TeXinfo)
+- SGML (sinfo)
+  - tm/doc/tm-en.sgml          : tm Reference Manual
+  - tm/doc/tm-view-en.sgml     : tm-view Reference Manual
+  - tm/doc/tm-edit-en.sgml     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-en.sgml    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-en.sgml        : gnus-mime Reference Manual
+
+- Texinfo
+  - tm/doc/tm-en.texi          : tm Reference Manual
+  - tm/doc/tm-view-en.texi     : tm-view Reference Manual
+  - tm/doc/tm-edit-en.texi     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-en.texi    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-en.texi        : gnus-mime Reference Manual
+  - tm-vm/tm-vm_en.texi                : tm-vm Reference Manual
+
+- info
+  - tm/doc/tm-en.info          : tm Reference Manual
+  - tm/doc/tm-view-en.info     : tm-view Reference Manual
+  - tm/doc/tm-edit-en.info     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-en.info    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-en.info        : gnus-mime Reference Manual
+  - tm-vm/tm-vm_en.info                : tm-vm Reference Manual
 
 (2) Japanese edition
 
-- tm/doc/tm_ja.tex      : tm Reference Manual (TeXinfo)
-- tm/doc/tm-gnus_ja.texi : tm-gnus Reference Manual (TeXinfo)
-- tm/doc/tm-mh-e_ja.texi : tm-mh-e Reference Manual (TeXinfo)
-- tm/doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline)
-- tm/doc/signature-jp.tex: signature.el Reference Manual (LaTeX)
+- SGML (sinfo)
+  - tm/doc/tm-ja.sgml          : tm Reference Manual
+  - tm/doc/tm-view-ja.sgml     : tm-view Reference Manual
+  - tm/doc/tm-edit-ja.sgml     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-ja.sgml    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-ja.sgml        : gnus-mime Reference Manual
+
+- Texinfo
+  - tm/doc/tm-ja.texi          : tm Reference Manual
+  - tm/doc/tm-view-ja.texi     : tm-view Reference Manual
+  - tm/doc/tm-edit-ja.texi     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-ja.texi    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-ja.texi        : gnus-mime Reference Manual
+
+- info
+  - tm/doc/tm-ja.info          : tm Reference Manual
+  - tm/doc/tm-view-ja.info     : tm-view Reference Manual
+  - tm/doc/tm-edit-ja.info     : tm-edit Reference Manual
+  - tm-mh-e/tm-mh-e-ja.info    : tm-mh-e Reference Manual
+  - gnus-mime/gnus-mime-ja.info        : gnus-mime Reference Manual
+
+- other format
+  - tm/doc/signature-jp.ol : signature.el Reference Manual (Emacs Outline)
+  - tm/doc/signature-jp.tex: signature.el Reference Manual (LaTeX)
+  - tm/doc/tm-charset_ja.ol: How to use character codes in tm (Emacs Outline)
+  - tm/doc/tm-charset_ja.tex: How to use character codes in tm (LaTeX)
 
 
 3 Modules
@@ -53,13 +93,16 @@ $Id: README.en,v 7.24 1996/10/14 09:33:14 morioka Exp $
                - tm-pgp     : for PGP
        - tm-edit : MIME composer (mime.el and tm-comp.el were merged)
                - tm-ew-e.el : MIME encoded-word encoder
+               - tm-edit-mc.el : tm-edit interface for Mailcrypt
+               - tm-edit-tipgp.el : tm-edit interface for TinyPgp.el
        - tm-def  : definition module for 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
-               - tm-mail  : tm-MUA library module for mail-mode
+               - tm-mh-e   : tm-MUA for mh-e
+               - gnus-mime : tm-MUA for Gnus
+               - tm-gnus   : tm-MUA for GNUS
+               - tm-rmail  : tm-MUA for RMAIL
+               - tm-vm     : tm-MUA for vm
+               - tm-mail   : tm-MUA library module for mail-mode
        - mime-setup: set up module for MIME
                - tm-setup: set up only reading
 
@@ -74,21 +117,7 @@ $Id: README.en,v 7.24 1996/10/14 09:33:14 morioka Exp $
 please modify the variables `PREFIX' and `EXEC_PREFIX'.
 
 
-4.2 tm-gnus (optional)
-
-  If you use optional GNUS or Gnus, which is not included in the Emacs
-distribution, you must edit the following files before running make.
-
-    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.[01].*, please edit tm/gnus/g5-path.
-
-    If you use Gnus 5.2.*, please edit tm/gnus/s-path.
-
-
-4.3 edit external methods (optional)
+4.2 edit external methods (optional)
 
   You can edit external methods in `tm/methods/' directory for your
 environment.
@@ -107,7 +136,7 @@ ftp://thumper.bellcore.com/pub/nsb).  If you don't have the metamail
 package, please modify tmdecode to use decode-b instead of mmencode.
 
 
-4.4 make
+4.3 make
 
   Run `make all'.
 
@@ -117,7 +146,7 @@ package, please modify tmdecode to use decode-b instead of mmencode.
        % make all EMACS=mule
 
 
-4.5 install
+4.4 install
 
   Run `make install'.
 
@@ -132,25 +161,24 @@ package, please modify tmdecode to use decode-b instead of mmencode.
   Please insert `(load "mime-setup")' in ~/.emacs.
 
 
-6.1 automatic MIME preview support
+6.1 gnus-mime
 
-  tm-gnus provides automatic MIME preview feature for GNUS 3.15 or
-later, Gnus 5.0.*, Gnus 5.1, and Gnus 5.2.
+  gnus-mime provides automatic MIME preview feature for Gnus.
 
   If you don't want to use automatic MIME preview feature, please
 insert in ~/.emacs:
 
-       (setq tm-gnus/automatic-mime-preview nil)
+       (setq gnus-show-mime nil)
 
-  In addition, Gnus 5.2 has automatic MIME preview supporting feature. 
-Of course, tm-gnus provides this feature for other GNUS and Gnus, but
-it is unnatural.
+  In addition, Gnus 5.2 is designed to support automatic MIME preview
+feature.  Of course, gnus-mime provides this feature for Gnus 5.0.*
+and Gnus 5.1.*, 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 one, GNUS
-and Gnus does not do MIME processing, in default.
+  When automatic MIME preview mode, Gnus do MIME processing if a
+message has a Mime-Version field.  If it does not have one, Gnus does
+not do MIME processing, in default.
 
-  Gnus 5.0.*, 5.1 and Gnus 5.2 have a variable `gnus-strict-mime'. If
+  Gnus 5.0.*, 5.1 and Gnus 5.2 have a variable `gnus-strict-mime'.  If
 you insert
 
        (setq gnus-strict-mime nil)
@@ -159,12 +187,23 @@ Gnus does MIME processing even if a message does not have a
 Mime-Version field.
 
   In Gnus 5.2, if `gnus-strict-mime' is not nil, variable
-`gnus-decode-encoded-word-method' is called. tm-gnus uses it to decode
-RFC 1522 encoded-words. So it is not necessary to reset
+`gnus-decode-encoded-word-method' is called.  gnus-mime uses it to
+decode RFC 2047 encoded-words.  So it is not necessary to reset
 `gnus-strict-mime'.
 
 
-6.2 VM
+6.2 tm-gnus
+
+  tm-gnus provides automatic MIME preview feature for GNUS 3.15 or
+later.
+
+  If you don't want to use automatic MIME preview feature, please
+insert in ~/.emacs:
+
+       (setq tm-gnus/automatic-mime-preview nil)
+
+
+6.3 VM
 
   If you use vm, please insert `(require 'tm-vm)' in ~/.vm.
 
@@ -172,7 +211,7 @@ RFC 1522 encoded-words. So it is not necessary to reset
 (require 'tm-vm) *after* (bbdb-insinuate-vm).
 
 
-6.3 PGP
+6.4 PGP
 
   If you have the PGP and Mailcrypt packages, you can use PGP with
 MIME. Currently, PGP/MIME (RFC 2015) and draft-kazu-pgp-mime-00.txt
@@ -223,7 +262,7 @@ please insert into ~/.emacs:
 ======================================================================
 
 
-6.4 code sample for hilit19
+6.5 code sample for hilit19
 
 ======================================================================
 (cond (window-system
@@ -263,7 +302,7 @@ please insert into ~/.emacs:
 ======================================================================
 
 
-6.5 code sample for browse-url
+6.6 code sample for browse-url
 
   If you have browse-url.el (included in Gnus 5.*, September Gnus and
 Emacs 19.30 or later), you can use URL button in
@@ -336,10 +375,17 @@ and its mirrors:
        ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/      (US)
 
 
-10 TODO
+10 PROBLEMS
+
+- Window configuration is broken after combining partial messages or
+  playing other internal methods.
+- Automatic combining method for message/partial is not implemented
+  for RMAIL.
+
+
+11 TODO
 
-- MUA specific key binding system for mime/viewer-mode
-- better identification calculus system as successor of atype system
+- better method selecting system as successor of atype system
 - development of internal method for message/external-body based on
   tm-ftp
 - better automatic MIME preview support