X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=e4bc50bcb8e3ba8da76959bedd39d015667c6b5e;hb=39a7e604f4a4edfdbeb0367623632240cce73d48;hp=9c1eb671f9e851bf5659ea89e26ad67982df7162;hpb=945310cfcf1667145732f0aca9d4bd835eebe01d;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index 9c1eb67..e4bc50b 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$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!#(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
+
+$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
+
+
+mime-entity $B$G$O!"$3$l$HF1MM$N(B
+$BA0=R$N$h$&$K!"(BMIME message $B$O(B entity $B$rC10L$H$7$?LZ9=B$$K$J$C$F$$$k$N$G!"(B
+$B$3$N:,$G$"$k(B message $BA4BN$b(B mime-entity $B$GI=8=$9$k$3$H$,$G$-!"(Bbuffer
+local $BJQ?t(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$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$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"(B
+$BHs(B-
+entity $B$N(B node-id $B$rJV$9!#(B
+
+entity $B$N(B entity-number $B$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
+
+message $B$+$i!"(Bentity-node-id $B$N(B entity $B$rJV$7$^(B
+$B$9!#(B
+
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+
+message $B$+$i!"(Bcid $B$N(B entity $B$rJV$7$^$9!#(B
+
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+
+
+entity $B$N(B content-type $B$rJV$9!#(B
+entity $B$N(B content-disposition $B$rJV$9!#(B
+entity $B$N(B file $BL>$rJV$9!#(B
+
+entity $B$N(B content-transfer-encoding $B$rJV$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$NFbMF$,4{$K%3!<%IJQ49$5$l$F$$$k>l9g$O(B nil $B$GL5$$CM(B
+$B$rJV$9!#(B
+
+
+entity $B$N(B header $BCf$N(B field-name $BMs$N(B body $B$rJV$9!#(B
+
+$B7k2L$NJ8;zNs$O(B network $BI=8=$N$^$^$G$"$k!#(B
+
+entity $B$,>JN,$5$l$?>l9g$O!"(B
+
+field-name $BMs$,B8:_$7$J$$>l9g$O(B
+entity $B$N(B header $BCf$N(B field-name $BMs$r9=J82r@O$7$?(B
+$B7k2L$rJV$9!#(B
+
+$B7k2L$N7A<0$OMsKh$K0[$J$k!#Hs9=B$2=Ms$N>l9g$OJ8;zNs$rJV$7!"9=B$2=Ms$N>l9g(B
+$B$O$=$N7A<0$K=>$C$?(B list $B$rJV$9!#(B
+
+$B7k2LCf$NJ8;zNs$O(B Emacs $B$NFbItI=8=$KJQ49$5$l$k!#(B
+
+entity $B$,>JN,$5$l$?>l9g$O!"(B
+
+field-name $BMs$,B8:_$7$J$$>l9g$O(B nil $B$rJV$9!#(B
+
+
+$B8=:_0LCV$K(B entity $B$NI|9f$7$?(B header $B$rA^F~$9$k!#(B
+
+invisible-fields $B$H(B visible-fields $B$O@55,I=8=$N(B
+list $B$G!"$=$l$>$l!"I=<($7$?$/$J$$(B field $BL>$HI=<($7$?$$MsL>$rI=8=$7$?$b$N(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
+$B$$!#(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.
-
-Each element looks like
-Alist of encoding vs. corresponding method to decode region.
-
-Each element looks like
-string $B$r(B encoding $B$H$7$FI|9f$7$?7k2L$rJV$7$^$9!#(B
+string $B$r(B encoding $B$H$7$FI|9f$7$?7k2L$rJV$9!#(B
-Alist of encoding vs. corresponding method to decode string.
-
-Each element looks like
-Insert file FILENAME encoded by ENCODING format.
+ENCODING format $B$GId9f2=$5$l$?(B file FILENAME $B$r(B
+$BA^F~$9$k!#(B
-Decode and write current region encoded by encoding into
-filename.
+encoding $B$GId9f2=$5$l$?8=:_$N(B region $B$rI|9f2=$7$F(B
+filename$B$K=q$-9~$_$^$9!#(B
-start and end are buffer positions.
+start $B$H(B end $B$O(B buffer $B$N0LCV$G$9!#(B
-Alist of encoding vs. corresponding method to insert encoded file.
-
-Each element looks like
-Alist of encoding vs. corresponding method to write decoded region to
-file.
+
-Each element looks like
-encoded-word $B$O(B header $B$GHs(B
-
-$B$^$?!"9T57$N0-$$$3$H$@$H8@$($^$9$,!"(Bencoded-word $B$rMQ$$$:$KHs(B
-
-FLIM $B$O$3$l$i$rId9f2=!&I|9f2=$9$k5!G=$rDs6!$7$^$9!#(B
+service $B$,;XDj$5$l$F$$$k>l9g$O$=$l$KBP$9$k(B
+Content-Transfer-Encoding $B$N(B list $B$rJV$7$^$9!#(B
+
-
-Decode MIME encoded-words in header fields.
+name $B$r(B (nth 1 (car (last args))) backend $B$N(B
+method $B4X?t$H$7$FDj5A$7$^$9!#(B
-If code-conversion is
-If separator is not nil, it is used as header separator.
-
-Encode header fields to network representation, such as MIME
-encoded-word.
-
-It refer variable
-MIME message $B$O(B
-message $BCf$N3F(B entity $B$OLZ$N@a$KEv$?$j$^$9$,!"$3$NLZ$K$O?<$5$HF1$8?<$5$N(B
-$BCf$N=gHV$K=>$C$FHV9f$,IU$1$k$3$H$,$G$-$^$9!#B($A!"(B
-
-
-mime-entity $B$G$O!"$3$l$HF1MM$N(B
-$BA0=R$N$h$&$K!"(BMIME message $B$O(B entity $B$rC10L$H$7$?LZ9=B$$K$J$C$F$$$^$9$,!"(B
-$B$3$N:,$G$"$k(B message $BA4BN$b(B mime-entity $B$GI=8=$9$k$3$H$,$G$-!"(Bbuffer
-local $BJQ?t(B
-
-entity $B$K4X$9$k>pJs$r<}$a$k9=B$BN!#(B
+name $B$r(B Content-Transfer-Encoding $B$N(B service $B$H$7$FDj5A$7$^(B
+$B$9!#(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
-
-
-$B$^$?!"2a5n$H$N8_49@-$N$?$a!"0J2<$NMWAGL>$N;2>H4X?t$bMxMQ2DG=$G$"$k!#(B
+
-entity $B$N@8@.;R!#(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
-
-$B8=:_$N(B buffer $B$r9=J82r@O$7$?7k2L$rJV$9!#(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
-
-
-entity $B$N(B entity-number $B$rJV$9!#(B
+$B$b$7(B separator $B$,(B
-entity $B$N?F$N(B entity $B$rJV$9!#(B
+
-message-structure $B$,>JN,$5$l$?>l9g$O(B entity $B$,B8:_$9$k(B
-buffer $B$K$*$1$k(B
-message-structure $B$,;XDj$5$l$?>l9g!"$3$l$r:,$H8+Jo$9!#(B
+$B3F(B field $B$O(B
-entity $B$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"(B
-$BHs(B-
-
-entity $B$N(B header $BCf$N(B field-name $BMs$N(B body $B$rJV$9!#(B
+METHOD $B$,(B
-$B7k2L$NJ8;zNs$O(B network $BI=8=$N$^$^$G$"$k!#(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
-field-name $BMs$,B8:_$7$J$$>l9g$O(B nil $B$rJV$9!#(B
-
-entity $B$N(B header $BCf$N(B field-name $BMs$r9=J82r@O$7$?(B
-$B7k2L$rJV$9!#(B
-
-$B7k2L$N7A<0$OMsKh$K0[$J$k!#Hs9=B$2=Ms$N>l9g$OJ8;zNs$rJV$7!"9=B$2=Ms$N>l9g(B
-$B$O$=$N7A<0$K=>$C$?(B list $B$rJV$9!#(B
-
-$B7k2LCf$NJ8;zNs$O(B Emacs $B$NFbItI=8=$KJQ49$5$l$k!#(B
-
-field-name $BMs$,B8:_$7$J$$>l9g$O(B nil $B$rJV$9!#(B
-
-$B8=:_0LCV$K(B entity $B$NI|9f$7$?(B header $B$rA^F~$9$k!#(B
+
-invisible-fields $B$H(B visible-fields $B$O@55,I=8=$N(B
-list $B$G!"$=$l$>$l!"I=<($7$?$/$J$$(B field $BL>$HI=<($7$?$$MsL>$rI=8=$7$?$b$N(B
-$B$G$"$k!#(B
+MIME $B4XO"5!G=$K4X$9$k(B group.
-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
-
-
-
-$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
@@ -726,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
-$B$"$k(B message $B$b$7$/$O(B multipart message $B$N#1$D$N(B part $B$N(B header $B$H(B
-body $B$rJ;$;$?$b$N!#(B
+$BJ8;z$H(B byte $BNs$H#1BP#1$KBP1~IU$1$k[#Kf$G$J$$5,B'$N=89g!#(B
-type $B$OI8=`$G$O(B
+primary-type $B$OI8=`$G$O(B
Message $B$H(B Entity
+
Entity $B$N@8@.(B
+
mime-message-structure
$B$K3JG<$9$k!#(B
+ Entity $B3,AX(B
+
(1 2 3)
$B$N$h$&$J@0?t$N%j%9%H$H$7$FI=8=$5$l$^$9!#(B
+(3 2 1)
$B$G$9!#(B
+mime-message-structure
$B$K3JG<$9$k$3$H$K$7$^$9!#(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
+ Entity $B$N8!:w(B
+
mime-message-structrue
$B$,;H$o$l$^$9!#(B
+mime-message-structure
$B$,;H$o$l$^$9!#(B
+mime-message-structure
$B$,;H$o$l$^$9!#(B
+ Entity $B$NB0@-(B
+
"7bit"
$B$rMQ$$$k!#(B
+ Entity header $B$N>pJs(B
+
mime-message-structure
$B$NCM$rMQ$$$k!#(B
+nil
$B$rJV$9!#(B
+mime-message-structure
$B$NCM$rMQ$$$k!#(B
+ Entity $B$NJ8;zI=8=(B
+
Content-Transfer-Encoding $B$NId9f2=!&I|9f2=(B
+
$BId9f2=!&I|9f2=(B
$BNN0h$NId9f2=!&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
-
(STRING . FUNCTION)
.
-STRING is content-transfer-encoding.
-FUNCTION is string decoder.
- File $B$NId9f2=!&I|9f2=(B
-
(STRING . FUNCTION)
. STRING is
-content-transfer-encoding. FUNCTION is function to insert encoded
-file.
- $BB>$N(B utility
+
(STRING . FUNCTION)
. STRING is
-content-transfer-encoding. FUNCTION is function to write decoded
-region to file.
- encoded-word
-
Header $B$NId9f2=!&I|9f2=(B
-
$BId9f2=(B/$BI|9f2=(B module $B$N=q$-J}(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.
+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
eword-field-encoding-method-alist
.
- Message $B$H(B Entity
-
(1 2 3)
$B$N$h$&$J@0?t$N%j%9%H$H$7$FI=8=$5$l$^$9!#(B
+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
(3 2 1)
$B$G$9!#(B
+$BNc(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
-
$BId9f2=(B/$BI|9f2=(B service $B$rDI2C$9$kJ}K!(B
+
mime-entity-$BMWAGL>(B
$B$H$$$&L>A0$N;2(B
-$B>H4X?t$rMQ$$$k!#(B
+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
Header $B$N(B network $BI=8=(B
+
Message $B$N2r@O4o(B
-
Header $B$NId9f2=!&I|9f2=(B
+
mime-message-structure
$B$K3JG<$9$k!#(B
+ Entity $B$N0LCV4X78$K4X$9$k5!G=(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
mime-message-structure
$B$NCM$rMQ$$$k!#(B
+Header $B$r(B network $BI=8=$KId9f2=$9$k!#(B
eword-field-encoding-method-alist
$B$G;XDj$5$l(B
+$B$?J}<0$GId9f2=$5$l$k!#(B
nil
$B$rJV$9!#(B
- Entity header $B$N>pJs(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
+
- Entity $B$NFbMF(B
-
MIME_TMP_DIR
, TM_TMP_DIR
,
+TMPDIR
, TMP
$B$b$7$/$O(B TEMP
$B$,@_Dj(B
+$B$5$l$F$$$?>l9g!"$=$l$r=i4|CM$H$7$FMQ$$$k!#2?$b@_Dj$5$l$F$$$J$$>l9g!"(B
+"/tmp/"
$B$rMQ$$$k!#(B
+ $BIUO?(B
@@ -699,21 +1013,6 @@ data $B$O(B
Base64
-
ASCII
Coded character set$B!JId9f2=J8;z=89g!K(B, Character code$B!JJ8;zId9f!K(B
-
Base64
+
binary
@@ -747,11 +1055,10 @@ 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
-
Entity
-
Coded character set$B!JId9f2=J8;z=89g!K(B, Character code$B!JJ8;zId9f!K(B
+
media-type
@@ -761,7 +1068,7 @@ body $B$rJ;$;$?$b$N!#(B