X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=e358ca0cbc5e5ea275e2ebea6e23d047dc5342f5;hb=41e4fd4242e2a1f959c312e74854025cbb9d0f80;hp=8ef8a2bf51f262a6daf21028b945e30db9891823;hpb=a5602f76cd2cda59bd15e32ad9b34802f30f4e78;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index 8ef8a2b..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
-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
-Insert before point a contents of entity as text entity.
+point $B$NA0$K(B entity $B$r(B text entity $B$H$7$FA^F~$7$^$9!#(B
-Contents of the entity are decoded as
+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
-Define type as a mm-backend.
+type $B$r(B mm-backend $B$H$7$FDj5A$7$^$9!#(B
-If PARENTS is specified, type inherits parents.
-Each parent must be representation-type.
+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
-Example:
+$BNc(B:
-Define name as a method function of (nth 1 (car
-args)) backend.
+name $B$r(B (nth 1 (car args)) backend $B$N(B method $B4X(B
+$B?t$H$7$FDj5A$7$^$9!#(B
-args is like an argument list of lambda, but (car
-args) must be specialized parameter. (car (car
-args)) is name of variable and (nth 1 (car
-args)) is name of backend (representation-type).
+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
-Example:
+$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
-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
-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
-Return list of Content-Transfer-Encoding.
+Content-Transfer-Encoding $B$N(B list $B$rJV$7$^$9!#(B
-If service is specified, it returns available list of
-Content-Transfer-Encoding for it.
+service $B$,;XDj$5$l$F$$$k$H!"$=$l$KBP$9$k(B
+Content-Transfer-Encoding $B$rJV$7$^$9!#(B
-Return table of Content-Transfer-Encoding for completion.
+$BJd40$N$?$a$N(B Content-Transfer-Encoding $B$NI=$rJV$7$^$9!#(B
-If service is specified, it returns available list of
-Content-Transfer-Encoding for it.
+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
-Define name as a method function of (nth 1 (car (last
-args))) backend.
+name $B$r(B (nth 1 (car (last args))) backend $B$N(B
+method $B4X?t$H$7$FDj5A$7$^$9!#(B
-args is like an argument list of lambda, but (car (last
-args)) must be specialized parameter. (car (car (last
-args))) is name of variable and (nth 1 (car (last
-args))) is name of backend (encoding).
+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
-Example:
+$BNc(B:
-Set spec's function definition to function.
+spec $B$N4X?tDj5A$r(B function $B$K@_Dj$7$^$9!#(B
-First element of spec is service.
+spec $B$N:G=i$NMWAG$O(B service $B$G$9!#(B
-Rest of args is like an argument list of lambda, but (car
-(last args)) must be specialized parameter. (car (car
-(last args))) is name of variable and (nth 1 (car (last
-args))) is name of backend (encoding).
+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
-Example:
+$BNc(B:
-Define name as a service for Content-Transfer-Encodings.
+name $B$r(B Content-Transfer-Encoding $B$N(B service $B$H$7$FDj5A$7$^(B
+$B$9!#(B
-If args is specified, name is defined as a
-generic function for the service.
+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
-Example:
+$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 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
default-mime-charset
is
-used as default value.
+entity $B$NFbMF$O(B default-mime-charset
$B$,=i4|CM$H$7$F;H$o$l$^$9!#(B
Entity $B$N%M%C%H%o!<%/I=8=(B
+
mm
$B$rIU$1$?$b$N$K$J$C$F
Other utilities
+
$BB>$N(B utility
How to write encoder/decoder module
+
$BId9f2=(B/$BI|9f2=(B module $B$N=q$-J}(B
How to add encoding/decoding service
+
$BId9f2=(B/$BI|9f2=(B service $B$rDI2C$9$kJ}K!(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