2 \title{tiny-mime manual (English Version)}
3 \author{Morioka Tomohiko}
10 tiny-mime is a multilingual MIME style message header
11 encoder/decoder based on RFC 1522 for Mule, NEmacs, and NEpoch. I
12 modified Mr.Enami's ISO-2022-JP Base64 MIME header decoder and make
13 it. Mr.Enami's program can decode only ISO-2022-JP Base64 header. But,
14 current tiny-mime has following functions:
16 - unfolding at decoding
17 - encoding/decoding multilingual character sets, such as,
18 ISO-2022-JP, ISO-2022-JP-2, ISO-2022-CN, ISO-2022-KR, ISO-8859-*,
23 * character set and encoding
27 Mule can use multilingual text, so in Mule, tiny-mime supports
28 ISO-2022-JP, ISO-2022-JP-2, US-ASCII, ISO-8859-1..9, ISO-2022-CN,
29 ISO-2022-KR, EUC-KR, et al.
31 Additionally, you can add or change encoding/decoding for character
32 sets by function mime/set-charset-and-encoding.
36 NEmacs can use Japanese and English only, so in NEmacs, tiny-mime
37 supports encoding/decoding only ISO-2022-JP and US-ASCII.
39 And decoding ISO-8859-* encoded-words if they includes only ASCII.
42 * How to use tiny-mime.el (simple way)
46 Please load tiny-mime.el, and do following command on the buffer
47 which you want to decode.
49 M-x mime/decode-message-header
51 And you can decode region by
53 M-x mime/decode-region
57 Please load tiny-mime.el, and do following command on the buffer
58 which you want to encode.
60 M-x mime/encode-message-header
66 ** mime/no-encoding-header-fields
68 You can specify list of fields which you don't want to
69 encode. Default value is ("X-Nsubject").
71 example: don't encode Subject and X-Nsubject fields
74 ----------------------------------------------------------------------
75 (setq mime/no-encoding-header-fields '("X-Nsubject" "Subject"))
76 ----------------------------------------------------------------------
80 * How to add or change character sets
82 In Mule, you can add or change character sets by function
83 mime/set-charset-and-encoding.
85 Function: mime/set-charset-and-encoding lc cs charset encoding
88 cs: coding-system. Please specify nil if you don't want to use
89 coding-system for 1 octet character.
90 charset: MIME character set
91 encoding: encoding method for encoder
94 example 1: encode EUC-KR B encoding for KS C5601-1987 characters
96 (mime/set-charset-and-encoding lc-kr *euc-kr* "EUC-KR" "B")
99 example 2: encode/decode koi8-r Q encoding
101 (mime/set-charset-and-encoding lc-prv11 nil "KOI8-R" "Q")
103 [WARNING] In this version, handling for private character is very ad
104 hoc. (^_^; I want to improve.