cgit.sxemacs.org Git - packages/blob - xemacs-packages/tm/texi/tm-mh-e-en.texi

   1 \input texinfo.tex
   2 @setfilename tm-mh-e-en.info
   3 @settitle tm-mh-e 7.71 Reference Manual (English Version)
   4 @direntry
   5 * Tm-Mh-E-Ja::            MIME extension for MH-E mail reader
   6 @end direntry
   7 @titlepage
   8 @title tm-mh-e 7.71 Reference Manual (English Version)
   9 @author MORIOKA Tomohiko <morioka@@jaist.ac.jp>
  10 @subtitle 1996/10/15
  11 @end titlepage
  12 @node Top, Introduction, (dir), (dir)
  13 @top tm-mh-e 7.71 Reference Manual (English Version)
  14
  15 @ifinfo
  16
  17 This file documents tm-mh-e, a MIME extension for MH-E.
  18 @end ifinfo
  19
  20 @menu
  21 * Introduction::                What is tm-mh-e?
  22 * mh-folder-mode::              Extension for MH-Folder mode
  23 * Automatic MIME Preview::      Inline display for MIME message
  24 * mule::                        Internationalization
  25 * MIME-Edit::                   Composing MIME message
  26 * Concept Index::
  27 * Variable Index::
  28 @end menu
  29
  30 @node Introduction, mh-folder-mode, Top, Top
  31 @chapter What is tm-mh-e?
  32 @cindex tm-mh-e
  33
  34 @strong{tm-mh-e} is a mh-e (@ref{(mh-e)}) extender to use MIME
  35 (@ref{(tm-en)MIME}) feature using tm (@ref{(tm-en)tm-kernel}).@refill
  36
  37 tm-mh-e extends following features:
  38
  39 @itemize @bullet
  40 @item
  41 automatic MIME preview using tm-view (@ref{(tm-view-en)})
  42 @item
  43 composing MIME message using tm-edit (@ref{(tm-edit-en)})
  44 @end itemize
  45
  46
  47
  48 @node mh-folder-mode, Automatic MIME Preview, Introduction, Top
  49 @chapter Extension for MH-Folder mode
  50
  51 @table @kbd
  52 @item @key{M-t}
  53 Toggle whether to do automatic MIME preview or not.
  54
  55 @item @key{v}
  56 Enter @code{mime/viewer-mode} to view a message.
  57
  58 @item @key{.}
  59 Display current message.
  60
  61 @item @key{,}
  62 Display current message with showing all fields.
  63
  64 @item @key{M-,}
  65 Display current ``raw'' message.
  66
  67 @end table
  68
  69
  70 mime/viewer-mode (@ref{(tm-view-en)mime/viewer-mode}) is a major-mode to
  71 view and navigate MIME message.  In this mode, you can move in a message
  72 or play a content, interactively.
  73
  74
  75 @node Automatic MIME Preview, mule, mh-folder-mode, Top
  76 @chapter Inline display for MIME message
  77 @cindex XEmacs
  78 @cindex automatic MIME preview
  79
  80 @strong{automatic MIME preview} feature is available in tm-mh-e.  In
  81 automatic MIME preview mode, when reading an article in MH-Folder mode
  82 (@ref{(mh-e)Reading Mail}), tm-mh-e displays preview buffer processed by
  83 tm-view (@ref{(tm-view-en)}) instead of raw show buffer.@refill
  84
  85 Therefore if an article is encoded by Base64 (@ref{(tm-en)Base64}) or
  86 Quoted-Printable (@ref{(tm-en)Quoted-Printable}), a decoded article is
  87 displayed.  Or rich text article, such as text/enriched
  88 (@ref{(tm-en)text/enriched}) format, is automatic formated.  Of course,
  89 multipart (@ref{(tm-en)multipart}) article is dealt with
  90 correctly.@refill
  91
  92 In addition, in @strong{XEmacs}, images are displayed in preview buffer
  93 as same as text.@refill
  94
  95 Different from using metamail, speaker does not roar just then read an
  96 article includes audio content, video player does not play just then
  97 read an article includes video content, it does not do anonymous ftp
  98 (@ref{(tm-en)ftp}) or send mail when read an article includes
  99 external-message.  These contents are played when you do decoding
 100 command in preview buffer.@refill
 101
 102 However if you use a slow machine, or are just really impatient, you
 103 can stop automatic MIME preview.
 104
 105
 106 @defvar tm-mh-e/automatic-mime-preview
 107
 108 If it is not @code{nil}, tm-mh-e is in automatic MIME preview mode.
 109 @end defvar
 110
 111
 112
 113 @node mule, MIME-Edit, Automatic MIME Preview, Top
 114 @chapter Internationalization
 115
 116 For emacs variants includes mule feature, such as MULE
 117 (@ref{(tm-en)MULE}), XEmacs/mule and Emacs/mule(*1), tm-mh-e supports
 118 code-conversion by MIME charset (@ref{(tm-en)MIME charset}).
 119
 120 @noindent
 121 @strong{[Memo]}
 122 @quotation
 123 (*1) It means next generation of Emacs includes mule features.  Now
 124 (October 1996), HANDA Ken'ichi and RMS are developing it.
 125 @end quotation
 126
 127
 128 Detail of code conversion is following:
 129
 130 @enumerate
 131 @item
 132 If a part of a MIME message has charset parameter of Content-Type field
 133 (@ref{(tm-en)Content-Type field}), it is code-converted by the MIME
 134 charset.
 135 @item
 136 encoded-word (@ref{(tm-en)encoded-word}) are code-converted by their
 137 specified MIME charset (@ref{(tm-en)MIME charset}).
 138 @item
 139 When there are no specified MIME charset, such as message header
 140 or non-MIME message, they are code-converted by
 141 @code{default-mime-charset} in Summary Buffer.
 142 @end enumerate
 143
 144
 145
 146 @menu
 147 * evil environment::            Don't use MIME charset
 148 @end menu
 149
 150 @node evil environment,  , mule, mule
 151 @section Don't use MIME charset
 152
 153 If MTA (@ref{(tm-en)MTA}) convert character encoding of messages from
 154 network code to local code, such as EUC or Shift_JIS, MIME charset does
 155 not work, so tm-mh-e can not display correct message.  It is quite evil
 156 environment.  It does not break only MIME charset, but also electric
 157 signature by PGP.@refill
 158
 159 If you can manage your environment, you should fix it.  Otherwise you
 160 should persuade the administration.@refill
 161
 162 Unfortunately you are in such environment and you can not it,
 163 following descriptions may be available.
 164
 165
 166 @subsection for non-MIME message or non-charset
 167
 168 For non-MIME message, please set the character encoding to variable
 169 @code{default-mime-charset}.  For example, if you use Japanese EUC:
 170
 171 @lisp
 172 (setq default-mime-charset 'euc-japan)
 173 @end lisp
 174
 175
 176
 177 @subsection To disable MIME charset
 178
 179 If for a text part specified MIME charset (@ref{(tm-en)MIME charset}),
 180 one way is to set variable @code{mime-charset-coding-system-alist} to
 181 specify the coding-system corresponding the primary MIME charset.  For
 182 example, to specify @code{*sjis*} or @code{*euc-japan*} as
 183 @code{iso-2022-jp}.  However it breaks texts encoded by Base64 or
 184 Quoted-Printable.@refill
 185
 186 So it is better to redefine function
 187 @code{tm-mh-e/decode-charset-buffer}.  For example, if your MTA
 188 converts iso-2022-jp to Japanese EUC, following definition may work:
 189
 190 @lisp
 191 (defun tm-mh-e/decode-charset-buffer (charset &optional encoding)
 192   (decode-mime-charset-region (point-min)(point-max) 'euc-japan)
 193   )
 194 @end lisp
 195
 196
 197
 198 @node MIME-Edit, Concept Index, mule, Top
 199 @chapter Composing MIME message
 200
 201 If using mime-setup (@ref{(tm-en)mime-setup}), you can edit MIME message
 202 in MH-Letter mode (@ref{(mh-e)Draft Editing}) using tm-edit
 203 (@ref{(tm-edit-en)}).@refill
 204
 205 In addition, @kbd{f} is used for message/rfc822
 206 (@ref{(tm-en)message/rfc822}) style forwarding instead of RFC 934
 207 (@ref{(tm-en)RFC 934}) style forwarding.
 208
 209
 210 @node Concept Index, Variable Index, MIME-Edit, Top
 211 @chapter Concept Index
 212
 213 @printindex cp
 214
 215 @node Variable Index,  , Concept Index, Top
 216 @chapter Variable Index
 217
 218 @printindex vr
 219 @bye