X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.texi;h=7cd0e1096fa5c8b5fe4fbbb5e43ff7ba61008dfd;hb=41fe6bdf8523a73c43e73612b5df85caa5622081;hp=0ac8e6ae102691a2aa84c879d95562655465e632;hpb=5bfa6dab84c42bf42c9c50019d8808ac986326d1;p=elisp%2Fflim.git

diff --git a/mime-ja.texi b/mime-ja.texi
index 0ac8e6a..7cd0e10 100644
--- a/mime-ja.texi
+++ b/mime-ja.texi
@@ -1,21 +1,22 @@
 \input texinfo.tex
+@c Generated automatically from mime-ja.sgml by sinfo 3.7.
 @setfilename mime-ja.info
-@settitle{FLIM 1.7 MIME 機能説明書}
+@settitle{FLIM 1.12 MIME 機能説明書}
 @titlepage
-@title FLIM 1.7 MIME 機能説明書
+@title FLIM 1.12 MIME 機能説明書
 @author 守岡 知彦 <morioka@@jaist.ac.jp>
-@subtitle 1998/06/23
+@subtitle 1999-01-27
 @end titlepage
 @node Top, Introduction, (dir), (dir)
-@top FLIM 1.7 MIME 機能説明書
+@top FLIM 1.12 MIME 機能説明書
 
 @ifinfo
 
-This file documents MIME features of FLIM, a Internet message
-parsing/encoding library for GNU Emacs.@refill
+This file documents MIME features of FLIM, a fundamental library to
+process Internet Messages for GNU Emacsen.@refill
 
-GNU Emacs 用の Internet Message の解析や符号化に関する library である 
-FLIM の MIME 機能に関して説明します。
+GNU Emacsen 用の Internet Message 処理のための基礎 library である FLIM 
+の MIME 機能に関して説明します。
 @end ifinfo
 
 @menu
@@ -55,8 +56,6 @@ FLIM の提供する MIME 機能を使うためには
 
 @node Entity, Content-Type, How to use, Top
 @chapter Message と Entity
-@cindex node-id
-@cindex entity-number
 @cindex mime-entity
 @cindex entity
 
@@ -66,16 +65,73 @@ field と内容を指す」となっています。ここでは、MIME で定義された head
 field 以外の全ての header と body を指す語として @strong{entity}を用いる
 ことにします。@refill
 
-RFC 2045 の定義は、MIME message が entity を単位とする木構造であることを
-示しています。message は下図で示すような木となり、entity はこの木におけ
-る節となります。つまり、MIME は message を木構造に拡張した訳です。
-@refill
+RFC 2045 の定義は、MIME message が entity を節とする木構造であることを示
+しています。つまり、MIME は message を木構造に拡張した訳です。@refill
 
-FLIM は entity の情報を表現するために@strong{mime-entity} 構造体を用いま
-す。以下では単に mime-entity と呼ぶことにします。@refill
+FLIM は entity の情報を表現するために@strong{mime-entity} 構
+造体を用います。以下では単に mime-entity と呼ぶことにします。
 
-前述のように、message 中の各 entity は木の節に当たりますが、この木には
-深さと同じ深さの中の順番に従って番号が付けることができます。即ち、
+
+@menu
+* Entity creation::             Entity の生成
+* Entity hierarchy::            Entity 階層
+* Entity Search::               Entity の検索
+* Entity Attributes::           Entity の属性
+* Entity-header::               Entity header の情報
+* entity formatting::           Entity の文字表現
+* Entity-content::              Entity の内容
+* Entity-network-representation::  Entity のネットワーク表現
+* Entity buffer::               Entity の buffer による表現
+* mm-backend::                  Entity の表現と実現
+@end menu
+
+@node Entity creation, Entity hierarchy, Entity, Entity
+@section Entity の生成
+
+@defun mime-open-entity &optional  type location
+
+Open an entity and return it.@refill
+
+@var{type} is representation-type. (cf. @ref{mm-backend}) @refill
+
+@var{location} is location of entity.  Specification of it is depended
+on representation-type.
+@end defun
+
+
+@defun mime-parse-buffer &optional  buffer type
+
+@var{buffer} を message として構文解析し、その結果の mime-entity を 
+@var{buffer} の@code{mime-message-structure} に格納する。@refill
+
+@var{buffer} が省略された場合、現在の buffer を構文解析する。@refill
+
+@var{type} が指定された場合、その値を生成される mime-entity の表象型とし
+て用いる。省略された場合は @var{buffer} となる。(cf. @ref{mm-backend})
+@end defun
+
+
+
+@node Entity hierarchy, Entity Search, Entity creation, Entity
+@section Entity 階層
+@cindex node-id
+@cindex entity-number
+@cindex message
+@cindex root-entity
+
+MIME message は entity を単位とする木構造になっています。@refill
+
+この木において根となる節は message 全体を表す entity です。ここでは、こ
+れを @strong{root-entity} もしくは@strong{message} と呼びます。@refill
+
+root-entity 以外の entity は親を持ちます。また、entity は子供を持つかも
+知れません。この親子関係を考えることで entity の相対関係を扱うことができ
+ます。@refill
+
+一方、entity の message における位置を考えることもできます。@refill
+
+entity はこの木における節となりますが、この木には深さと同じ深さの中の
+順番に従って番号が付けることができます。即ち、
 @example
 
                               ┌───┐
@@ -102,48 +158,10 @@ node-id は @code{(3 2 1)} です。@refill
 
 前述のように、MIME message は entity を単位とした木構造になっているので、
 この根である message 全体も mime-entity で表現することができ、buffer
-local 変数 @code{mime-message-structure} に格納することにします。
-そして、entity-number や node-id を用いることで 
-@code{mime-message-structure} における entity の相対的な位置関係を
-扱うことができます。
-
-
-
-
+local 変数 @code{mime-message-structure} に格納することにします。@refill
 
-
-
-
-@menu
-* Message parser::              Message の解析器
-* Entity hierarchy::            Entity 階層
-* Entity buffer::               Entity の buffer による表現
-* Entity-header::               Entity header の情報
-* Entity Attributes::           Entity の属性
-* Entity-content::              Entity の内容
-@end menu
-
-@node Message parser, Entity hierarchy, Entity, Entity
-@section Message の解析器
-
-@defun mime-parse-message &optional  default-ctl node-id
-
-現在の buffer を message として構文解析し、その結果の mime-entity を返す。
-@end defun
-
-
-@defun mime-parse-buffer &optional  buffer
-
-@var{buffer} を message として構文解析し、その結果の mime-entity を 
-@var{buffer} の@code{mime-message-structure} に格納する。@refill
-
-@var{buffer} が省略された場合、現在の buffer を構文解析する。
-@end defun
-
-
-
-@node Entity hierarchy, Entity buffer, Message parser, Entity
-@section Entity 階層
+@code{mime-message-structure} を起点に entity-number や node-id 
+で示される entity を取り出すことができます。
 
 @defvar mime-message-structure
 
@@ -185,6 +203,10 @@ local 変数。
 @end defun
 
 
+
+@node Entity Search, Entity Attributes, Entity hierarchy, Entity
+@section Entity の検索
+
 @defun mime-find-entity-from-number entity-number  &optional  message
 
 Return entity from @var{entity-number} in @var{message}.@refill
@@ -203,60 +225,58 @@ used.
 @end defun
 
 
+@defun mime-find-entity-from-content-id cid  &optional  message
 
-@node Entity buffer, Entity-header, Entity hierarchy, Entity
-@section Entity の buffer による表現
-
-@defun mime-entity-buffer entity
+Return entity from @var{cid} in @var{message}.@refill
 
-@var{entity} が存在する buffer を返す。
+If @var{message} is not specified, @code{mime-message-structure} is
+used.
 @end defun
 
 
-@defun mime-entity-point-min entity
-
-@var{entity} が存在する buffer における、@var{entity} が占める領域の先頭
-位置を返す。
-@end defun
 
+@node Entity Attributes, Entity-header, Entity Search, Entity
+@section Entity の属性
 
-@defun mime-entity-point-max entity
+@defun mime-entity-content-type entity
 
-@var{entity} が存在する buffer における、@var{entity} が占める領域の末尾
-位置を返す。
+@var{entity} の content-type を返す。(cf. @ref{mime-content-type})
 @end defun
 
 
-@defun mime-entity-header-start entity
+@defun mime-entity-content-disposition entity
 
-@var{entity} が存在する buffer における、header が占める領域の先頭位置を
-返す。
+@var{entity} の content-disposition を返す。
+(cf. @ref{mime-content-disposition})
 @end defun
 
 
-@defun mime-entity-header-end entity
+@defun mime-entity-filename entity
 
-@var{entity} が存在する buffer における、header が占める領域の末尾位置を
-返す。
+@var{entity} の file 名を返す。
 @end defun
 
 
-@defun mime-entity-body-start entity
+@defun mime-entity-encoding entity  &optional  default-encoding
 
-@var{entity} が存在する buffer における、body が占める領域の先頭位置を返
-す。
+@var{entity} の content-transfer-encoding を返す。
+(cf. @ref{Content-Transfer-Encoding}) @refill
+
+もし、@var{entity} に Content-Transfer-Encoding 欄が存在しない場合は、
+@var{default-encoding} を返す。これが指定されない場合は、@code{"7bit"} 
+を用いる。
 @end defun
 
 
-@defun mime-entity-body-end entity
+@defun mime-entity-cooked-p entity
 
-@var{entity} が存在する buffer における、body が占める領域の末尾位置を返
-す。
+Return non-nil if contents of @var{entity} has been already
+code-converted.
 @end defun
 
 
 
-@node Entity-header, Entity Attributes, Entity buffer, Entity
+@node Entity-header, entity formatting, Entity Attributes, Entity
 @section Entity header の情報
 
 @defun mime-fetch-field field-name  &optional  entity
@@ -268,7 +288,7 @@ used.
 @var{entity} が省略された場合は、@code{mime-message-structure} の値を用
 いる。@refill
 
-@var{field-name} 欄が存在しない場合は nil を返す。
+@var{field-name} 欄が存在しない場合は @code{nil} を返す。
 @end defun
 
 
@@ -289,8 +309,11 @@ used.
 @end defun
 
 
-@defun mime-insert-decoded-header entity  &optional  invisible-fields visible-fields
-	    code-conversion
+
+@node entity formatting, Entity-content, Entity-header, Entity
+@section Entity の文字表現
+
+@defun mime-insert-header entity  &optional  invisible-fields visible-fields
 
 現在位置に @var{entity} の復号した header を挿入する。@refill
 
@@ -300,49 +323,209 @@ used.
 
 @var{invisible-fields} の要素のどれかに match し、かつ、
 @var{visible-fields} の要素のどれにも match しない欄は表示されない。
+@refill
+
+encoded-word (@ref{encoded-word}) は復号される。『生の非 us-ascii 文字』
+は @code{default-mime-charset} として解釈される。
 @end defun
 
 
+@defun mime-insert-text-content entity
 
-@node Entity Attributes, Entity-content, Entity-header, Entity
-@section Entity の属性
+Insert before point a contents of @var{entity} as text entity.@refill
 
-@defun mime-entity-content-type entity
+Contents of the @var{entity} are decoded as MIME charset (@ref{MIME charset}).  If the @var{entity} does not have charset parameter of
+Content-Type field, @code{default-mime-charset} is used as default
+value.
+@end defun
 
-@var{entity} の content-type を返す。(cf. @ref{mime-content-type})
+
+@defvar default-mime-charset
+
+適切な MIME charset (@ref{MIME charset}) が見つからなかった場合に用いら
+れるMIME charset.@refill
+
+本来は APEL の変数である。
+@end defvar
+
+
+
+@node Entity-content, Entity-network-representation, entity formatting, Entity
+@section Entity の内容
+
+@defun mime-entity-content entity
+
+@var{entity} の内容の byte 列を返す。
 @end defun
 
 
-@defun mime-entity-content-disposition entity
+@defun mime-insert-entity-content entity
 
-@var{entity} の content-disposition を返す。
-(cf. @ref{mime-content-disposition})
+Insert content of @var{entity} at point.
 @end defun
 
 
-@defun mime-entity-filename entity
+@defun mime-write-entity-content entity filename
 
-Entity の file 名を返す。
+Write content of @var{entity} into @var{filename}.
 @end defun
 
 
-@defun mime-entity-encoding entity
 
-@var{entity} の content-transfer-encoding を返す。
-(cf. @ref{Content-Transfer-Encoding})
+@node Entity-network-representation, Entity buffer, Entity-content, Entity
+@section Entity のネットワーク表現
+
+@defun mime-insert-entity entity
+
+Insert header and body of @var{entity} at point.
 @end defun
 
 
+@defun mime-write-entity entity filename
 
-@node Entity-content,  , Entity Attributes, Entity
-@section Entity の内容
+Write representation of @var{entity} into @var{filename}.
+@end defun
 
-@defun mime-entity-content entity
 
-@var{entity} の内容の byte 列を返す。
+@defun mime-write-entity-body entity filename
+
+Write body of @var{entity} into @var{filename}.
+@end defun
+
+
+
+@node Entity buffer, mm-backend, Entity-network-representation, Entity
+@section Entity の buffer による表現
+
+@defun mime-entity-buffer entity
+
+@var{entity} が存在する buffer を返す。
+@end defun
+
+
+@defun mime-entity-point-min entity
+
+@var{entity} が存在する buffer における、@var{entity} が占める領域の先頭
+位置を返す。
+@end defun
+
+
+@defun mime-entity-point-max entity
+
+@var{entity} が存在する buffer における、@var{entity} が占める領域の末尾
+位置を返す。
 @end defun
 
 
+@defun mime-entity-header-start entity
+
+@var{entity} が存在する buffer における、header が占める領域の先頭位置を
+返す。
+@end defun
+
+
+@defun mime-entity-header-end entity
+
+@var{entity} が存在する buffer における、header が占める領域の末尾位置を
+返す。
+@end defun
+
+
+@defun mime-entity-body-start entity
+
+@var{entity} が存在する buffer における、body が占める領域の先頭位置を返
+す。
+@end defun
+
+
+@defun mime-entity-body-end entity
+
+@var{entity} が存在する buffer における、body が占める領域の末尾位置を返
+す。
+@end defun
+
+
+
+@node mm-backend,  , Entity buffer, Entity
+@section Entity の表現と実現
+@cindex mm-backend
+@cindex entity 処理 method
+@cindex representation-type
+
+Entity は抽象化されたデータ表現で、実際のデータ表現としては用途に応じて
+さまざまなものが利用できるように設計されています。@refill
+
+ここで、entity がどういう種類の表現を行っているかを示すのが
+@strong{representation-type} で、entity を生成する時にはこれを指定します。
+(cf. @ref{Entity Creation}) @refill
+
+前節までに述べて来た entity に対する処理は、entity に対してその処理を依
+頼することによって実現されています。Entity は自分の representation-type 
+を知っており、その representation-type に応じて実際の処理を行う関数を呼
+び出します。このような関数を @strong{entity 処理method} と呼びます。また、
+representation-type 毎にこのような関数をまとめたものを 
+@strong{mm-backend} と呼びます。@refill
+
+mm-backend は representation-type の名前の先頭に @code{mm} という
+接頭辞を付けた関数名からなる module で、その module 名は同様に
+representation-type の名前の先頭に @code{mm} を付けたものになって
+います。この module は representation-type の entity が最初に生成される
+時に自動的に require されます。
+
+
+@menu
+* Request for entity::          Entity への便り
+* mm-backend module::           mm-backend の作り方
+@end menu
+
+@node Request for entity, mm-backend module, mm-backend, mm-backend
+@subsection Entity への便り
+
+@defun mime-entity-send entity message  &rest  args
+
+@var{entity} に @var{message} を送る。@refill
+
+@var{args} は @var{message} の引数である。
+@end defun
+
+
+
+@node mm-backend module,  , Request for entity, mm-backend
+@subsection mm-backend の作り方
+
+@defmac mm-define-backend type &optional  parents
+
+Define @var{type} as a mm-backend.@refill
+
+If @var{PARENTS} is specified, @var{type} inherits parents.  Each parent
+must be representation-type.@refill
+
+Example:@refill
+
+@lisp
+(mm-define-backend chao (generic))
+@end lisp
+@end defmac
+
+
+@defmac mm-define-method name args  &rest  body
+
+Define @var{name} as a method function of (nth 1 (car @var{args}))
+backend.@refill
+
+@var{args} is like an argument list of lambda, but (car @var{args}) must
+be specialized parameter.  (car (car @var{args})) is name of variable
+and (nth 1 (car @var{args})) is name of backend
+(representation-type).@refill
+
+Example:@refill
+
+@lisp
+(mm-define-method entity-cooked-p ((entity chao)) nil)
+@end lisp
+@end defmac
+
+
 
 @node Content-Type, Content-Disposition, Entity, Top
 @chapter Content-Type 欄の情報
@@ -598,12 +781,13 @@ FLIM では Content-Transfer-Encoding 欄を構文解析する関数を提供します。����尖緕���衷銓緕�夸瘤黽纈㌧釿閼蜴�鞜鴦纈査��衷銓緕�夸瘤黽纈㌧釿閼蜴�欄の解析器
-* Region encoder/decoder::      領域の符号化・復号化
-* String encoder/decoder::      文字列の符号化・復号化
-* File encoder/decoder::        File の符号化・復号化
+* encoder/decoder::             符号化・復号化
+* Encoding information::        Other utilities
+* mel-backend::                 How to write encoder/decoder module
+* generic function for mel-backend::  How to add encoding/decoding service
 @end menu
 
-@node Content-Transfer-Encoding parser, Region encoder/decoder, Content-Transfer-Encoding, Content-Transfer-Encoding
+@node Content-Transfer-Encoding parser, encoder/decoder, Content-Transfer-Encoding, Content-Transfer-Encoding
 @section Content-Transfer-Encoding 欄の解析器
 
 @defun mime-parse-Content-Transfer-Encoding string
@@ -623,8 +807,8 @@ Content-Transfer-Encoding 欄が存在しない場合は@var{default-encoding} を�������㍉鈿粤�吶芍闔�緕竢粤鬲粤竢粤鬪�囈鱸鈑�緕竢粤鬲粤竢粤鬪�衷銓緕�夸瘤黽纈㌧釿閼蜴�鞜鴦纈�衷銓緕�夸瘤黽纈㌧釿閼蜴�㍉黼笏蜿�領域の符号化・復号化
+@node encoder/decoder, Encoding information, Content-Transfer-Encoding parser, Content-Transfer-Encoding
+@section 符号化・復号化
 
 @defun mime-encode-region start end encoding
 
@@ -640,83 +824,123 @@ Decode region @var{start} to @var{end} of current buffer using
 @end defun
 
 
-@defvar mime-encoding-method-alist
 
-Alist of encoding vs. corresponding method to encode region.@refill
-
-Each element looks like @code{(STRING . FUNCTION)} or @code{(STRING
-. nil)}.  @var{string} is content-transfer-encoding.  @code{function} is
-region encoder and @code{nil} means not to encode.
-@end defvar
+@defun mime-decode-string string encoding
 
+@var{string} を @var{encoding} として復号した結果を返す。
+@end defun
 
-@defvar mime-decoding-method-alist
 
-Alist of encoding vs. corresponding method to decode region.@refill
 
-Each element looks like @code{(STRING . FUNCTION)} or @code{(STRING
-. nil)}.  @var{string} is content-transfer-encoding.  @code{function} is
-region decoder and @code{nil} means not to decode.
-@end defvar
+@defun mime-insert-encoded-file filename encoding
 
+Insert file @var{FILENAME} encoded by @var{ENCODING} format.
+@end defun
 
 
-@node String encoder/decoder, File encoder/decoder, Region encoder/decoder, Content-Transfer-Encoding
-@section 文字列の符号化・復号化
+@defun mime-write-decoded-region start end filename encoding
 
-@defun mime-decode-string string encoding
+Decode and write current region encoded by @var{encoding} into
+@var{filename}.@refill
 
-@var{string} を @var{encoding} として復号した結果を返します。
+@var{start} and @var{end} are buffer positions.
 @end defun
 
 
-@defvar mime-string-decoding-method-alist
 
-Alist of encoding vs. corresponding method to decode string.@refill
+@node Encoding information, mel-backend, encoder/decoder, Content-Transfer-Encoding
+@section Other utilities
 
-Each element looks like @code{(STRING . FUNCTION)}.  STRING is
-content-transfer-encoding.  FUNCTION is string decoder.
-@end defvar
+@defun mime-encoding-list &optional  SERVICE
 
+Return list of Content-Transfer-Encoding.@refill
 
+If @var{service} is specified, it returns available list of
+Content-Transfer-Encoding for it.
+@end defun
 
-@node File encoder/decoder,  , String encoder/decoder, Content-Transfer-Encoding
-@section File の符号化・復号化
 
-@defun mime-insert-encoded-file filename encoding
+@defun mime-encoding-alist &optional  SERVICE
 
-Insert file @var{FILENAME} encoded by @var{ENCODING} format.
+Return table of Content-Transfer-Encoding for completion.@refill
+
+If @var{service} is specified, it returns available list of
+Content-Transfer-Encoding for it.
 @end defun
 
 
-@defun mime-write-decoded-region start end filename encoding
 
-Decode and write current region encoded by @var{encoding} into
-@var{filename}.@refill
+@node mel-backend, generic function for mel-backend, Encoding information, Content-Transfer-Encoding
+@section How to write encoder/decoder module
 
-@var{start} and @var{end} are buffer positions.
-@end defun
+@defmac mel-define-method name args  &rest  body
 
+Define @var{name} as a method function of (nth 1 (car (last
+@var{args}))) backend.@refill
 
-@defvar mime-file-encoding-method-alist
+@var{args} is like an argument list of lambda, but (car (last
+@var{args})) must be specialized parameter.  (car (car (last
+@var{args}))) is name of variable and (nth 1 (car (last @var{args}))) is
+name of backend (encoding).@refill
 
-Alist of encoding vs. corresponding method to insert encoded
-file.@refill
+Example:@refill
 
-Each element looks like @code{(STRING . FUNCTION)}.  STRING is
-content-transfer-encoding.  FUNCTION is function to insert encoded file.
-@end defvar
+@lisp
+(mel-define-method mime-write-decoded-region (start end filename
+						    (nil "base64"))
+  "Decode and write current region encoded by base64 into FILENAME.
+START and END are buffer positions."
+  (interactive
+   (list (region-beginning) (region-end)
+	 (read-file-name "Write decoded region to file: ")))
+  (let ((str (buffer-substring start end)))
+    (with-temp-buffer
+      (insert (decode-base64-string str))
+      (write-region-as-binary (point-min) (point-max) filename)
+      )))
+@end lisp
+@end defmac
 
 
-@defvar mime-file-decoding-method-alist
+@defmac mel-define-method-function spec function
 
-Alist of encoding vs. corresponding method to write decoded region to
-file.@refill
+Set @var{spec}'s function definition to @var{function}.@refill
 
-Each element looks like @code{(STRING . FUNCTION)}.  STRING is
-content-transfer-encoding.  FUNCTION is function to write decoded region
-to file.
-@end defvar
+First element of @var{spec} is service.@refill
+
+Rest of @var{args} is like an argument list of lambda, but (car (last
+@var{args})) must be specialized parameter.  (car (car (last
+@var{args}))) is name of variable and (nth 1 (car (last @var{args}))) is
+name of backend (encoding).@refill
+
+Example:@refill
+
+@lisp
+(mel-define-method-function (mime-encode-string string (nil "base64"))
+			    'encode-base64-string)
+@end lisp
+@end defmac
+
+
+
+@node generic function for mel-backend,  , mel-backend, Content-Transfer-Encoding
+@section How to add encoding/decoding service
+
+@defmac mel-define-service name &optional  args doc-string
+
+Define @var{name} as a service for Content-Transfer-Encodings.@refill
+
+If @var{args} is specified, @var{name} is defined as a generic function
+for the service.@refill
+
+Example:@refill
+
+@lisp
+(mel-define-service encoded-text-encode-string (string encoding)
+  "Encode STRING as encoded-text using ENCODING.
+ENCODING must be string.")
+@end lisp
+@end defmac
 
 
 
@@ -751,28 +975,48 @@ FLIM はこれらを符号化・復号化する機能を提供します。
 @node Header encoder/decoder,  , encoded-word, encoded-word
 @section Header の符号化・復号化
 
-@defun eword-encode-header &optional  code-conversion separator
+@defun eword-decode-header &optional  code-conversion separator
 
-Decode MIME encoded-words in header fields.@refill
+Header 中の encoded-word を復号する。@refill
 
-If @var{code-conversion} is @code{nil}, it decodes only encoded-words.
-If it is mime-charset, it decodes non-ASCII bit patterns as the
-mime-charset.  Otherwise it decodes non-ASCII bit patterns as the
-default-mime-charset.@refill
+もし @var{code-conversion} が @code{nil} なら、encoded-word だけが復号さ
+れる。もし、@var{code-conversion} が MIME charset (@ref{MIME charset}) 
+なら、非 ASCII bit patterns はその MIME charset として復号される。これ以
+外の場合、非 ASCII bit patterns は@code{default-mime-charset}. として復
+号される。(cf. @ref{entity formatting}) @refill
 
-If @var{separator} is not nil, it is used as header separator.
+もし @var{separator} が @code{nil} でなければ、その値がheader separator 
+として用いられる。
 @end defun
 
 
 @defun eword-encode-header &optional  code-conversion
 
-Encode header fields to network representation, such as MIME
-encoded-word.@refill
+Header を network 表現に符号化する。@refill
 
-It refer variable @code{eword-field-encoding-method-alist}.
+各 field は @code{eword-field-encoding-method-alist} で指定された方式で
+符号化される。
 @end defun
 
 
+@defvar eword-field-encoding-method-alist
+
+Association list to specify field encoding method.  Each element looks
+like (FIELD . METHOD).@refill
+
+If METHOD is @code{mime}, the FIELD will be encoded into MIME format
+(encoded-word).@refill
+
+If METHOD is @code{nil}, the FIELD will not be encoded.@refill
+
+If METHOD is a MIME charset, the FIELD will be encoded as the charset
+when it must be convert into network-code.@refill
+
+Otherwise the FIELD will be encoded as variable
+@code{default-mime-charset} when it must be convert into network-code.
+@end defvar
+
+
 
 @node custom, Appendix, encoded-word, Top
 @chapter 一般設定
@@ -785,15 +1029,6 @@ MIME 関連機能に関する group.@refill
 @end deffn
 
 
-@defvar default-mime-charset
-
-適切な MIME charset (@ref{MIME charset}) が見つからなかった場合に用いら
-れるMIME charset.@refill
-
-本来は APEL の変数である。
-@end defvar
-
-
 @defvar mime-temp-directory
 
 MIME 機能に関する実装が一時的に使用する file を作成する 
@@ -824,10 +1059,10 @@ directory.@refill
 @menu
 * 7bit::                        
 * 8bit::                        
-* Base64::                      
 * ASCII::                       
-* Coded character set::         Coded character set（符号化文字集合）, Character code（文字符号）
+* Base64::                      
 * binary::                      
+* Coded character set::         Coded character set（符号化文字集合）, Character code（文字符号）
 * media-type::                  
 * message::                     
 * MIME::                        
@@ -869,7 +1104,7 @@ byte 以内であることを求めている。よって、これ以上の行が含まれる可能性の
 encodeする必用がある。
 
 
-@node 8bit, Base64, 7bit, Glossary
+@node 8bit, ASCII, 7bit, Glossary
 @subsection 8bit
 @cindex binary
 
@@ -908,23 +1143,7 @@ data は @strong{binary} (@ref{binary}) と呼ぶことにする。@refill
 ある。
 
 
-@node Base64, ASCII, 8bit, Glossary
-@subsection Base64
-@cindex pad
-
-RFC 2045 (@ref{RFC 2045}) で定義されている MIME (@ref{MIME}) における 
-binary data (@ref{binary}) の network での変換法の１つ。@refill
-
-『64 進数』という意味で、3 byte の data を 0 から 63 の数を表す ASCII
-(@ref{ASCII}) 4 文字に変換する方法。（もし、4 文字にならなければ 
-@strong{pad} と呼ばれる詰め物をして長さを調整する）@refill
-
-この 65 種類の文字は ASCII と EBCDIC の共通部分から選ばれており、
-Internet 以外の network を経由する場合でも安全に転送できるように設計さ
-れている。
-
-
-@node ASCII, Coded character set, Base64, Glossary
+@node ASCII, Base64, 8bit, Glossary
 @subsection ASCII
 @cindex ANSI X3.4:1986
 @cindex ASCII
@@ -942,13 +1161,23 @@ Interchange'', ANSI X3.4:1986.
 
 
 
-@node Coded character set, binary, ASCII, Glossary
-@subsection Coded character set（符号化文字集合）, Character code（文字符号）
+@node Base64, binary, ASCII, Glossary
+@subsection Base64
+@cindex pad
 
-文字と byte 列と１対１に対応付ける曖昧でない規則の集合。
+RFC 2045 (@ref{RFC 2045}) で定義されている MIME (@ref{MIME}) における 
+binary data (@ref{binary}) の network での変換法の１つ。@refill
+
+『64 進数』という意味で、3 byte の data を 0 から 63 の数を表す ASCII
+(@ref{ASCII}) 4 文字に変換する方法。（もし、4 文字にならなければ 
+@strong{pad} と呼ばれる詰め物をして長さを調整する）@refill
+
+この 65 種類の文字は ASCII と EBCDIC の共通部分から選ばれており、
+Internet 以外の network を経由する場合でも安全に転送できるように設計さ
+れている。
 
 
-@node binary, media-type, Coded character set, Glossary
+@node binary, Coded character set, Base64, Glossary
 @subsection binary
 @cindex binary data
 @cindex binary
@@ -965,7 +1194,13 @@ Interchange'', ANSI X3.4:1986.
 とがある。
 
 
-@node media-type, message, binary, Glossary
+@node Coded character set, media-type, binary, Glossary
+@subsection Coded character set（符号化文字集合）, Character code（文字符号）
+
+文字と byte 列と１対１に対応付ける曖昧でない規則の集合。
+
+
+@node media-type, message, Coded character set, Glossary
 @subsection media-type
 @cindex x-token
 @cindex primary-type/subtype
@@ -982,7 +1217,7 @@ Interchange'', ANSI X3.4:1986.
 MIME (@ref{MIME}) における entity (@ref{entity}) の種類。
 @strong{primary-type} と @strong{subtype} からなる。RFC 2046 (@ref{RFC 2046}) で定義されている。@refill
 
-type は標準では
+primary-type は標準では
 
 @itemize @bullet
 @item
@@ -1246,7 +1481,7 @@ Standards Track (obsolete RFC 1521, 1522, 1590).
 
 ASCII (@ref{ASCII}) のみからなり ISO 2022 による符号拡張は許されない。
 
-Internet message における標準の符号化文字集合(@ref{Coded character set})
+Internet message における標準の符号化文字集合(@ref{Coded character set}) 
 であり、明示的に MIME charset が示されない場合は原則として 
 @strong{us-ascii} が使われる。@refill
 
@@ -1330,7 +1565,7 @@ CVS を用いた開発に参加したい方は
 @node History,  , CVS, Appendix
 @section 歴史
 
-FLIM の code の最古の部分は 榎並 嗣智 氏が書いた @file{mime.el}に起源し
+FLIM の code の最古の部分は 榎並 嗣智 氏が書いた @file{mime.el} に起源し
 ます。この小さな program は Nemacs で動作する iso-2022-jp の B-encoding 
 専用の encoded-word の復号化プログラムでした。@refill
 
@@ -1374,7 +1609,7 @@ tm では後に、守岡 知彦 によって @file{tiny-mime.el} の再実����後に、APEL から @file{std11.el} が移され、また、@file{mailcap.el},
 @file{eword-decode.el} および @file{eword-encode.el} が SEMI から移され、
-package の名前が FLIMとなります。@refill
+package の名前が FLIM となります。@refill
 
 この直前から田中 哲 氏がより RFC に忠実な実装を書き始め、これは、現在、
 FLIM の枝である ``FLIM-FLAM'' となっています。