Info file: tm-mh-e-en.info,    -*-Text-*-
produced by `texinfo-format-buffer'
from filebuffer `*scratch*'
using `texinfmt.el' version 2.41 of  1 Mar 2005.

START-INFO-DIR-ENTRY
* Tm-Mh-E-Ja::            MIME extension for MH-E mail reader
END-INFO-DIR-ENTRY



File: tm-mh-e-en.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)

tm-mh-e 7.71 Reference Manual (English Version)
***********************************************


This file documents tm-mh-e, a MIME extension for MH-E.

* Menu:

* Introduction::                What is tm-mh-e?
* mh-folder-mode::              Extension for MH-Folder mode
* Automatic MIME Preview::      Inline display for MIME message
* mule::                        Internationalization
* MIME-Edit::                   Composing MIME message
* Concept Index::
* Variable Index::



File: tm-mh-e-en.info, Node: Introduction, Next: mh-folder-mode, Prev: Top, Up: Top

What is tm-mh-e?
****************

*tm-mh-e* is a mh-e (*Note (mh-e)::) extender to use MIME (*Note
(tm-en)MIME::) feature using tm (*Note (tm-en)tm-kernel::).

tm-mh-e extends following features:

   * automatic MIME preview using tm-view (*Note (tm-view-en)::)
   * composing MIME message using tm-edit (*Note (tm-edit-en)::)





File: tm-mh-e-en.info, Node: mh-folder-mode, Next: Automatic MIME Preview, Prev: Introduction, Up: Top

Extension for MH-Folder mode
****************************

`M-t'
     Toggle whether to do automatic MIME preview or not.

`v'
     Enter `mime/viewer-mode' to view a message.

`.'
     Display current message.

`,'
     Display current message with showing all fields.

`M-,'
     Display current "raw" message.



mime/viewer-mode (*Note (tm-view-en)mime/viewer-mode::) is a
major-mode to view and navigate MIME message.  In this mode, you can
move in a message or play a content, interactively.




File: tm-mh-e-en.info, Node: Automatic MIME Preview, Next: mule, Prev: mh-folder-mode, Up: Top

Inline display for MIME message
*******************************

*automatic MIME preview* feature is available in tm-mh-e.  In
automatic MIME preview mode, when reading an article in MH-Folder mode
(*Note (mh-e)Reading Mail::), tm-mh-e displays preview buffer
processed by tm-view (*Note (tm-view-en)::) instead of raw show
buffer.

Therefore if an article is encoded by Base64 (*Note (tm-en)Base64::)
or Quoted-Printable (*Note (tm-en)Quoted-Printable::), a decoded
article is displayed.  Or rich text article, such as text/enriched
(*Note (tm-en)text/enriched::) format, is automatic formated.  Of
course, multipart (*Note (tm-en)multipart::) article is dealt with
correctly.

In addition, in *XEmacs*, images are displayed in preview buffer as
same as text.

Different from using metamail, speaker does not roar just then read an
article includes audio content, video player does not play just then
read an article includes video content, it does not do anonymous ftp
(*Note (tm-en)ftp::) or send mail when read an article includes
external-message.  These contents are played when you do decoding
command in preview buffer.

However if you use a slow machine, or are just really impatient, you
can stop automatic MIME preview.


 -- Variable: tm-mh-e/automatic-mime-preview

     If it is not `nil', tm-mh-e is in automatic MIME preview mode.





File: tm-mh-e-en.info, Node: mule, Next: MIME-Edit, Prev: Automatic MIME Preview, Up: Top

Internationalization
********************

For emacs variants includes mule feature, such as MULE (*Note
(tm-en)MULE::), XEmacs/mule and Emacs/mule(*1), tm-mh-e supports
code-conversion by MIME charset (*Note (tm-en)MIME charset::).

*[Memo]* (*1) It means next generation of Emacs includes mule
     features.  Now (October 1996), HANDA Ken'ichi and RMS are
     developing it.


Detail of code conversion is following:

  1. If a part of a MIME message has charset parameter of Content-Type
     field (*Note (tm-en)Content-Type field::), it is code-converted
     by the MIME charset.
  2. encoded-word (*Note (tm-en)encoded-word::) are code-converted by
     their specified MIME charset (*Note (tm-en)MIME charset::).
  3. When there are no specified MIME charset, such as message header
     or non-MIME message, they are code-converted by
     `default-mime-charset' in Summary Buffer.



* Menu:

* evil environment::            Don't use MIME charset



File: tm-mh-e-en.info, Node: evil environment, Prev: mule, Up: mule

Don't use MIME charset
======================

If MTA (*Note (tm-en)MTA::) convert character encoding of messages
from network code to local code, such as EUC or Shift_JIS, MIME
charset does not work, so tm-mh-e can not display correct message.  It
is quite evil environment.  It does not break only MIME charset, but
also electric signature by PGP.

If you can manage your environment, you should fix it.  Otherwise you
should persuade the administration.

Unfortunately you are in such environment and you can not it,
following descriptions may be available.



for non-MIME message or non-charset
-----------------------------------

For non-MIME message, please set the character encoding to variable
`default-mime-charset'.  For example, if you use Japanese EUC:

     (setq default-mime-charset 'euc-japan)




To disable MIME charset
-----------------------

If for a text part specified MIME charset (*Note (tm-en)MIME
charset::), one way is to set variable
`mime-charset-coding-system-alist' to specify the coding-system
corresponding the primary MIME charset.  For example, to specify
`*sjis*' or `*euc-japan*' as `iso-2022-jp'.  However it breaks texts
encoded by Base64 or Quoted-Printable.

So it is better to redefine function `tm-mh-e/decode-charset-buffer'.
For example, if your MTA converts iso-2022-jp to Japanese EUC,
following definition may work:

     (defun tm-mh-e/decode-charset-buffer (charset &optional encoding)
       (decode-mime-charset-region (point-min)(point-max) 'euc-japan)
       )





File: tm-mh-e-en.info, Node: MIME-Edit, Next: Concept Index, Prev: mule, Up: Top

Composing MIME message
**********************

If using mime-setup (*Note (tm-en)mime-setup::), you can edit MIME
message in MH-Letter mode (*Note (mh-e)Draft Editing::) using tm-edit
(*Note (tm-edit-en)::).

In addition, `f' is used for message/rfc822 (*Note
(tm-en)message/rfc822::) style forwarding instead of RFC 934 (*Note
(tm-en)RFC 934::) style forwarding.




File: tm-mh-e-en.info, Node: Concept Index, Next: Variable Index, Prev: MIME-Edit, Up: Top

Concept Index
*************


* Menu:

* automatic MIME preview:       Automatic MIME Preview.  (line   5)
* tm-mh-e:                      Introduction.           (line   5)
* XEmacs:                       Automatic MIME Preview.  (line   5)



File: tm-mh-e-en.info, Node: Variable Index, Prev: Concept Index, Up: Top

Variable Index
**************


* Menu:

* tm-mh-e/automatic-mime-preview: Automatic MIME Preview.  (line  35)

Tag table:
Node: Top263
Node: Introduction828
Node: mh-folder-mode1247
Node: Automatic MIME Preview1854
Node: mule3303
Node: evil environment4358
Node: MIME-Edit5952
Node: Concept Index6403
Node: Variable Index6741

End tag table
