1 \documentstyle[a4j]{jarticle}
2 \setcounter{secnumdepth}{6}
3 \setcounter{tocdepth}{6}
8 \title{tiny-mime manual (English Version)}
9 \author{Morioka Tomohiko}
17 tiny-mime is a multilingual MIME style message header
18 encoder/decoder based on RFC 1522 for Mule, NEmacs, and NEpoch. I
19 modified Mr.Enami's ISO-2022-JP Base64 MIME header decoder and make
20 it. Mr.Enami's program can decode only ISO-2022-JP Base64 header. But,
21 current tiny-mime has following functions:
24 \item unfolding at decoding
25 \item encoding/decoding multilingual character sets, such as,
26 ISO-2022-JP, ISO-2022-JP-2, ISO-2022-CN, ISO-2022-KR, ISO-8859-*,
28 \item B and Q-encoding
33 \section{character set and encoding}
39 Mule can use multilingual text, so in Mule, tiny-mime supports
40 ISO-2022-JP, ISO-2022-JP-2, US-ASCII, ISO-8859-1..9, ISO-2022-CN,
41 ISO-2022-KR, EUC-KR, et al.
44 Additionally, you can add or change encoding/decoding for character
45 sets by function mime/set-charset-and-encoding.
48 \subsection{NEmacs and NEpoch}
51 NEmacs can use Japanese and English only, so in NEmacs, tiny-mime
52 supports encoding/decoding only ISO-2022-JP and US-ASCII.
55 And decoding ISO-8859-* encoded-words if they includes only ASCII.
59 \section{How to use tiny-mime.el (simple way)}
66 Please load tiny-mime.el, and do following command on the buffer
67 which you want to decode.
70 {\list{}{\leftmargin=8ex}\item[]
72 M-x mime/decode-message-header
77 And you can decode region by
82 M-x mime/decode-region
90 Please load tiny-mime.el, and do following command on the buffer
91 which you want to encode.
94 {\list{}{\leftmargin=8ex}\item[]
96 M-x mime/encode-message-header
105 \subsection{mime/no-encoding-header-fields}
108 You can specify list of fields which you don't want to
109 encode. Default value is ("X-Nsubject").
112 \item[example:]don't encode Subject and X-Nsubject fields
117 ----------------------------------------------------------------------
118 (setq mime/no-encoding-header-fields '("X-Nsubject" "Subject"))
119 ----------------------------------------------------------------------
124 \section{How to add or change character sets}
127 In Mule, you can add or change character sets by function
128 mime/set-charset-and-encoding.
131 \item[Function:]mime/set-charset-and-encoding lc cs charset encoding
134 \item[lc:]leading-char
135 \item[cs:]coding-system. Please specify nil if you don't want to use
136 coding-system for 1 octet character.
137 \item[charset:]MIME character set
138 \item[encoding:]encoding method for encoder
144 \item[example 1:]encode EUC-KR B encoding for KS C5601-1987 characters
147 (mime/set-charset-and-encoding lc-kr *euc-kr* "EUC-KR" "B")
150 \item[example 2:]encode/decode koi8-r Q encoding
153 (mime/set-charset-and-encoding lc-prv11 nil "KOI8-R" "Q")
155 \item[{[}WARNING{]}]In this version, handling for private character is very ad
156 hoc. (\verb+^+\_\verb+^+; I want to improve.