X-Git-Url: http://git.chise.org/gitweb/?p=elisp%2Fflim.git;a=blobdiff_plain;f=mime-ja.texi;h=c7520bd62d698dbd792838443cb4782763bcc72f;hp=6b45bbc08c2b3a41ea2d3f7b7587f25c3a01af17;hb=refs%2Fheads%2Flimit-1_14;hpb=4b501c9c3b8542d840dc90c9b7d2147d024e4612 diff --git a/mime-ja.texi b/mime-ja.texi index 6b45bbc..c7520bd 100644 --- a/mime-ja.texi +++ b/mime-ja.texi @@ -1,22 +1,22 @@ \input texinfo.tex @c Generated automatically from mime-ja.sgml by sinfo 3.7. @setfilename mime-ja.info -@settitle{FLIM 1.10 MIME $B5!G=@bL@=q(B} +@settitle{FLIM 1.14 MIME $B5!G=@bL@=q(B} @titlepage -@title FLIM 1.10 MIME $B5!G=@bL@=q(B +@title FLIM 1.14 MIME $B5!G=@bL@=q(B @author $B -@subtitle 1998/07/01 +@subtitle 1999-01-27 @end titlepage @node Top, Introduction, (dir), (dir) -@top FLIM 1.10 MIME $B5!G=@bL@=q(B +@top FLIM 1.14 MIME $B5!G=@bL@=q(B @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 $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 @end ifinfo @menu @@ -75,10 +75,12 @@ FLIM $B$O(B entity $B$N>pJs$rI=8=$9$k$?$a$K(B@strong{mime-entity} $B9=(B @menu * Entity creation:: Entity $B$N@8@.(B * Entity hierarchy:: Entity $B3,AX(B +* Entity Search:: Entity $B$N8!:w(B * Entity Attributes:: Entity $B$NB0@-(B * Entity-header:: Entity header $B$N>pJs(B * entity formatting:: Entity $B$NJ8;zI=8=(B * Entity-content:: Entity $B$NFbMF(B +* Entity-network-representation:: Entity $B$N%M%C%H%o!<%/I=8=(B * Entity buffer:: Entity $B$N(B buffer $B$K$h$kI=8=(B * mm-backend:: Entity $B$NI=8=$HpJs$rI=8=$9$k$?$a$K(B@strong{mime-entity} $B9=(B @node Entity creation, Entity hierarchy, Entity, Entity @section Entity $B$N@8@.(B -@defun mime-open-entity &optional type location +@defun mime-open-entity type location -Open an entity and return it.@refill +Entity $B$r3+$$$F!"$=$l$rJV$7$^$9!#(B@refill -@var{type} is representation-type. (cf. @ref{mm-backend}) @refill +@var{type} $B$O(B representation-type $B$G$9!#(B(cf. @ref{mm-backend}) @refill -@var{location} is location of entity. Specification of it is depended -on representation-type. +@var{location} $B$O(B entity $B$N0LCV$G$9!#;XDjJ}K!$O(B +representation-type $B$K0M$C$FJQ$o$j$^$9!#(B @end defun @@ -110,7 +112,7 @@ on representation-type. -@node Entity hierarchy, Entity Attributes, Entity creation, Entity +@node Entity hierarchy, Entity Search, Entity creation, Entity @section Entity $B3,AX(B @cindex node-id @cindex entity-number @@ -201,26 +203,39 @@ local $BJQ?t!#(B @end defun + +@node Entity Search, Entity Attributes, Entity hierarchy, Entity +@section Entity $B$N8!:w(B + @defun mime-find-entity-from-number entity-number &optional message -Return entity from @var{entity-number} in @var{message}.@refill +@var{message} $B$+$i!"(B@var{enity-number} $B$N(B entity $B$rJV$7$^$9!#(B@refill -If @var{message} is not specified, @code{mime-message-structure} is -used. +@var{message} $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +@code{mime-message-structrue} $B$,;H$o$l$^$9!#(B @end defun @defun mime-find-entity-from-node-id entity-node-id &optional message -Return entity from @var{entity-node-id} in @var{message}.@refill +@var{message} $B$+$i!"(B@var{entity-node-id} $B$N(B entity $B$rJV$7$^$9!#(B@refill + +@var{message} $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +@code{mime-message-structure} $B$,;H$o$l$^$9!#(B +@end defun + + +@defun mime-find-entity-from-content-id cid &optional message -If @var{message} is not specified, @code{mime-message-structure} is -used. +@var{message} $B$+$i!"(B@var{cid} $B$N(B entity $B$rJV$7$^$9!#(B@refill + +@var{message} $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +@code{mime-message-structure} $B$,;H$o$l$^$9!#(B @end defun -@node Entity Attributes, Entity-header, Entity hierarchy, Entity +@node Entity Attributes, Entity-header, Entity Search, Entity @section Entity $B$NB0@-(B @defun mime-entity-content-type entity @@ -255,8 +270,8 @@ used. @defun mime-entity-cooked-p entity -Return non-nil if contents of @var{entity} has been already -code-converted. +@var{entity} $B$NFbMF$,4{$K%3!<%IJQ49$5$l$F$$$k>l9g$O(B nil $B$GL5$$CM(B +$B$rJV$9!#(B @end defun @@ -317,11 +332,11 @@ encoded-word (@ref{encoded-word}) $B$OI|9f$5$l$k!#!X@8$NHs(B us-ascii $BJ8;z! @defun mime-insert-text-content entity -Insert before point a contents of @var{entity} as text entity.@refill +point $B$NA0$K(B @var{entity} $B$r(B text entity $B$H$7$FA^F~$7$^$9!#(B@refill -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. +@var{entity} $B$NFbMF$O(B @ref{MIME charset} $B$H$7$FI|9f2=$5$l(B +$B$^$9!#(B@var{entity} $B$N(B Content-Type field $B$K(B charset paramter $B$,L5(B +$B$$$H!"(B@code{default-mime-charset} $B$,=i4|CM$H$7$F;H$o$l$^$9!#(B @end defun @@ -335,7 +350,7 @@ value. -@node Entity-content, Entity buffer, entity formatting, Entity +@node Entity-content, Entity-network-representation, entity formatting, Entity @section Entity $B$NFbMF(B @defun mime-entity-content entity @@ -344,26 +359,42 @@ value. @end defun +@defun mime-insert-entity-content entity + +point $B$N0LCV$K(B @var{entity} $B$NFbMF$rA^F~$7$^$9!#(B +@end defun + + @defun mime-write-entity-content entity filename -Write content of @var{entity} into @var{filename}. +@var{entity} $B$NFbMF$r(B @var{filename} $B$K=q$-9~$_$^$9!#(B +@end defun + + + +@node Entity-network-representation, Entity buffer, Entity-content, Entity +@section Entity $B$N%M%C%H%o!<%/I=8=(B + +@defun mime-insert-entity entity + +@var{entity} $B$N(B header $B$H(B body $B$r(B point $B$N$H$3$m$KA^F~$7$^$9!#(B @end defun @defun mime-write-entity entity filename -Write representation of @var{entity} into @var{filename}. +@var{entity} $B$NI=8=$r(B @var{filename} $B$K=q$-9~$_$^$9!#(B @end defun @defun mime-write-entity-body entity filename -Write body of @var{entity} into @var{filename}. +@var{entity} $B$N(B body $B$r(B @var{filename} $B$K=q$-9~$_$^$9!#(B @end defun -@node Entity buffer, mm-backend, Entity-content, Entity +@node Entity buffer, mm-backend, Entity-network-representation, Entity @section Entity $B$N(B buffer $B$K$h$kI=8=(B @defun mime-entity-buffer entity @@ -464,12 +495,13 @@ representation-type $B$NL>A0$N@hF,$K(B @code{mm} $B$rIU$1$?$b$N$K$J$C$F(B @defmac mm-define-backend type &optional parents -Define @var{type} as a mm-backend.@refill +@var{type} $B$r(B mm-backend $B$H$7$FDj5A$7$^$9!#(B@refill -If @var{PARENTS} is specified, @var{type} inherits parents. Each parent -must be representation-type.@refill +@var{PARENTS} $B$,;XDj$5$l$F$$$k>l9g$O!"(B@var{type} $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:@refill +$BNc(B:@refill @lisp (mm-define-backend chao (generic)) @@ -479,15 +511,15 @@ Example:@refill @defmac mm-define-method name args &rest body -Define @var{name} as a method function of (nth 1 (car @var{args})) -backend.@refill +@var{name} $B$r(B (nth 1 (car @var{args})) backend $B$N(B method $B4X(B +$B?t$H$7$FDj5A$7$^$9!#(B@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 +@var{args} $B$O(B lambda $B$N0z?t%j%9%H$N$h$&$J$b$N$G$9$,!"(B(car +@var{args}) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car @var{args})) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car @var{args})) +$B$O(B backend $B$NL>A0(B (representation-type) $B$G$9!#(B@refill -Example:@refill +$BNc(B:@refill @lisp (mm-define-method entity-cooked-p ((entity chao)) nil) @@ -781,15 +813,15 @@ Content-Transfer-Encoding $BMs$,B8:_$7$J$$>l9g$O(B@var{default-encoding} $B$r @defun mime-encode-region start end encoding -Encode region @var{start} to @var{end} of current buffer using -@var{encoding}. +$B8=:_$N(B buffer $B$N(B @var{start} $B$+$i(B @var{end} $B$^$G$N(B region $B$r(B +@var{encoding} $B$r;H$C$FId9f2=$7$^$9!#(B @end defun @defun mime-decode-region start end encoding -Decode region @var{start} to @var{end} of current buffer using -@var{encoding}. +$B8=:_$N(B buffer $B$N(B @var{start} $B$+$i(B @var{end} $B$^$G$N(B region $B$r(B +@var{encoding} $B$r;H$C$FI|9f2=$7$^$9!#(B @end defun @@ -803,16 +835,17 @@ Decode region @var{start} to @var{end} of current buffer using @defun mime-insert-encoded-file filename encoding -Insert file @var{FILENAME} encoded by @var{ENCODING} format. +@var{ENCODING} format $B$GId9f2=$5$l$?(B file @var{FILENAME} $B$r(B +$BA^F~$9$k!#(B @end defun @defun mime-write-decoded-region start end filename encoding -Decode and write current region encoded by @var{encoding} into -@var{filename}.@refill +@var{encoding} $B$GId9f2=$5$l$?8=:_$N(B region $B$rI|9f2=$7$F(B +@var{filename}$B$K=q$-9~$_$^$9!#(B -@var{start} and @var{end} are buffer positions. +start $B$H(B @var{end} $B$O(B buffer $B$N0LCV$G$9!#(B @end defun @@ -822,19 +855,19 @@ Decode and write current region encoded by @var{encoding} into @defun mime-encoding-list &optional SERVICE -Return list of Content-Transfer-Encoding.@refill +Content-Transfer-Encoding $B$N(B list $B$rJV$7$^$9!#(B@refill -If @var{service} is specified, it returns available list of -Content-Transfer-Encoding for it. +@var{service} $B$,;XDj$5$l$F$$$k$H!"$=$l$KBP$9$k(B +Content-Transfer-Encoding $B$rJV$7$^$9!#(B @end defun @defun mime-encoding-alist &optional SERVICE -Return table of Content-Transfer-Encoding for completion.@refill +$BJd40$N$?$a$N(B Content-Transfer-Encoding $B$NI=$rJV$7$^$9!#(B@refill -If @var{service} is specified, it returns available list of -Content-Transfer-Encoding for it. +@var{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 @end defun @@ -844,15 +877,15 @@ Content-Transfer-Encoding for it. @defmac mel-define-method name args &rest body -Define @var{name} as a method function of (nth 1 (car (last -@var{args}))) backend.@refill +@var{name} $B$r(B (nth 1 (car (last @var{args}))) backend $B$N(B +method $B4X?t$H$7$FDj5A$7$^$9!#(B -@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 +@var{args} $B$O(B lambda $B$N0z?t(B list $B$H;w$F$$$^$9$,!"(B(car (last +@var{args})) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car (last @var{args}))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last +@var{args}))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B@refill -Example:@refill +$BNc(B:@refill @lisp (mel-define-method mime-write-decoded-region (start end filename @@ -873,16 +906,16 @@ START and END are buffer positions." @defmac mel-define-method-function spec function -Set @var{spec}'s function definition to @var{function}.@refill +@var{spec} $B$N4X?tDj5A$r(B @var{function} $B$K@_Dj$7$^$9!#(B@refill -First element of @var{spec} is service.@refill +@var{spec} $B$N:G=i$NMWAG$O(B service $B$G$9!#(B@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 +@var{args} $B$N;D$j$O(B lambda $B$N0z?t(B list $B;w$F$$$^$9$,!"(B(car (last +@var{args})) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car (last @var{args}))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last +@var{args}))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B@refill -Example:@refill +$BNc(B:@refill @lisp (mel-define-method-function (mime-encode-string string (nil "base64")) @@ -893,16 +926,17 @@ Example:@refill @node generic function for mel-backend, , mel-backend, Content-Transfer-Encoding -@section How to add encoding/decoding service +@section $BId9f2=(B/$BI|9f2=(B service $B$rDI2C$9$kJ}K!(B @defmac mel-define-service name &optional args doc-string -Define @var{name} as a service for Content-Transfer-Encodings.@refill +@var{name} $B$r(B Content-Transfer-Encoding $B$N(B service $B$H$7$FDj5A$7$^(B +$B$9!#(B@refill -If @var{args} is specified, @var{name} is defined as a generic function -for the service.@refill +@var{args} $B$,;XDj$5$l$F$$$k$H!"(B@var{name} $B$O(B service $B$N(B +generic function $B$H$7$FDj5A$5$l$^$9!#(B@refill -Example:@refill +$BNc(B:@refill @lisp (mel-define-service encoded-text-encode-string (string encoding) @@ -963,11 +997,29 @@ Header $BCf$N(B encoded-word $B$rI|9f$9$k!#(B@refill Header $B$r(B network $BI=8=$KId9f2=$9$k!#(B@refill -$B3F(B field $B$O(B @code{eword-field-encoding-method-alist} $B$G;XDj$5$l$?J}<0$G(B +$B3F(B field $B$O(B @code{mime-field-encoding-method-alist} $B$G;XDj$5$l$?J}<0$G(B $BId9f2=$5$l$k!#(B @end defun +@defvar mime-field-encoding-method-alist + +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@refill + +METHOD $B$,(B @code{mime} $B$G$"$l$P!"(BFIELD $B$O(B MIME format $B$KId9f2=$5(B +$B$l$k(B (encoded-word)$B!#(B + +METHOD $B$,(B @code{nil} $B$G$"$l$P!"(BFIELD $B$OId9f2=$5$l$J$$!#(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@refill + +$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 @code{default-mime-charset} $B$GId9f2=$5$l$k(B +@end defvar + + @node custom, Appendix, encoded-word, Top @chapter $B0lHL@_Dj(B @@ -980,18 +1032,6 @@ MIME $B4XO"5!G=$K4X$9$k(B group.@refill @end deffn -@defvar mime-temp-directory - -MIME $B5!G=$K4X$9$kl9g!"$=$l$r=i4|CM$H$7$F(B -$BMQ$$$k!#2?$b@_Dj$5$l$F$$$J$$>l9g!"(B@code{"/tmp/"} $B$rMQ$$$k!#(B -@end defvar - - - @node Appendix, Concept Index, custom, Top @chapter $BIUO?(B @@ -1432,7 +1472,7 @@ Standards Track (obsolete RFC 1521, 1522, 1590). ASCII (@ref{ASCII}) $B$N$_$+$i$J$j(B ISO 2022 $B$K$h$kId9f3HD%$O5v$5$l$J$$!#(B -Internet message $B$K$*$1$kI8=`$NId9f2=J8;z=89g(B(@ref{Coded character set}) +Internet message $B$K$*$1$kI8=`$NId9f2=J8;z=89g(B(@ref{Coded character set}) $B$G$"$j!"L@<(E*$K(B MIME charset $B$,<($5$l$J$$>l9g$O86B'$H$7$F(B @strong{us-ascii} $B$,;H$o$l$k!#(B@refill @@ -1446,9 +1486,9 @@ FLIM $B$N%P%0$r8+$D$1$?$i!"0J2<$N(B address $B$K(B mail $B$rAw$C$F$/$@$5$$! @itemize @bullet @item - $BF|K\8l(B + $B1Q8l(B @item - $B1Q8l(B + $BF|K\8l(B @end itemize @@ -1466,14 +1506,14 @@ FLIM $B$N%P%0$r8+$D$1$?$i!"0J2<$N(B address $B$K(B mail $B$rAw$C$F$/$@$5$$! $B$r2?DL$b=q$/1)L\$K$J$j$^$9!#$@$+$i!"I,$:(B bug $BJs9p$O>e5-$N(B address $B$KAw$C(B $B$F$/$@$5$$!#(B -tm ML $B$G$O(B FLIM $B$N%P%0>pJs$N8r49$d:G?7HG$NG[I[!"(BFLIM $B$N2~NI$K4X$9$k5D(B -$BO@$r9T$J$C$F$$$^$9!#(Btm ML $B$K;22C$7$?$$J}$O(B +EMACS-MIME ML $B$G$O(B FLIM $B$N%P%0>pJs$N8r49$d:G?7HG$NG[I[!"(BFLIM $B$N2~NI$K(B +$B4X$9$k5DO@$r9T$J$C$F$$$^$9!#(BEMACS-MIME ML $B$K;22C$7$?$$J}$O(B @itemize @bullet @item - $BF|K\8l(B + $B1Q8l(B @item - $B1Q8l(B + $BF|K\8l(B @end itemize @noindent @@ -1489,14 +1529,13 @@ FLIM $B$N(B file $B$O(B CVS $B$r;H$C$F4IM}$5$l$F$$$^$9!#$3$N$?$a!"0J2<$NJ}K @example (0) cvs login - % cvs -d :pserver:anonymous@@chamonix.jaist.ac.jp:/hare/cvs/root \ - login + % cvs -d :pserver:anonymous@@cvs.m17n.org:/cvs/root login CVS password: [CR] # NULL string (1) checkout - % cvs -d :pserver:anonymous@@chamonix.jaist.ac.jp:/hare/cvs/root \ + % cvs -d :pserver:anonymous@@cvs.m17n.org:/cvs/root checkout checkout [-r TAG] flim @end example @@ -1505,18 +1544,18 @@ CVS $B$rMQ$$$?3+H/$K;22C$7$?$$J}$O(B @itemize @bullet @item - + @end itemize @noindent -$B$^$G!"(Baccount $BL>$H(B UNIX $B$N(B passwd $B$HF1$87A<0$N(B crypt $B2=$5$l$?(B password -$B$r1h$($F8fO"Mm$/$@$5$$!#(B +$B$^$G!"%"%+%&%s%HL>$H(B ssh $B$N8x3+80$rAw$C$F$/$@$5$$!#(Bssh $B7PM3$G$O!"(B +cvsroot $B$O(B :ext:cvs@@cvs.m17n.org:/cvs/root $B$H$J$j$^$9!#(B @node History, , CVS, Appendix @section $BNr;K(B -FLIM $B$N(B code $B$N:G8E$NItJ,$O(B $B1]JB(B $B;LCR(B $B;a$,=q$$$?(B @file{mime.el}$B$K5/8;$7(B +FLIM $B$N(B code $B$N:G8E$NItJ,$O(B $B1]JB(B $B;LCR(B $B;a$,=q$$$?(B @file{mime.el} $B$K5/8;$7(B $B$^$9!#$3$N>.$5$J(B program $B$O(B Nemacs $B$GF0:n$9$k(B iso-2022-jp $B$N(B B-encoding $B@lMQ$N(B encoded-word $B$NI|9f2=%W%m%0%i%`$G$7$?!#(B@refill @@ -1560,7 +1599,7 @@ tm $B$G$O8e$K!"A0$,(B FLIM$B$H$J$j$^$9!#(B@refill +package $B$NL>A0$,(B FLIM $B$H$J$j$^$9!#(B@refill $B$3$ND>A0$+$iEDCf(B $BE/(B $B;a$,$h$j(B RFC $B$KCi