[[R
\title{tiny-mime manual (English Version)}
\author{Morioka Tomohiko}
\date{1994/8/4}
\maketitle
]]R

* Overview

  tiny-mime is a multilingual MIME style message header
encoder/decoder based on RFC 1522 for Mule, NEmacs, and NEpoch. I
modified Mr.Enami's ISO-2022-JP Base64 MIME header decoder and make
it. Mr.Enami's program can decode only ISO-2022-JP Base64 header. But,
current tiny-mime has following functions:

 - unfolding at decoding
 - encoding/decoding multilingual character sets, such as,
   ISO-2022-JP, ISO-2022-JP-2, ISO-2022-CN, ISO-2022-KR, ISO-8859-*,
   US-ASCII, EUC-KR
 - B and Q-encoding


* character set and encoding

** Mule

  Mule can use multilingual text, so in Mule, tiny-mime supports
ISO-2022-JP, ISO-2022-JP-2, US-ASCII, ISO-8859-1..9, ISO-2022-CN,
ISO-2022-KR, EUC-KR, et al.

  Additionally, you can add or change encoding/decoding for character
sets by function mime/set-charset-and-encoding.

** NEmacs and NEpoch

  NEmacs can use Japanese and English only, so in NEmacs, tiny-mime
supports encoding/decoding only ISO-2022-JP and US-ASCII.

  And decoding ISO-8859-* encoded-words if they includes only ASCII.


* How to use tiny-mime.el (simple way)

** decoding

  Please load tiny-mime.el, and do following command on the buffer
which you want to decode.

	M-x mime/decode-message-header

  And you can decode region by

	M-x mime/decode-region

** encoding

  Please load tiny-mime.el, and do following command on the buffer
which you want to encode.

	M-x mime/encode-message-header



* variables

** mime/no-encoding-header-fields

  You can specify list of fields which you don't want to
encode. Default value is ("X-Nsubject").

example: don't encode Subject and X-Nsubject fields

[[E
----------------------------------------------------------------------
(setq mime/no-encoding-header-fields '("X-Nsubject" "Subject"))
----------------------------------------------------------------------
]]E


* How to add or change character sets

  In Mule, you can add or change character sets by function
mime/set-charset-and-encoding.

  Function: mime/set-charset-and-encoding lc cs charset encoding

	lc: leading-char
	cs: coding-system. Please specify nil if you don't want to use
	    coding-system for 1 octet character.
	charset: MIME character set
	encoding: encoding method for encoder


example 1: encode EUC-KR B encoding for KS C5601-1987 characters

	(mime/set-charset-and-encoding lc-kr *euc-kr* "EUC-KR" "B")


example 2: encode/decode koi8-r Q encoding

	(mime/set-charset-and-encoding lc-prv11 nil "KOI8-R" "Q")

[WARNING] In this version, handling for private character is very ad
hoc.  (^_^; I want to improve.