1 <!doctype sinfo system>
2 <!-- $Id: tm-mh-e-en.sgml,v 1.1.1.1 1998-01-14 06:27:58 steve Exp $ -->
4 <title>tm-mh-e 7.71 Reference Manual (English Version)
5 <author>MORIOKA Tomohiko <mail>morioka@jaist.ac.jp</mail>
15 This file documents tm-mh-e, a MIME extension for GNUS.
22 <concept>tm-mh-e</concept> is a <a file="mh-e">mh-e</a> extender to
23 use <dref file="tm-en">MIME</dref> feature using <a file="tm-en"
24 node="tm-kernel">tm</a>.
26 tm-mh-e extends following features:
29 <li>automatic MIME preview using <a file="tm-view-en">tm-view</a>
30 <li>composing MIME message using <a file="tm-edit-en">tm-edit</a>
34 <h1> Extension for MH-Folder mode
40 Toggle whether to do automatic MIME preview or not.
43 <kd>Enter <code>mime/viewer-mode</code> to view a message.
47 Display current message.
51 Display current message with showing all fields.
55 Display current ``raw'' message.
59 <dref file="tm-view-en">mime/viewer-mode</dref> is a major-mode to
60 view and navigate MIME message. In this mode, you can move in a
61 message or play a content, interactively.
64 <h1> Inline display for MIME message
65 <node> Automatic MIME Preview
67 <concept>automatic MIME preview</concept> feature is available in
68 tm-mh-e. In automatic MIME preview mode, when reading an article in
69 <a file="mh-e" node="Reading Mail">
70 MH-Folder mode</a>, tm-mh-e displays preview buffer processed by <a
71 file="tm-view-en">tm-view</a> instead of raw show buffer.
73 Therefore if an article is encoded by <dref file="tm-en">Base64</dref>
74 or <dref file="tm-en">Quoted-Printable</dref>, a decoded article is
75 displayed. Or rich text article, such as <dref
76 file="tm-en">text/enriched</dref> format, is automatic formated. Of
77 course, <dref file="tm-en">multipart</dref> article is dealt with
80 In addition, in <concept>XEmacs</concept>, images are displayed in
81 preview buffer as same as text.
83 Different from using metamail, speaker does not roar just then read an
84 article includes audio content, video player does not play just then
85 read an article includes video content, it does not do anonymous <dref
86 file="tm-en">ftp</dref> or send mail when read an article includes
87 external-message. These contents are played when you do decoding
88 command in preview buffer.
90 However if you use a slow machine, or are just really impatient, you
91 can stop automatic MIME preview.
94 <defvar name="tm-mh-e/automatic-mime-preview">
96 If it is not <code>nil</code>, tm-mh-e is in automatic MIME preview
101 <h1> Internationalization
104 For emacs variants includes mule feature, such as <dref
105 file="tm-en">MULE</dref>, XEmacs/mule and Emacs/mule(*1), tm-mh-e
106 supports code-conversion by <dref file="tm-en">MIME charset</dref>.
109 (*1) It means next generation of Emacs includes mule features. Now
110 (October 1996), HANDA Ken'ichi and RMS are developing it.
114 Detail of code conversion is following:
117 <li>If a part of a MIME message has charset parameter of <dref
118 file="tm-en">Content-Type field</dref>, it is code-converted by the
121 <li><dref file="tm-en">encoded-word</dref> are code-converted by their
122 specified <dref file="tm-en">MIME charset</dref>.
124 <li>When there are no specified MIME charset, such as message header
125 or non-MIME message, they are code-converted by
126 <code>default-mime-charset</code> in Summary Buffer.
130 <h2> Don't use MIME charset
131 <node> evil environment
133 If <dref file="tm-en">MTA</dref> convert character encoding of
134 messages from network code to local code, such as EUC or Shift_JIS,
135 MIME charset does not work, so tm-mh-e can not display correct
136 message. It is quite evil environment. It does not break only MIME
137 charset, but also electric signature by PGP.
139 If you can manage your environment, you should fix it. Otherwise you
140 should persuade the administration.
142 Unfortunately you are in such environment and you can not it,
143 following descriptions may be available.
146 <h3> for non-MIME message or non-charset
148 For non-MIME message, please set the character encoding to variable
149 <code>default-mime-charset</code>. For example, if you use Japanese EUC:
152 (setq default-mime-charset 'euc-japan)
156 <h3> To disable MIME charset
158 If for a text part specified <dref file="tm-en">MIME charset</dref>,
159 one way is to set variable
160 <code>mime-charset-coding-system-alist</code> to specify the
161 coding-system corresponding the primary MIME charset. For example, to
162 specify <code>*sjis*</code> or <code>*euc-japan*</code> as
163 <code>iso-2022-jp</code>. However it breaks texts encoded by Base64
166 So it is better to redefine function
167 <code>tm-mh-e/decode-charset-buffer</code>. For example, if your MTA
168 converts iso-2022-jp to Japanese EUC, following definition may work:
171 (defun tm-mh-e/decode-charset-buffer (charset &optional encoding)
172 (decode-mime-charset-region (point-min)(point-max) 'euc-japan)
177 <h1> Composing MIME message
180 If using <dref file="tm-en">mime-setup</dref>, you can edit MIME
181 message in <a file="mh-e" node="Draft Editing">MH-Letter mode</a>
182 using <a file="tm-edit-en">tm-edit</a>.
184 In addition, <kbd>f</kbd> is used for <dref
185 file="tm-en">message/rfc822</dref> style forwarding instead of <dref
186 file="tm-en">RFC 934</dref> style forwarding.
196 <node> Variable Index