X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=e358ca0cbc5e5ea275e2ebea6e23d047dc5342f5;hb=41e4fd4242e2a1f959c312e74854025cbb9d0f80;hp=e71a7696cb569623bac7ca208dab2977df58f3cd;hpb=108a5fc4eb11aca66dd106b332d6fd97975b711e;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index e71a769..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
-Open an entity and return it.
+Entity $B$r3+$$$F!"$=$l$rJV$7$^$9!#(B
-type is representation-type.
-location is location of entity. Specification of it is
-depended on representation-type.
+location $B$O(B entity $B$N0LCV$G$9!#;XDjJ}K!$O(B
+representation-type $B$K0M$C$FJQ$o$j$^$9!#(B
-Return entity from entity-number in message.
+message $B$+$i!"(Benity-number $B$N(B entity $B$rJV$7$^$9!#(B
-If message is not specified,
-
-Return entity from entity-node-id in message.
+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
-If message is not specified,
-
-Return non-nil if contents of entity has been already
-code-converted.
+entity $B$NFbMF$,4{$K%3!<%IJQ49$5$l$F$$$k>l9g$O(B nil $B$GL5$$CM(B
+$B$rJV$9!#(B
+
$B8=:_0LCV$K(B entity $B$NI|9f$7$?(B header $B$rA^F~$9$k!#(B
@@ -274,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
+
-Write content of entity into filename.
+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
-Write representation of entity into filename.
+entity $B$NI=8=$r(B filename $B$K=q$-9~$_$^$9!#(B
-Write body of entity into filename.
+entity $B$N(B body $B$r(B filename $B$K=q$-9~$_$^$9!#(B
-$B!J$9$_$^$;$s!#$=$N$&$A=q$-$^$9(B (^_^;$B!K(B
+
-$B!J$H$j$"$($:!"(Bmm*.el $B$r;29M$K$7$F$/$@$5$$!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:
+
+mime-message-structure
is used.
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+mime-message-structrue
$B$,;H$o$l$^$9!#(B
mime-message-structure
$B$,;H$o$l$^$9!#(B
+mime-message-structure
is used.
+message $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B
+mime-message-structure
$B$,;H$o$l$^$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
+
mm
$B$rIU$1$?$b$N$K$J$C$F
mm-backend $B$N:n$jJ}(B
Content-Type $BMs$N>pJs(B
@@ -633,99 +719,144 @@ Content-Transfer-Encoding $BMs$,B8:_$7$J$$>l9g$O(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(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
@@ -748,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
-