\documentstyle{article}
\setcounter{secnumdepth}{6}
\setcounter{tocdepth}{6}
\topsep=0.1cm
\parsep=0.1cm
\itemsep=0.0cm
\begin{document}
\title{tiny-mime manual (English Version)}
\author{Morioka Tomohiko}
\date{1994/8/4}
\maketitle
\medskip

\section{Overview}
\medskip
\par
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:
\medskip
\begin{itemize}
\item unfolding at decoding
\item 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
\item B and Q-encoding
\medskip
\medskip
\end{itemize}

\section{character set and encoding}
\medskip

\subsection{Mule}
\medskip
\par
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.
\medskip
\par
Additionally, you can add or change encoding/decoding for character
sets by function mime/set-charset-and-encoding.
\medskip

\subsection{NEmacs and NEpoch}
\medskip
\par
NEmacs can use Japanese and English only, so in NEmacs, tiny-mime
supports encoding/decoding only ISO-2022-JP and US-ASCII.
\medskip
\par
And decoding ISO-8859-* encoded-words if they includes only ASCII.
\medskip
\medskip

\section{How to use tiny-mime.el (simple way)}
\medskip

\subsection{decoding}
\medskip
{\baselineskip=10pt
\begin{verbatim}
  Please load tiny-mime.el, and do following command on the buffer
which you want to decode.
\end{verbatim}}
\medskip
{\list{}{\leftmargin=8ex}\item[]
\par
M-x mime/decode-message-header
\endlist}
\medskip
{\baselineskip=10pt
\begin{verbatim}
  And you can decode region by
\end{verbatim}}
\medskip
{\baselineskip=10pt
\begin{verbatim}
        M-x mime/decode-region
\end{verbatim}}
\medskip

\subsection{encoding}
\medskip
{\baselineskip=10pt
\begin{verbatim}
  Please load tiny-mime.el, and do following command on the buffer
which you want to encode.
\end{verbatim}}
\medskip
{\list{}{\leftmargin=8ex}\item[]
\par
M-x mime/encode-message-header
\endlist}
\medskip
\medskip
\medskip

\section{variables}
\medskip

\subsection{mime/no-encoding-header-fields}
\medskip
\par
You can specify list of fields which you don't want to
encode. Default value is ("X-Nsubject").
\medskip
\begin{description}
\item[example:]don't encode Subject and X-Nsubject fields
\medskip
\end{description}
{\baselineskip=10pt
\begin{verbatim}
----------------------------------------------------------------------
(setq mime/no-encoding-header-fields '("X-Nsubject" "Subject"))
----------------------------------------------------------------------
\end{verbatim}}
\medskip
\medskip

\section{How to add or change character sets}
\medskip
\par
In Mule, you can add or change character sets by function
mime/set-charset-and-encoding.
\medskip
\begin{description}
\item[Function:]mime/set-charset-and-encoding lc cs charset encoding
\medskip
\begin{description}
\item[lc:]leading-char
\item[cs:]coding-system. Please specify nil if you don't want to use
coding-system for 1 octet character.
\item[charset:]MIME character set
\item[encoding:]encoding method for encoder
\medskip
\medskip
\end{description}
\end{description}
\begin{description}
\item[example 1:]encode EUC-KR B encoding for KS C5601-1987 characters
\medskip
\par
(mime/set-charset-and-encoding lc-kr *euc-kr* "EUC-KR" "B")
\medskip
\medskip
\item[example 2:]encode/decode koi8-r Q encoding
\medskip
\par
(mime/set-charset-and-encoding lc-prv11 nil "KOI8-R" "Q")
\medskip
\item[{[}WARNING{]}]In this version, handling for private character is very ad
hoc.  (\verb+^+\_\verb+^+; I want to improve.
\end{description}
\end{document}
