X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=2067e17c673d3e0d4371c99295ba7e2d19b84893;hb=e4b54bf12373b9bc4b233280a401571d4ae97085;hp=fe6794bd7d61c7c0975d71688cec8de53ffc0235;hpb=bf8bd9c057200e7b1fdaa23a63836bd727875da8;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index fe6794b..2067e17 100644 --- a/mime-ja.sgml +++ b/mime-ja.sgml @@ -1,8 +1,8 @@ -FLIM 1.10 MIME $B5!G=@bL@=q(B +<title>FLIM 1.14 MIME $B5!G=@bL@=q(B <author>$B<i2,(B $BCNI'(B <mail>morioka@jaist.ac.jp</mail> -<date>1998/07/01 +<date>1999-01-27 <toc> </head> @@ -11,11 +11,11 @@ <abstract> <p> -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. <p> -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 </abstract> @@ -60,12 +60,12 @@ FLIM $B$O(B entity $B$N>pJs$rI=8=$9$k$?$a$K(B<concept>mime-entity</concept> <defun name="mime-open-entity"> <opts> type location <p> -Open an entity and return it. +Entity $B$r3+$$$F!"$=$l$rJV$7$^$9!#(B <p> -<var>type</var> is representation-type. <cf node="mm-backend"> +<var>type</var> $B$O(B representation-type $B$G$9!#(B <cf node="mm-backend"> <p> -<var>location</var> is location of entity. Specification of it is -depended on representation-type. +<var>location</var> $B$O(B entity $B$N0LCV$G$9!#;XDjJ}K!$O(B +representation-type $B$K0M$C$FJQ$o$j$^$9!#(B </defun> <defun name="mime-parse-buffer"> @@ -169,22 +169,36 @@ buffer local $BJQ?t!#(B <var>entity</var> $B$N(B entity-number $B$rJV$9!#(B </defun> + +<h2> Entity $B$N8!:w(B +<node> Entity Search +<p> <defun name="mime-find-entity-from-number"> <args> entity-number <opts> message <p> -Return entity from <var>entity-number</var> in <var>message</var>. +<var>message</var> $B$+$i!"(B<var>enity-number</var> $B$N(B entity $B$rJV$7$^$9!#(B <p> -If <var>message</var> is not specified, -<code>mime-message-structure</code> is used. +<var>message</var> $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +<code>mime-message-structrue</code> $B$,;H$o$l$^$9!#(B </defun> <defun name="mime-find-entity-from-node-id"> <args> entity-node-id <opts> message <p> -Return entity from <var>entity-node-id</var> in <var>message</var>. +<var>message</var> $B$+$i!"(B<var>entity-node-id</var> $B$N(B entity $B$rJV$7$^(B +$B$9!#(B <p> -If <var>message</var> is not specified, -<code>mime-message-structure</code> is used. +<var>message</var> $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +<code>mime-message-structure</code> $B$,;H$o$l$^$9!#(B +</defun> + +<defun name="mime-find-entity-from-content-id"> + <args> cid <opts> message +<p> +<var>message</var> $B$+$i!"(B<var>cid</var> $B$N(B entity $B$rJV$7$^$9!#(B +<p> +<var>message</var> $B$,;XDj$5$l$F$$$J$$>l9g$O!"(B +<code>mime-message-structure</code> $B$,;H$o$l$^$9!#(B </defun> @@ -225,8 +239,8 @@ node="Content-Transfer-Encoding"> <defun name="mime-entity-cooked-p"> <args> entity <p> -Return non-nil if contents of <var>entity</var> has been already -code-converted. +<var>entity</var> $B$NFbMF$,4{$K%3!<%IJQ49$5$l$F$$$k>l9g$O(B nil $B$GL5$$CM(B +$B$rJV$9!#(B </defun> @@ -287,12 +301,11 @@ list $B$G!"$=$l$>$l!"I=<($7$?$/$J$$(B field $BL>$HI=<($7$?$$MsL>$rI=8=$7$?$b$ <defun name="mime-insert-text-content"> <args> entity <p> -Insert before point a contents of <var>entity</var> as text entity. +point $B$NA0$K(B <var>entity</var> $B$r(B text entity $B$H$7$FA^F~$7$^$9!#(B <p> -Contents of the <var>entity</var> are decoded as <dref>MIME -charset</dref>. If the <var>entity</var> does not have charset -parameter of Content-Type field, <code>default-mime-charset</code> is -used as default value. +<var>entity</var> $B$NFbMF$O(B <dref>MIME charset</dref> $B$H$7$FI|9f2=$5$l(B +$B$^$9!#(B<var>entity</var> $B$N(B Content-Type field $B$K(B charset paramter $B$,L5(B +$B$$$H!"(B<code>default-mime-charset</code> $B$,=i4|CM$H$7$F;H$o$l$^$9!#(B </defun> <defvar name="default-mime-charset"> @@ -313,22 +326,38 @@ MIME charset. <var>entity</var> $B$NFbMF$N(B byte $BNs$rJV$9!#(B </defun> +<defun name="mime-insert-entity-content"> + <args> entity +<p> +point $B$N0LCV$K(B <var>entity</var> $B$NFbMF$rA^F~$7$^$9!#(B +</defun> + <defun name="mime-write-entity-content"> <args> entity filename <p> -Write content of <var>entity</var> into <var>filename</var>. +<var>entity</var> $B$NFbMF$r(B <var>filename</var> $B$K=q$-9~$_$^$9!#(B +</defun> + + +<h2> Entity $B$N%M%C%H%o!<%/I=8=(B +<node> Entity-network-representation +<p> +<defun name="mime-insert-entity"> + <args> entity +<p> +<var>entity</var> $B$N(B header $B$H(B body $B$r(B point $B$N$H$3$m$KA^F~$7$^$9!#(B </defun> <defun name="mime-write-entity"> <args> entity filename <p> -Write representation of <var>entity</var> into <var>filename</var>. +<var>entity</var> $B$NI=8=$r(B <var>filename</var> $B$K=q$-9~$_$^$9!#(B </defun> <defun name="mime-write-entity-body"> <args> entity filename <p> -Write body of <var>entity</var> into <var>filename</var>. +<var>entity</var> $B$N(B body $B$r(B <var>filename</var> $B$K=q$-9~$_$^$9!#(B </defun> @@ -427,12 +456,13 @@ representation-type $B$NL>A0$N@hF,$K(B <code>mm</code> $B$rIU$1$?$b$N$K$J$C$F <args> type <opts> parents <p> -Define <var>type</var> as a mm-backend. +<var>type</var> $B$r(B mm-backend $B$H$7$FDj5A$7$^$9!#(B <p> -If <var>PARENTS</var> is specified, <var>type</var> inherits parents. -Each parent must be representation-type. +<var>PARENTS</var> $B$,;XDj$5$l$F$$$k>l9g$O!"(B<var>type</var> $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 <p> -Example: +$BNc(B: <p> <lisp> (mm-define-backend chao (generic)) @@ -442,15 +472,15 @@ Example: <defmacro name="mm-define-method"> <args> name args <rest> body <p> -Define <var>name</var> as a method function of (nth 1 (car -<var>args</var>)) backend. +<var>name</var> $B$r(B (nth 1 (car <var>args</var>)) backend $B$N(B method $B4X(B +$B?t$H$7$FDj5A$7$^$9!#(B <p> -<var>args</var> is like an argument list of lambda, but (car -<var>args</var>) must be specialized parameter. (car (car -<var>args</var>)) is name of variable and (nth 1 (car -<var>args</var>)) is name of backend (representation-type). +<var>args</var> $B$O(B lambda $B$N0z?t%j%9%H$N$h$&$J$b$N$G$9$,!"(B(car +<var>args</var>) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car <var>args</var>)) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car <var>args</var>)) +$B$O(B backend $B$NL>A0(B (representation-type) $B$G$9!#(B <p> -Example: +$BNc(B: <p> <lisp> (mm-define-method entity-cooked-p ((entity chao)) nil) @@ -695,15 +725,15 @@ Content-Transfer-Encoding $BMs$,B8:_$7$J$$>l9g$O(B <defun name="mime-encode-region"> <args> start end encoding <p> -Encode region <var>start</var> to <var>end</var> of current buffer -using <var>encoding</var>. +$B8=:_$N(B buffer $B$N(B <var>start</var> $B$+$i(B <var>end</var> $B$^$G$N(B region $B$r(B +<var>encoding</var> $B$r;H$C$FId9f2=$7$^$9!#(B </defun> <defun name="mime-decode-region"> <args> start end encoding <p> -Decode region <var>start</var> to <var>end</var> of current buffer -using <var>encoding</var>. +$B8=:_$N(B buffer $B$N(B <var>start</var> $B$+$i(B <var>end</var> $B$^$G$N(B region $B$r(B +<var>encoding</var> $B$r;H$C$FI|9f2=$7$^$9!#(B </defun> @@ -717,56 +747,57 @@ using <var>encoding</var>. <defun name="mime-insert-encoded-file"> <args> filename encoding <p> -Insert file <var>FILENAME</var> encoded by <var>ENCODING</var> format. +<var>ENCODING</var> format $B$GId9f2=$5$l$?(B file <var>FILENAME</var> $B$r(B +$BA^F~$9$k!#(B </defun> <defun name="mime-write-decoded-region"> <args> start end filename encoding <p> -Decode and write current region encoded by <var>encoding</var> into -<var>filename</var>. +<var>encoding</var> $B$GId9f2=$5$l$?8=:_$N(B region $B$rI|9f2=$7$F(B +<var>filename</var>$B$K=q$-9~$_$^$9!#(B <p> -<var>start</var> and <var>end</var> are buffer positions. +<var>start<var> $B$H(B <var>end</var> $B$O(B buffer $B$N0LCV$G$9!#(B </defun> -<h2> Other utilities +<h2> $BB>$N(B utility <node> Encoding information <p> <defun name="mime-encoding-list"> <opts> SERVICE <p> -Return list of Content-Transfer-Encoding. +Content-Transfer-Encoding $B$N(B list $B$rJV$7$^$9!#(B <p> -If <var>service</var> is specified, it returns available list of -Content-Transfer-Encoding for it. +<var>service</var> $B$,;XDj$5$l$F$$$k$H!"$=$l$KBP$9$k(B +Content-Transfer-Encoding $B$rJV$7$^$9!#(B </defun> <defun name="mime-encoding-alist"> <opts> SERVICE <p> -Return table of Content-Transfer-Encoding for completion. +$BJd40$N$?$a$N(B Content-Transfer-Encoding $B$NI=$rJV$7$^$9!#(B <p> -If <var>service</var> is specified, it returns available list of -Content-Transfer-Encoding for it. +<var>service</var> $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 </defun> -<h2> How to write encoder/decoder module +<h2> $BId9f2=(B/$BI|9f2=(B module $B$N=q$-J}(B <node> mel-backend <p> <defmacro name="mel-define-method"> <args> name args <rest> body <p> -Define <var>name</var> as a method function of (nth 1 (car (last -<var>args</var>))) backend. +<var>name</var> $B$r(B (nth 1 (car (last <var>args</var>))) backend $B$N(B +method $B4X?t$H$7$FDj5A$7$^$9!#(B <p> -<var>args</var> is like an argument list of lambda, but (car (last -<var>args</var>)) must be specialized parameter. (car (car (last -<var>args</var>))) is name of variable and (nth 1 (car (last -<var>args</var>))) is name of backend (encoding). +<var>args</var> $B$O(B lambda $B$N0z?t(B list $B$H;w$F$$$^$9$,!"(B(car (last +<var>args</var>)) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car (last <var>args</var>))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last +<var>args</var>))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B <p> -Example: +$BNc(B: <p> <lisp> (mel-define-method mime-write-decoded-region (start end filename @@ -787,16 +818,16 @@ START and END are buffer positions." <defmacro name="mel-define-method-function"> <args> spec function <p> -Set <var>spec</var>'s function definition to <var>function</var>. +<var>spec</var> $B$N4X?tDj5A$r(B <var>function</var> $B$K@_Dj$7$^$9!#(B <p> -First element of <var>spec</var> is service. +<var>spec</var> $B$N:G=i$NMWAG$O(B service $B$G$9!#(B <p> -Rest of <var>args</var> is like an argument list of lambda, but (car -(last <var>args</var>)) must be specialized parameter. (car (car -(last <var>args</var>))) is name of variable and (nth 1 (car (last -<var>args</var>))) is name of backend (encoding). +<var>args</var> $B$N;D$j$O(B lambda $B$N0z?t(B list $B;w$F$$$^$9$,!"(B(car (last +<var>args</var>)) $B$O;XDj$5$l$?(B parameter $B$G$"$kI,MW$,$"$j$^$9!#(B(car +(car (last <var>args</var>))) $B$OJQ?t$NL>A0$G!"(B(nth 1 (car (last +<var>args</var>))) $B$O(B backend $B$NL>A0(B (encoding) $B$G$9!#(B <p> -Example: +$BNc(B: <p> <lisp> (mel-define-method-function (mime-encode-string string (nil "base64")) @@ -805,19 +836,20 @@ Example: </defmacro> -<h2> How to add encoding/decoding service +<h2> $BId9f2=(B/$BI|9f2=(B service $B$rDI2C$9$kJ}K!(B <node> generic function for mel-backend <p> <defmacro name="mel-define-service"> <args> name <opts> args doc-string <p> -Define <var>name</var> as a service for Content-Transfer-Encodings. +<var>name</var> $B$r(B Content-Transfer-Encoding $B$N(B service $B$H$7$FDj5A$7$^(B +$B$9!#(B <p> -If <var>args</var> is specified, <var>name</var> is defined as a -generic function for the service. +<var>args</var> $B$,;XDj$5$l$F$$$k$H!"(B<var>name</var> $B$O(B service $B$N(B +generic function $B$H$7$FDj5A$5$l$^$9!#(B <p> -Example: +$BNc(B: <p> <lisp> (mel-define-service encoded-text-encode-string (string encoding) @@ -868,26 +900,25 @@ header separator $B$H$7$FMQ$$$i$l$k!#(B <p> Header $B$r(B network $BI=8=$KId9f2=$9$k!#(B <p> -$B3F(B field $B$O(B <code>eword-field-encoding-method-alist</code> $B$G;XDj$5$l(B +$B3F(B field $B$O(B <code>mime-field-encoding-method-alist</code> $B$G;XDj$5$l(B $B$?J}<0$GId9f2=$5$l$k!#(B </defun> -<defvar name="eword-field-encoding-method-alist"> +<defvar name="mime-field-encoding-method-alist"> <p> -Association list to specify field encoding method. Each element looks -like (FIELD . METHOD). +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 <p> -If METHOD is <code>mime</code>, the FIELD will be encoded into MIME -format (encoded-word). +METHOD $B$,(B <code>mime</code> $B$G$"$l$P!"(BFIELD $B$O(B MIME format $B$KId9f2=$5(B +$B$l$k(B (encoded-word)$B!#(B <p> -If METHOD is <code>nil</code>, the FIELD will not be encoded. +METHOD $B$,(B <code>nil</code> $B$G$"$l$P!"(BFIELD $B$OId9f2=$5$l$J$$!#(B <p> -If METHOD is a MIME charset, the FIELD will be encoded as the charset -when it must be convert into network-code. +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 <p> -Otherwise the FIELD will be encoded as variable -<code>default-mime-charset</code> when it must be convert into -network-code. +$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</code> $B$GId9f2=$5$l$k(B </defvar> @@ -901,16 +932,6 @@ MIME $B4XO"5!G=$K4X$9$k(B group. <code>mail</code> $B$H(B <code>news</code> $B$KB0$9$k!#(B </define> -<defvar name="mime-temp-directory"> -<p> -MIME $B5!G=$K4X$9$k<BAu$,0l;~E*$K;HMQ$9$k(B file $B$r:n@.$9$k(B directory. -<p> -$B4D6-JQ?t(B <code>MIME_TMP_DIR</code>, <code>TM_TMP_DIR</code>, -<code>TMPDIR</code>, <code>TMP</code> $B$b$7$/$O(B <code>TEMP</code> $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 -<code>"/tmp/"</code> $B$rMQ$$$k!#(B -</defvar> - <h1> $BIUO?(B <node> Appendix @@ -1261,8 +1282,8 @@ Internet message $B$K$*$1$kI8=`$N(B<a node="Coded character set">$BId9f2=J8( FLIM $B$N%P%0$r8+$D$1$?$i!"0J2<$N(B address $B$K(B mail $B$rAw$C$F$/$@$5$$!'(B <ul> -<li> $BF|K\8l(B <mail>bug-tm-ja@chamonix.jaist.ac.jp</mail> -<li> $B1Q8l(B <mail>bug-tm-en@chamonix.jaist.ac.jp</mail> +<li> $B1Q8l(B <mail>emacs-mime-en@m17n.org</mail> +<li> $BF|K\8l(B <mail>emacs-mime-ja@m17n.org</mail> </ul> <p> @@ -1281,12 +1302,12 @@ file="emacs" node="Bugs"> $B$F$/$@$5$$!#(B <p> -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 <ul> -<li> $BF|K\8l(B <mail>tm-ja-help@chamonix.jaist.ac.jp</mail> -<li> $B1Q8l(B <mail>tm-en-help@chamonix.jaist.ac.jp</mail> +<li> $B1Q8l(B <mail>emacs-mime-en-ctl@m17n.org</mail> +<li> $BF|K\8l(B <mail>emacs-mime-ja-ctl@m17n.org</mail> </ul> <noindent> @@ -1302,14 +1323,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 <verb> (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 [-r TAG] flim </verb> @@ -1317,12 +1337,12 @@ FLIM $B$N(B file $B$O(B CVS $B$r;H$C$F4IM}$5$l$F$$$^$9!#$3$N$?$a!"0J2<$NJ}K CVS $B$rMQ$$$?3+H/$K;22C$7$?$$J}$O(B <ul> -<li> <mail>cvs@chamonix.jaist.ac.jp</mail> +<li> <mail>cvs@cvs.m17n.org</mail> </ul> <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 <h2> $BNr;K(B