Mercurial > hg > xemacs-beta
diff man/tm/tm-mh-e-en.texi @ 8:4b173ad71786 r19-15b5
Import from CVS: tag r19-15b5
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:47:35 +0200 |
parents | |
children | 49a24b4fd526 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/tm/tm-mh-e-en.texi Mon Aug 13 08:47:35 2007 +0200 @@ -0,0 +1,215 @@ +\input texinfo.tex +@setfilename tm-mh-e-en.info +@settitle{tm-mh-e 7.71 Reference Manual (English Version)} +@titlepage +@title tm-mh-e 7.71 Reference Manual (English Version) +@author MORIOKA Tomohiko <morioka@@jaist.ac.jp> +@subtitle 1996/10/15 +@end titlepage +@node Top, Introduction, (dir), (dir) +@top tm-mh-e 7.71 Reference Manual (English Version) + +@ifinfo + +This file documents tm-mh-e, a MIME extension for GNUS. +@end ifinfo + +@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:: +@end menu + +@node Introduction, mh-folder-mode, Top, Top +@chapter What is tm-mh-e? + +@cindex{tm-mh-e}@strong{tm-mh-e} is a mh-e (@ref{(mh-e)}) extender to +use MIME (@ref{(tm-en)MIME}) feature using tm +(@ref{(tm-en)tm-kernel}).@refill + +tm-mh-e extends following features: + +@itemize @bullet +@item +automatic MIME preview using tm-view (@ref{(tm-view-en)}) +@item +composing MIME message using tm-edit (@ref{(tm-edit-en)}) +@end itemize + + + +@node mh-folder-mode, Automatic MIME Preview, Introduction, Top +@chapter Extension for MH-Folder mode + +@table @kbd +@item @key{M-t} +Toggle whether to do automatic MIME preview or not. + +@item @key{v} +Enter @code{mime/viewer-mode} to view a message. + +@item @key{.} +Display current message. + +@item @key{,} +Display current message with showing all fields. + +@item @key{M-,} +Display current ``raw'' message. + +@end table + + +mime/viewer-mode (@ref{(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. + + +@node Automatic MIME Preview, mule, mh-folder-mode, Top +@chapter Inline display for MIME message + +@cindex{automatic MIME preview}@strong{automatic MIME preview} feature +is available in tm-mh-e. In automatic MIME preview mode, when reading +an article in MH-Folder mode (@ref{(mh-e)Reading Mail}), tm-mh-e +displays preview buffer processed by tm-view (@ref{(tm-view-en)}) +instead of raw show buffer.@refill + +Therefore if an article is encoded by Base64 (@ref{(tm-en)Base64}) or +Quoted-Printable (@ref{(tm-en)Quoted-Printable}), a decoded article is +displayed. Or rich text article, such as text/enriched +(@ref{(tm-en)text/enriched}) format, is automatic formated. Of course, +multipart (@ref{(tm-en)multipart}) article is dealt with +correctly.@refill + +In addition, in @cindex{XEmacs}@strong{XEmacs}, images are displayed in +preview buffer as same as text.@refill + +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 +(@ref{(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.@refill + +However if you use a slow machine, or are just really impatient, you +can stop automatic MIME preview. + + +@defvar tm-mh-e/automatic-mime-preview + +If it is not @code{nil}, tm-mh-e is in automatic MIME preview mode. +@end defvar + + + +@node mule, MIME-Edit, Automatic MIME Preview, Top +@chapter Internationalization + +For emacs variants includes mule feature, such as MULE +(@ref{(tm-en)MULE}), XEmacs/mule and Emacs/mule(*1), tm-mh-e supports +code-conversion by MIME charset (@ref{(tm-en)MIME charset}). + +@noindent +@strong{[Memo]} +@quotation +(*1) It means next generation of Emacs includes mule features. Now +(October 1996), HANDA Ken'ichi and RMS are developing it. +@end quotation + + +Detail of code conversion is following: + +@enumerate +@item +If a part of a MIME message has charset parameter of Content-Type field +(@ref{(tm-en)Content-Type field}), it is code-converted by the MIME +charset. +@item +encoded-word (@ref{(tm-en)encoded-word}) are code-converted by their +specified MIME charset (@ref{(tm-en)MIME charset}). +@item +When there are no specified MIME charset, such as message header +or non-MIME message, they are code-converted by +@code{default-mime-charset} in Summary Buffer. +@end enumerate + + + +@menu +* evil environment:: Don't use MIME charset +@end menu + +@node evil environment, , mule, mule +@section Don't use MIME charset + +If MTA (@ref{(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.@refill + +If you can manage your environment, you should fix it. Otherwise you +should persuade the administration.@refill + +Unfortunately you are in such environment and you can not it, +following descriptions may be available. + + +@subsection for non-MIME message or non-charset + +For non-MIME message, please set the character encoding to variable +@code{default-mime-charset}. For example, if you use Japanese EUC: + +@lisp +(setq default-mime-charset 'euc-japan) +@end lisp + + + +@subsection To disable MIME charset + +If for a text part specified MIME charset (@ref{(tm-en)MIME charset}), +one way is to set variable @code{mime-charset-coding-system-alist} to +specify the coding-system corresponding the primary MIME charset. For +example, to specify @code{*sjis*} or @code{*euc-japan*} as +@code{iso-2022-jp}. However it breaks texts encoded by Base64 or +Quoted-Printable.@refill + +So it is better to redefine function +@code{tm-mh-e/decode-charset-buffer}. For example, if your MTA +converts iso-2022-jp to Japanese EUC, following definition may work: + +@lisp +(defun tm-mh-e/decode-charset-buffer (charset &optional encoding) + (decode-mime-charset-region (point-min)(point-max) 'euc-japan) + ) +@end lisp + + + +@node MIME-Edit, Concept Index, mule, Top +@chapter Composing MIME message + +If using mime-setup (@ref{(tm-en)mime-setup}), you can edit MIME message +in MH-Letter mode (@ref{(mh-e)Draft Editing}) using tm-edit +(@ref{(tm-edit-en)}).@refill + +In addition, @kbd{f} is used for message/rfc822 +(@ref{(tm-en)message/rfc822}) style forwarding instead of RFC 934 +(@ref{(tm-en)RFC 934}) style forwarding. + + +@node Concept Index, Variable Index, MIME-Edit, Top +@chapter Concept Index + +@printindex cp + +@node Variable Index, , Concept Index, Top +@chapter Variable Index + +@printindex vr +@bye