X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=e358ca0cbc5e5ea275e2ebea6e23d047dc5342f5;hb=41e4fd4242e2a1f959c312e74854025cbb9d0f80;hp=f279606add4cb4b7b1fc91486a8514ece22544eb;hpb=0a565218932e7c62c0fd86a625bf30b270235fe6;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index f279606..e358ca0 100644 --- a/mime-ja.sgml +++ b/mime-ja.sgml @@ -1,8 +1,8 @@
--This file documents MIME features of FLIM, a Internet message -parsing/encoding library for GNU Emacs. +This file documents MIME features of FLIM, a fundamental library to +process Internet Messages for GNU Emacsen.
-GNU Emacs $BMQ$N(B Internet Message $B$N2r@O$dId9f2=$K4X$9$k(B library $B$G$"$k(B -FLIM $B$N(B MIME $B5!G=$K4X$7$F@bL@$7$^$9!#(B +GNU Emacsen $BMQ$N(B Internet Message $B=hM}$N$?$a$N4pAC(B library $B$G$"$k(B FLIM +$B$N(B MIME $B5!G=$K4X$7$F@bL@$7$^$9!#(B
-RFC 2045 $B$NDj5A$O!"(BMIME message $B$,(B entity $B$rC10L$H$9$kLZ9=B$$G$"$k$3$H$r(B -$B<($7$F$$$^$9!#(Bmessage $B$O2^$G<($9$h$&$JLZ$H$J$j!"(Bentity $B$O$3$NLZ$K$*$1(B -$B$k@a$H$J$j$^$9!#$D$^$j!"(BMIME $B$O(B message $B$rLZ9=B$$K3HD%$7$?Lu$G$9!#(B +RFC 2045 $B$NDj5A$O!"(BMIME message $B$,(B entity $B$r@a$H$9$kLZ9=B$$G$"$k$3$H$r(B +$B<($7$F$$$^$9!#$D$^$j!"(BMIME $B$O(B message $B$rLZ9=B$$K3HD%$7$?Lu$G$9!#(B
FLIM $B$O(B entity $B$N>pJs$rI=8=$9$k$?$a$K(B
+
+Entity $B$r3+$$$F!"$=$l$rJV$7$^$9!#(B
+
+type $B$O(B representation-type $B$G$9!#(B
+location $B$O(B entity $B$N0LCV$G$9!#;XDjJ}K!$O(B
+representation-type $B$K0M$C$FJQ$o$j$^$9!#(B
+
+buffer $B$r(B message $B$H$7$F9=J82r@O$7!"$=$N7k2L$N(B mime-entity
+$B$r(B buffer $B$N(B
+buffer $B$,>JN,$5$l$?>l9g!"8=:_$N(B buffer $B$r9=J82r@O$9$k!#(B
+
+type $B$,;XDj$5$l$?>l9g!"$=$NCM$r@8@.$5$l$k(B mime-entity $B$NI=(B
+$B>]7?$H$7$FMQ$$$k!#>JN,$5$l$?>l9g$O(B buffer $B$H$J$k!#(Bmime-message-structure
$B$K3JG<$9$k!#(B
+
+MIME message $B$O(B entity $B$rC10L$H$9$kLZ9=B$$K$J$C$F$$$^$9!#(B +
+$B$3$NLZ$K$*$$$F:,$H$J$k@a$O(B message $BA4BN$rI=$9(B entity $B$G$9!#$3$3$G$O!"(B
+$B$3$l$r(B
+root-entity $B0J30$N(B entity $B$O?F$r;}$A$^$9!#$^$?!"(Bentity $B$O;R6!$r;}$D$+(B +$B$bCN$l$^$;$s!#$3$N?F;R4X78$r9M$($k$3$H$G(B entity $B$NAjBP4X78$r07$&$3$H$,(B +$B$G$-$^$9!#(B
-$BA0=R$N$h$&$K!"(Bmessage $BCf$N3F(B entity $B$OLZ$N@a$KEv$?$j$^$9$,!"$3$NLZ$K$O(B -$B?<$5$HF1$8?<$5$NCf$N=gHV$K=>$C$FHV9f$,IU$1$k$3$H$,$G$-$^$9!#B($A!"(B +$B0lJ}!"(Bentity $B$N(B message $B$K$*$1$k0LCV$r9M$($k$3$H$b$G$-$^$9!#(B +
+entity $B$O$3$NLZ$K$*$1$k@a$H$J$j$^$9$,!"$3$NLZ$K$O?<$5$HF1$8?<$5$NCf$N(B
+$B=gHV$K=>$C$FHV9f$,IU$1$k$3$H$,$G$-$^$9!#B($A!"(B
-
-entity $B$K4X$9$k>pJs$r<}$a$k9=B$BN!#(B
-$B$3$N9=B$BN$r;2>H$9$k$K$O(B
-$B$3$N9=B$BN$NMWAG$O0J2<$NDL$j$G$"$k!'(B
+
+$B8=:_$N(B buffer $B$K$*$1$k(B message $BA4BN$N(B mime-entity $B9=B$BN$r3JG<$9$k(B
+buffer local $BJQ?t!#(B
+
-$B$^$?!"2a5n$H$N8_49@-$N$?$a!"0J2<$NMWAGL>$N;2>H4X?t$bMxMQ2DG=$G$"$k!#(B
+entity $B$K4^$^$l$k(B entity $B$N(B list $B$rJV$9!#(B
+
+entity $B$N?F$N(B entity $B$rJV$9!#(B
+
+message $B$,;XDj$5$l$?>l9g!"$3$l$r:,$H8+Jo$9!#(B
+
-entity $B$N@8@.;R!#(B
+entity $B$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"(B
+$BHs(B-
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B entity $B$N@hF,0LCV$rJV$9!#(B
+entity $B$N(B node-id $B$rJV$9!#(B
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B entity $B$NKvHx0LCV$rJV$9!#(B
+entity $B$N(B entity-number $B$rJV$9!#(B
-
-$B8=:_$N(B buffer $B$r9=J82r@O$7$?7k2L$rJV$9!#(B
+message $B$+$i!"(Benity-number $B$N(B entity $B$rJV$7$^$9!#(B
+
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+
-buffer $B$r9=J82r@O$7!"$=$N7k2L$r(B buffer $B$N(B
-
-buffer $B$,>JN,$5$l$?>l9g!"8=:_$N(B buffer $B$r9=J82r@O$9$k!#(B
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+
-
-$B8=:_$N(B buffer $B$K$*$1$k(B message $BA4BN$N(B mime-entity $B9=B$BN$r3JG<$9$k(B
-buffer local $BJQ?t!#(B
-
-entity $B$N(B entity-number $B$rJV$9!#(B
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+
-Return entity from entity-number in message.
+
-If message is not specified,
-
-Return entity from entity-node-id in message.
+entity $B$N(B content-disposition $B$rJV$9!#(B
-If message is not specified,
-
-entity $B$N?F$N(B entity $B$rJV$9!#(B
+entity $B$N(B content-transfer-encoding $B$rJV$9!#(B
-message $B$,;XDj$5$l$?>l9g!"$3$l$r:,$H8+Jo$9!#(B
+$B$b$7!"(Bentity $B$K(B Content-Transfer-Encoding $BMs$,B8:_$7$J$$>l(B
+$B9g$O!"(Bdefault-encoding $B$rJV$9!#$3$l$,;XDj$5$l$J$$>l9g$O!"(B
+
-entity $B$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"(B
-$BHs(B-
-field-name $BMs$,B8:_$7$J$$>l9g$O(B nil $B$rJV$9!#(B
+field-name $BMs$,B8:_$7$J$$>l9g$O(B
+
$B8=:_0LCV$K(B entity $B$NI|9f$7$?(B header $B$rA^F~$9$k!#(B
@@ -278,9 +291,31 @@ list $B$G!"$=$l$>$l!"I=<($7$?$/$J$$(B field $BL>$HI=<($7$?$$MsL>$rI=8=$7$?$b$
$B$G$"$k!#(B
invisible-fields $B$NMWAG$N$I$l$+$K(B match $B$7!"$+$D!"(B
-visible-fields $B$NMWAG$N$I$l$K$b(B match $B$7$J$$Ms$OI=<($5$l$J$$!#(B
+visible-fields $B$NMWAG$N$I$l$K$b(B match $B$7$J$$Ms$OI=<($5$l$J(B
+$B$$!#(B
+
+
+point $B$NA0$K(B entity $B$r(B text entity $B$H$7$FA^F~$7$^$9!#(B
+
+entity $B$NFbMF$O(B
+$BE,@Z$J(B
+$BK\Mh$O(B APEL $B$NJQ?t$G$"$k!#(B
+
+pointo $B$N0LCV$K(B entity $B$NFbMF$rA^F~$7$^$9!#(B
+
+entity $B$NFbMF$r(B filename $B$K=q$-9~$_$^$9!#(B
+
+
+entity $B$N(B header $B$H(B body $B$r(B point $B$N$H$3$m$KA^F~$7$^$9!#(B
+
+entity $B$NI=8=$r(B filename $B$K=q$-9~$_$^$9!#(B
+
+entity $B$N(B body $B$r(B filename $B$K=q$-9~$_$^$9!#(B
+
+
+entity $B$,B8:_$9$k(B buffer $B$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bentity $B$,@j$a$k(B
+$BNN0h$N@hF,0LCV$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bentity $B$,@j$a$k(B
+$BNN0h$NKvHx0LCV$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bheader $B$,@j$a$kNN0h$N@hF,(B
+$B0LCV$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bheader $B$,@j$a$kNN0h$NKvHx(B
+$B0LCV$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bbody $B$,@j$a$kNN0h$N@hF,0L(B
+$BCV$rJV$9!#(B
+
+entity $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bbody $B$,@j$a$kNN0h$NKvHx0L(B
+$BCV$rJV$9!#(B
+
+Entity $B$OCj>]2=$5$l$?%G!<%?I=8=$G!"
+$BA0@a$^$G$K=R$Y$FMh$?(B entity $B$KBP$9$k=hM}$O!"(Bentity $B$KBP$7$F$=$N=hM}$r0M(B
+$BMj$9$k$3$H$K$h$C$F
+mm-backend $B$O(B representation-type $B$NL>A0$N@hF,$K(B
+
+entity $B$K(B message $B$rAw$k!#(B
+
+args $B$O(B message $B$N0z?t$G$"$k!#(B
+
+
+type $B$r(B mm-backend $B$H$7$FDj5A$7$^$9!#(B
+
+PARENTS $B$,;XDj$5$l$F$$$k>l9g$O!"(Btype $B$O(B prents
+$B$r7Q>5$7$^$9!#$=$l$>$l$N(B parent $B$O(B representation-type $B$G$"$kI,MW$,$"(B
+$B$j$^$9!#(B
+
+$BNc(B:
+
+
+name $B$r(B (nth 1 (car args)) backend $B$N(B method $B4X(B
+$B?t$H$7$FDj5A$7$^$9!#(B
+
+args $B$O(B lambda $B$N0z?t%j%9%H$N$h$&$J$b$N$G$9$,!"(B(car
+args) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car
+(car args)) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car args))
+$B$O(B backend $B$NL>A0(B (representation-type) $B$G$9!#(B
+
+$BNc(B:
+
+
-Encode region start to end of current buffer
-using encoding.
+$B8=:_$N(B buffer $B$N(B start $B$+$i(B end $B$^$G$N(B region $B$r(B
+encoding $B$r;H$C$FId9f2=$7$^$9!#(B
-Decode region start to end of current buffer
-using encoding.
+$B8=:_$N(B buffer $B$N(B start $B$+$i(B end $B$^$G$N(B region $B$r(B
+encoding $B$r;H$C$FI|9f2=$7$^$9!#(B
-Alist of encoding vs. corresponding method to encode region.
+string $B$r(B encoding $B$H$7$FI|9f$7$?7k2L$rJV$9!#(B
+
-Each element looks like
-Alist of encoding vs. corresponding method to decode region.
+encoding $B$GId9f2=$5$l$?8=:_$N(B region $B$rI|9f2=$7$F(B
+filename$B$K=q$-9~$_$^$9!#(B
-Each element looks like
-
+Content-Transfer-Encoding $B$N(B list $B$rJV$7$^$9!#(B
-string $B$r(B encoding $B$H$7$FI|9f$7$?7k2L$rJV$7$^$9!#(B
+service $B$,;XDj$5$l$F$$$k$H!"$=$l$KBP$9$k(B
+Content-Transfer-Encoding $B$rJV$7$^$9!#(B
-Alist of encoding vs. corresponding method to decode string.
+$BJd40$N$?$a$N(B Content-Transfer-Encoding $B$NI=$rJV$7$^$9!#(B
-Each element looks like
-
-Insert file FILENAME encoded by ENCODING format.
-
-Decode and write current region encoded by encoding into
-filename.
+args $B$O(B lambda $B$N0z?t(B list $B$H;w$F$$$^$9$,!"(B(car (last
+args)) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car
+(car (last args))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last
+args))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B
-start and end are buffer positions.
-
+
-Alist of encoding vs. corresponding method to insert encoded file.
+spec $B$N4X?tDj5A$r(B function $B$K@_Dj$7$^$9!#(B
-Each element looks like
+args $B$N;D$j$O(B lambda $B$N0z?t(B list $B;w$F$$$^$9$,!"(B(car (last
+args)) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car
+(car (last args))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last
+args))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B
+
+$BNc(B:
+
+
-Alist of encoding vs. corresponding method to write decoded region to
-file.
+
-Each element looks like
+args $B$,;XDj$5$l$F$$$k$H!"(Bname $B$O(B service $B$N(B
+generic function $B$H$7$FDj5A$5$l$^$9!#(B
+
+$BNc(B:
+
+
-
-Decode MIME encoded-words in header fields.
+Header $BCf$N(B encoded-word $B$rI|9f$9$k!#(B
-If code-conversion is
-If separator is not nil, it is used as header separator.
+$B$b$7(B separator $B$,(B
-Encode header fields to network representation, such as MIME
-encoded-word.
+Header $B$r(B network $BI=8=$KId9f2=$9$k!#(B
-It refer variable
+Field $B$rId9f2=$9$kJ}K!$r;XDj$9$kO"A[(B list$B!#3F(B element $B$O(B (FIELD
+. METHOD) $B$NMM$K$J$C$F$$$k!#(B
+
+METHOD $B$,(B
+METHOD $B$,(B
+METHOD $B$,(B MIME charset $B$G$"$l$P!"(BFIELD $B$O%M%C%H%o!<%/%3!<%I$KJQ49$7$J(B
+$B$1$l$P$J$i$J$$$H$-$K(B charset $B$KId9f2=$5$l$k!#(B
+
+$B$=$&$G$J$1$l$P!"(BFIELD $B$O%M%C%H%o!<%/%3!<%I$KJQ49$7$J$1$l$P$J$i$J$$$H$-(B
+$B$K(B $BJQ?t(B
-$BE,@Z$J(B
-$BK\Mh$O(B APEL $B$NJQ?t$G$"$k!#(B
-
MIME $B5!G=$K4X$9$k
-
-$B!X(B64 $B?J?t!Y$H$$$&0UL#$G!"(B3 byte $B$N(B data $B$r(B 0 $B$+$i(B 63 $B$N?t$rI=$9(B
-
-$B$3$N(B 65 $B
@@ -787,10 +1025,19 @@ A-Z, a-z $B$N(B Latin $BJ8;z$H?t;z!"4v$D$+$N5-9f$+$i$J$k!#(BISO 646 $B$N0l$
number="ANSI X3.4" year="1986">
-
-$BJ8;z$H(B byte $BNs$H#1BP#1$KBP1~IU$1$k[#Kf$G$J$$5,B'$N=89g!#(B
+
+$B!X(B64 $B?J?t!Y$H$$$&0UL#$G!"(B3 byte $B$N(B data $B$r(B 0 $B$+$i(B 63 $B$N?t$rI=$9(B
+
+$B$3$N(B 65 $B
+$BJ8;z$H(B byte $BNs$H#1BP#1$KBP1~IU$1$k[#Kf$G$J$$5,B'$N=89g!#(B
+
+
@@ -815,7 +1068,7 @@ data $B$r;X$9$3$H$,$"$k!#(B
-type $B$OI8=`$G$O(B
+primary-type $B$OI8=`$G$O(B
mime-message-structure
$B$K3JG<$9$k$3$H$K$7$^$9!#(B
-$B$=$7$F!"(Bentity-number $B$d(B node-id $B$rMQ$$$k$3$H$G(B
-mime-message-structure
$B$K$*$1$k(B entity $B$NAjBPE*$J0LCV4X78$r(B
-$B07$&$3$H$,$G$-$^$9!#(B
-
-
- mime-entity $B9=B$BN(B
-
mime-entity-$BMWAGL>(B
$B$H$$$&L>A0$N;2(B
-$B>H4X?t$rMQ$$$k!#(B
-mime-message-structure
$B$r5/E@$K(B entity-number $B$d(B node-id
+$B$G<($5$l$k(B entity $B$rnil
$B$rJV$9!#(B
Message $B$N2r@O4o(B
-
Entity $B$N8!:w(B
+
mime-message-structrue
$B$,;H$o$l$^$9!#(B
mime-message-structure
$B$K3JG<$9$k!#(B
+message $B$+$i!"(Bentity-node-id $B$N(B entity $B$rJV$7$^(B
+$B$9!#(B
mime-message-structure
$B$,;H$o$l$^$9!#(B
Entity $B$N0LCV4X78$K4X$9$k5!G=(B
-
mime-message-structure
$B$,;H$o$l$^$9!#(B
Entity $B$NB0@-(B
+
mime-message-structure
is used.
+entity $B$N(B content-type $B$rJV$9!#(Bmime-message-structure
is used.
+entity $B$N(B file $BL>$rJV$9!#(B
"7bit"
$B$rMQ$$$k!#(B
nil
$B$rJV$9!#(B
+entity $B$NFbMF$,4{$K%3!<%IJQ49$5$l$F$$$k>l9g$O(B nil $B$GL5$$CM(B
+$B$rJV$9!#(B
mime-message-structure
$B$NCM$rMQ$$$k!#(B
nil
$B$rJV$9!#(B
Entity $B$NJ8;zI=8=(B
+
default-mime-charset
$B$H$7$F2r
+default-mime-charset
$B$,=i4|CM$H$7$F;H$o$l$^$9!#(B
+ Entity $B$NFbMF(B
Entity $B$N%M%C%H%o!<%/I=8=(B
+
Entity $B$N(B buffer $B$K$h$kI=8=(B
+
Entity $B$NI=8=$H
mm
$B$H$$$&(B
+$B@\F,<-$rIU$1$?4X?tL>$+$i$J$k(B module $B$G!"$=$N(B module $BL>$OF1MM$K(B
+representation-type $B$NL>A0$N@hF,$K(B mm
$B$rIU$1$?$b$N$K$J$C$F(B
+$B$$$^$9!#$3$N(B module $B$O(B representation-type $B$N(B entity $B$,:G=i$K@8@.$5$l$k(B
+$B;~$K<+F0E*$K(B require $B$5$l$^$9!#(B
+
+
+ Entity $B$X$NJX$j(B
+
mm-backend $B$N:n$jJ}(B
+
Content-Type $BMs$N>pJs(B
$BNN0h$NId9f2=!&I|9f2=(B
-
$BId9f2=!&I|9f2=(B
+
(STRING . FUNCTION)
or
-(STRING . nil)
. string is
-content-transfer-encoding. function
is region encoder
-and nil
means not to encode.
-(STRING . FUNCTION)
or
-(STRING . nil)
. string is
-content-transfer-encoding. function
is region decoder
-and nil
means not to decode.
- $BJ8;zNs$NId9f2=!&I|9f2=(B
-
$BB>$N(B utility
+
(STRING . FUNCTION)
.
-STRING is content-transfer-encoding.
-FUNCTION is string decoder.
- File $B$NId9f2=!&I|9f2=(B
-
$BId9f2=(B/$BI|9f2=(B module $B$N=q$-J}(B
+
(STRING . FUNCTION)
. STRING is
-content-transfer-encoding. FUNCTION is function to insert encoded
-file.
- $BId9f2=(B/$BI|9f2=(B service $B$rDI2C$9$kJ}K!(B
+
(STRING . FUNCTION)
. STRING is
-content-transfer-encoding. FUNCTION is function to write decoded
-region to file.
- Header $B$N(B network $BI=8=(B
@@ -638,28 +879,48 @@ FLIM $B$O$3$l$i$rId9f2=!&I|9f2=$9$k5!G=$rDs6!$7$^$9!#(B
Header $B$NId9f2=!&I|9f2=(B
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.
+$B$b$7(B code-conversion $B$,(B nil
$B$J$i!"(Bencoded-word
+$B$@$1$,I|9f$5$l$k!#$b$7!"(Bcode-conversion $B$,(B default-mime-charset
. $B$H$7$FI|9f$5$l$k!#(Bnil
$B$G$J$1$l$P!"$=$NCM$,(B
+header separator $B$H$7$FMQ$$$i$l$k!#(B
eword-field-encoding-method-alist
.
+$B3F(B field $B$O(B eword-field-encoding-method-alist
$B$G;XDj$5$l(B
+$B$?J}<0$GId9f2=$5$l$k!#(B
mime
$B$G$"$l$P!"(BFIELD $B$O(B MIME format $B$KId9f2=$5(B
+$B$l$k(B (encoded-word)$B!#(B
+nil
$B$G$"$l$P!"(BFIELD $B$OId9f2=$5$l$J$$!#(B
+default-mime-charset
$B$GId9f2=$5$l$k(B
+ $B0lHL@_Dj(B
mail
$B$H(B news
$B$KB0$9$k!#(B
- Base64
-
ASCII
Coded character set$B!JId9f2=J8;z=89g!K(B, Character code$B!JJ8;zId9f!K(B
-
Base64
+
binary
@@ -808,6 +1055,12 @@ A-Z, a-z $B$N(B Latin $BJ8;z$H?t;z!"4v$D$+$N5-9f$+$i$J$k!#(BISO 646 $B$N0l$
data $B$r;X$9$3$H$,$"$k!#(B
+
Coded character set$B!JId9f2=J8;z=89g!K(B, Character code$B!JJ8;zId9f!K(B
+
media-type