[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.22 1996/08/12 11:02:46 morioka Exp $
+$Id: README.en,v 7.23 1996/09/19 11:36:44 morioka Exp $
1 What's tm?
2 Documents
- This package includes following documents.
+ This package includes the following documents.
(1) English edition
You can edit tm/TM-CFG file.
- In default, tm is installed into /usr/local/. If you want to change,
-please modify the variable `PREFIX' and `EXEC_PREFIX'.
+ By default, tm is installed into /usr/local/. If you want to change this,
+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 Emacs
-distribution, you must edit following files before make.
+ 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.
tm/methods/tm-html for HTML
tm/methods/tmdecode decoder
- In default, tmdecode uses `mmencode' command. If you don't have
-metamail package, please modify tmdecode to use decode-b instead of
-mmencode.
+ By default, tmdecode uses the `mmencode' command, which is part of
+the metamail package (available by anonymous ftp from
+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
Run `make all'.
- You can specify Emacs command name, for example if you want to use
-`mule' as Emacs command:
+ You can specify the Emacs command name, for example if you want to use
+`mule' as the Emacs command:
% make all EMACS=mule
Run `make install'.
- You can specify Emacs command name, for example if you want to use
-`xemacs' as Emacs command:
+ You can specify the Emacs command name, for example if you want to use
+`xemacs' as the Emacs command:
% make install EMACS=xemacs
later, Gnus 5.0.*, Gnus 5.1, and Gnus 5.2.
If you don't want to use automatic MIME preview feature, please
-insert following to ~/.emacs.
+insert in ~/.emacs:
(setq tm-gnus/automatic-mime-preview nil)
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, GNUS and
-Gnus does not do MIME processing, in default.
+if a message has a Mime-Version field. If it does not have one, GNUS
+and Gnus does not do MIME processing, in default.
Gnus 5.0.*, 5.1 and Gnus 5.2 have a variable `gnus-strict-mime'. If
you insert
(setq gnus-strict-mime nil)
-Gnus do MIME processing even if a message does not have Mime-Version
-field.
+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-word. So it is not necessary to reset
+RFC 1522 encoded-words. So it is not necessary to reset
`gnus-strict-mime'.
6.3 PGP
- If you have PGP and Mailcrypt package, you can use PGP on
+ 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 way.
+draft-kazu-pgp-mime-00.txt) are proposed, so tm provides both ways.
- For decoding, please insert following into ~/.emacs:
+ For decoding, please insert the following into ~/.emacs:
======================================================================
(call-after-loaded
)))
======================================================================
-tm-pgp.el is a internal method modules to support PGP.
+tm-pgp.el is an internal method module to support PGP.
- For encoding, tm-edit provides 2 mechanism. One is for signing or
-encrypting for message as application/pgp. There are two command
+ For encoding, tm-edit provides 2 mechanisms. One is for signing or
+encrypting for message as application/pgp. There are two commands,
`mime-editor/set-sign' and `mime-editor/set-encrypt'. They set a
-message is signed, encrypted or not.
+message as signed, encrypted or not.
- Another one is for content. There are 2 kinds of enclosure for PGP:
+ Another one is for content. There are 2 kinds of enclosures for PGP:
``signed'' and ``encrypted''. Their enclosure are bound to key and
menu. If you use this mechanism, please specify 2 variables:
`mime-editor/signing-type' and `mime-editor/encrypting-type'. They
nil not processed
If you use ``signed'' and ``encrypted'' as draft-elkins-pem-pgp-02.txt,
-please insert following into ~/.emacs:
+please insert into ~/.emacs:
======================================================================
(setq mime-editor/signing-type 'pgp-elkins)
======================================================================
If you use ``signed'' and ``encrypted'' as draft-kazu-pgp-mime-00.txt,
-please insert following into ~/.emacs:
+please insert into ~/.emacs:
======================================================================
(setq mime-editor/signing-type 'pgp-kazu)
======================================================================
-6.4 setting sample for hilit19
+6.4 code sample for hilit19
======================================================================
(cond (window-system
======================================================================
-6.5 setting sample for browse-url
+6.5 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
-mime/viewer-mode. Following is setting sample:
+mime/viewer-mode. Sample code follows:
======================================================================
(setq browse-url-browser-function
7 How to use mime/viewer-mode
-In tm-MUAs, you can use mime/viewer-mode if you press `v' key (in VM,
-`Z' key) in Summary mode. Or automatic MIME previewed buffer's
+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:
body in human-recognizable language (^_^).
-9 How to get new version
+9 How to get the latest version
tm is available from following anonymous ftp site:
10 TODO
-- MUA specific key bind system for mime/viewer-mode
+- MUA specific key binding system for mime/viewer-mode
- better identification calculus system as successor of atype system
- development of internal method for message/external-body based on
tm-ftp