X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.sgml;h=e4bc50bcb8e3ba8da76959bedd39d015667c6b5e;hb=bf551960c4b1650c6473e9bbc849110af4a35b67;hp=8ef8a2bf51f262a6daf21028b945e30db9891823;hpb=a5602f76cd2cda59bd15e32ad9b34802f30f4e78;p=elisp%2Fflim.git diff --git a/mime-ja.sgml b/mime-ja.sgml index 8ef8a2b..e4bc50b 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.12 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> +<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> -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> @@ -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,78 +725,79 @@ 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> <defun name="mime-decode-string"> - <args> string encoding + <args> string encoding <p> -<var>string</var> $B$r(B <var>encoding</var> $B$H$7$FI|9f$7$?7k2L$rJV$7$^$9!#(B +<var>string</var> $B$r(B <var>encoding</var> $B$H$7$FI|9f$7$?7k2L$rJV$9!#(B </defun> <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) @@ -850,25 +882,45 @@ FLIM $B$O$3$l$i$rId9f2=!&I|9f2=$9$k5!G=$rDs6!$7$^$9!#(B <defun name="eword-decode-header"> <opts> code-conversion separator <p> -Decode MIME encoded-words in header fields. +Header $BCf$N(B encoded-word $B$rI|9f$9$k!#(B <p> -If <var>code-conversion</var> is <code>nil</code>, 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 <var>code-conversion</var> $B$,(B <code>nil</code> $B$J$i!"(Bencoded-word +$B$@$1$,I|9f$5$l$k!#$b$7!"(B<var>code-conversion</var> $B$,(B <dref>MIME +charset</dref> $B$J$i!"Hs(B ASCII bit patterns $B$O$=$N(B MIME charset $B$H$7$F(B +$BI|9f$5$l$k!#$3$l0J30$N>l9g!"Hs(B ASCII bit patterns $B$O(B +<code>default-mime-charset</code>. $B$H$7$FI|9f$5$l$k!#(B<cf node="entity +formatting"> <p> -If <var>separator</var> is not nil, it is used as header separator. +$B$b$7(B <var>separator</var> $B$,(B <code>nil</code> $B$G$J$1$l$P!"$=$NCM$,(B +header separator $B$H$7$FMQ$$$i$l$k!#(B </defun> <defun name="eword-encode-header"> - <opts> code-conversion + <opts> code-conversion <p> -Encode header fields to network representation, such as MIME -encoded-word. +Header $B$r(B network $BI=8=$KId9f2=$9$k!#(B <p> -It refer variable <code>eword-field-encoding-method-alist</code>. +$B3F(B field $B$O(B <code>eword-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"> +<p> +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> +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> +METHOD $B$,(B <code>nil</code> $B$G$"$l$P!"(BFIELD $B$OId9f2=$5$l$J$$!#(B +<p> +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> +$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> + <h1> $B0lHL@_Dj(B <node> custom @@ -1240,8 +1292,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> @@ -1260,12 +1312,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> @@ -1281,14 +1333,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> @@ -1296,12 +1347,16 @@ 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 +<p> +$B$I$&$7$F$b(B ssh $B$,;H$($J$$>l9g!"(Bpserver $B7PM3$G$b3+H/$K;22C$G$-$^$9!#(B +$B$3$N>l9g!"(BUNIX $B$N(B /etc/passwd $BMM<0$G0E9f2=$5$l$?%Q%9%o!<%I$rAw$C$F2<$5$$!#(B +$B$3$N>l9g(B cvsroot $B$O(B :pserver:<$B%"%+%&%s%HL>(B>@cvs.m17n.org:/cvs/root $B$H$J$j$^$9!#(B <h2> $BNr;K(B