X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=README.en;h=ae6e779b7f1287a9f53c60133d329fa31eb62cb7;hb=b77b17617ad6e2d752ffa07cc4232a54c6ebae81;hp=cb03d61c9a2d2bb333f88e1ae2138bfba051d7ea;hpb=327711693e20cc80cb741d6c97d2c1ae3f383a70;p=elisp%2Ftm.git diff --git a/README.en b/README.en index cb03d61..ae6e779 100644 --- a/README.en +++ b/README.en @@ -1,7 +1,7 @@ [README for tm (English Version)] by MORIOKA Tomohiko and KOBAYASHI Shuhei -$Id: README.en,v 7.23 1996/09/19 11:36:44 morioka Exp $ +$Id: README.en,v 7.32 1997/02/03 06:53:15 morioka Exp $ 1 What's tm? @@ -19,17 +19,57 @@ $Id: README.en,v 7.23 1996/09/19 11:36:44 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.23 1996/09/19 11:36:44 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.23 1996/09/19 11:36:44 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,24 +187,39 @@ 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. tm works well with BBDB: If you use VM, please insert (require 'tm-vm) *after* (bbdb-insinuate-vm). + Important changes have been made to the VM interface in TM v7.102, +users upgrading from an earlier version should read the documentation +of tm-vm (`News' section) for details. -6.3 PGP + +6.4 PGP If you have the PGP and Mailcrypt packages, you can use PGP with -MIME. Currently, 2 drafts (draft-elkins-pem-pgp-02.txt and -draft-kazu-pgp-mime-00.txt) are proposed, so tm provides both ways. +MIME. Currently, PGP/MIME (RFC 2015) and draft-kazu-pgp-mime-00.txt +are proposed, so tm provides both ways. For decoding, please insert the following into ~/.emacs: @@ -202,12 +245,12 @@ menu. If you use this mechanism, please specify 2 variables: `mime-editor/signing-type' and `mime-editor/encrypting-type'. They requires following values: - pgp-elkins processed as draft-elkins-pem-pgp-02.txt + pgp-elkins processed as PGP/MIME (RFC 2015) pgp-kazu processed as draft-kazu-pgp-mime-00.txt nil not processed -If you use ``signed'' and ``encrypted'' as draft-elkins-pem-pgp-02.txt, -please insert into ~/.emacs: +If you use ``signed'' and ``encrypted'' as PGP/MIME, please insert +into ~/.emacs: ====================================================================== (setq mime-editor/signing-type 'pgp-elkins) @@ -223,7 +266,7 @@ please insert into ~/.emacs: ====================================================================== -6.4 code sample for hilit19 +6.5 code sample for hilit19 ====================================================================== (cond (window-system @@ -263,7 +306,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 @@ -284,25 +327,23 @@ mime/viewer-mode. Sample code follows: In tm-MUAs, you can use mime/viewer-mode if you press the `v' key (in VM, `Z' key) in Summary mode. Or automatic MIME previewed buffer's major-mode is mime/viewer-mode. mime/viewer-mode has following -functions: - - q quit from mime/viewer-mode - u move to upper content - p move to previous content - n move to next content - SPC scroll up or move to next content - M-SPC scroll down or move to previous content - DEL scroll down or move to previous content - RET move to next line - M-RET move to previous line - < move to beginning of message - > move to end of message - v play current content - e extract as file current content - C-c C-p print current content - f display X-Face in current message - button-2 move to point under the mouse cursor and play - current content or browse URL +functions (these key bindings are prefixed with C-c in VM): + + q quit from mime/viewer-mode + u move to upper content + p or M-TAB move to previous content + n or TAB move to next content + SPC scroll up or move to next content + M-SPC or DEL scroll down or move to previous content + RET move to next line + M-RET move to previous line + < move to beginning of message + > move to end of message + v play current content + e extract as file current content + C-c C-p print current content + f display X-Face in current message + button-2 play current content or browse URL 8 Bug report @@ -336,10 +377,16 @@ and its mirrors: ftp://ftp.nisiq.net/pub/gnu/emacs-lisp/tm/ (US) -10 TODO +10 PROBLEMS + +- Automatic combining method for message/partial is not implemented + for RMAIL. +- answer method is not implemented for RMAIL, Gnus and GNUS. + + +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