X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mime-ja.texi;h=8a3c58d1fe6817888cdc60c66817e3b450fbaab6;hb=88860955220920e6da966aea41a619d812fad0fc;hp=067619bd0c936aef521990fb5b3bd9fb5246c672;hpb=199e8ce229167096dc437b8476d1d76d1cd38c93;p=elisp%2Fflim.git

diff --git a/mime-ja.texi b/mime-ja.texi
index 067619b..8a3c58d 100644
--- a/mime-ja.texi
+++ b/mime-ja.texi
@@ -1,13 +1,13 @@
 \input texinfo.tex
 @setfilename mime-ja.info
-@settitle{FLIM 1.6 MIME $B5!G=@bL@=q(B}
+@settitle{FLIM 1.8 MIME $B5!G=@bL@=q(B}
 @titlepage
-@title FLIM 1.6 MIME $B5!G=@bL@=q(B
+@title FLIM 1.8 MIME $B5!G=@bL@=q(B
 @author $B<i2,(B $BCNI'(B <morioka@@jaist.ac.jp>
-@subtitle 1998/06/23
+@subtitle 1998/07/01
 @end titlepage
 @node Top, Introduction, (dir), (dir)
-@top FLIM 1.6 MIME $B5!G=@bL@=q(B
+@top FLIM 1.8 MIME $B5!G=@bL@=q(B
 
 @ifinfo
 
@@ -109,165 +109,148 @@ local $BJQ?t(B @code{mime-message-structure} $B$K3JG<$9$k$3$H$K$7$^$9!#(B
 
 
 @menu
-* mime-entity::                 mime-entity $B9=B$BN(B
-* Message parser::              Message $B$N2r@O4o(B
-* Entity as node in message::   Entity $B$N0LCV4X78$K4X$9$k5!G=(B
+* Entity creation::             Entity $B$N@8@.(B
+* Entity hierarchy::            Entity $B3,AX(B
+* Entity Attributes::           Entity $B$NB0@-(B
 * Entity-header::               Entity header $B$N>pJs(B
 * Entity-content::              Entity $B$NFbMF(B
+* Entity buffer::               Entity $B$N(B buffer $B$K$h$kI=8=(B
+* mm-backend::                  Entity $B$NI=8=$H<B8=(B
 @end menu
 
-@node mime-entity, Message parser, Entity, Entity
-@section mime-entity $B9=B$BN(B
+@node Entity creation, Entity hierarchy, Entity, Entity
+@section Entity $B$N@8@.(B
 
-@deffn{Structure} mime-entity
+@defun mime-open-entity &optional  type location
 
-entity $B$K4X$9$k>pJs$r<}$a$k9=B$BN!#(B@refill
+Open an entity and return it.@refill
 
-$B$3$N9=B$BN$r;2>H$9$k$K$O(B @code{mime-entity-$BMWAGL>(B} $B$H$$$&L>A0$N;2>H4X?t(B
-$B$rMQ$$$k!#(B@refill
+@var{type} is representation-type. (cf. @ref{mm-backend}) @refill
 
-$B$3$N9=B$BN$NMWAG$O0J2<$NDL$j$G$"$k!'(B
+@var{location} is location of entity.  Specification of it is depended
+on representation-type.
+@end defun
 
-@table @var
-@item buffer
-entity $B$,B8:_$9$k(B buffer (buffer)
 
-@item header-start
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B header $B$N@hF,0LCV(B
-(point)
+@defun mime-parse-message &optional  default-ctl node-id
 
-@item header-end
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B header $B$NKvHx0LCV(B
-(point)
+$B8=:_$N(B buffer $B$r(B message $B$H$7$F9=J82r@O$7!"$=$N7k2L$N(B mime-entity $B$rJV$9!#(B
+@end defun
 
-@item body-start
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B body $B$N@hF,0LCV(B
-(point)
 
-@item body-end
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B body $B$NKvHx0LCV(B
-(point)
+@defun mime-parse-buffer &optional  buffer
+
+@var{buffer} $B$r(B message $B$H$7$F9=J82r@O$7!"$=$N7k2L$N(B mime-entity $B$r(B 
+@var{buffer} $B$N(B@code{mime-message-structure} $B$K3JG<$9$k!#(B@refill
 
-@item node-id
-entity $B$N(B node-id ($B@0?t$N(B list)
+@var{buffer} $B$,>JN,$5$l$?>l9g!"8=:_$N(B buffer $B$r9=J82r@O$9$k!#(B
+@end defun
 
-@item content-type
-Content-Type (@ref{Content-Type}) $BMs$N>pJs(B(mime-content-type)
 
-@item content-disposition
-Content-Disposition (@ref{Content-Disposition}) $BMs$N>pJs(B
-(mime-content-disposition)
 
-@item encoding
-entity $B$N(B Content-Transfer-Encoding (@ref{Content-Transfer-Encoding})
-($BJ8;zNs(B)
+@node Entity hierarchy, Entity Attributes, Entity creation, Entity
+@section Entity $B3,AX(B
 
-@item children
-entity $B$K4^$^$l$k(B entity $B$N(B list (mime-entity $B$N(B 
-list)
+@defvar mime-message-structure
 
-@end table
+$B8=:_$N(B buffer $B$K$*$1$k(B message $BA4BN$N(B mime-entity $B9=B$BN$r3JG<$9$k(Bbuffer
+local $BJQ?t!#(B
+@end defvar
 
 
-$B$^$?!"2a5n$H$N8_49@-$N$?$a!"0J2<$NMWAGL>$N;2>H4X?t$bMxMQ2DG=$G$"$k!#(B
+@defun mime-entity-children entity
 
-@table @var
-@item type/subtype
-entity $B$N(B type/subtype ($BJ8;zNs(B)
+@var{entity} $B$K4^$^$l$k(B entity $B$N(B list $B$rJV$9!#(B
+@end defun
 
-@item media-type
-entity $B$N(B media-primary-type (symbol)
 
-@item media-subtype
-entity $B$N(B media-subtype (symbol)
+@defun mime-entity-parent entity  &optional  message
 
-@item parameters
-entity $B$N(B Content-Type $BMs$N(B parameter ($BO"A[(B list)
+@var{entity} $B$N?F$N(B entity $B$rJV$9!#(B@refill
 
-@end table
-@end deffn
+@var{message} $B$,;XDj$5$l$?>l9g!"$3$l$r:,$H8+Jo$9!#(B
+@end defun
 
 
-@defun make-mime-entity buffer header-start header-end body-start body-end
-	   &optional  node-id content-type content-disposition encoding
-	  children
+@defun mime-root-entity-p entity
 
-entity $B$N@8@.;R!#(B
+@var{entity} $B$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"Hs(B-@code{nil} $B$rJV(B
+$B$9!#(B
 @end defun
 
 
-@defun mime-entity-point-min entity
+@defun mime-entity-node-id entity
 
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B entity $B$N@hF,0LCV$rJV$9!#(B
+@var{entity} $B$N(B node-id $B$rJV$9!#(B
 @end defun
 
 
-@defun mime-entity-point-max entity
+@defun mime-entity-number entity
 
-entity $B$NB8:_$9$k(B buffer $B$K$*$1$k(B entity $B$NKvHx0LCV$rJV$9!#(B
+@var{entity} $B$N(B entity-number $B$rJV$9!#(B
 @end defun
 
 
+@defun mime-find-entity-from-number entity-number  &optional  message
 
-@node Message parser, Entity as node in message, mime-entity, Entity
-@section Message $B$N2r@O4o(B
-
-@defun mime-parse-message &optional  default-ctl default-encoding node-id
+Return entity from @var{entity-number} in @var{message}.@refill
 
-$B8=:_$N(B buffer $B$r9=J82r@O$7$?7k2L$rJV$9!#(B
+If @var{message} is not specified, @code{mime-message-structure} is
+used.
 @end defun
 
 
-@defun mime-parse-buffer &optional  buffer
+@defun mime-find-entity-from-node-id entity-node-id  &optional  message
 
-@var{buffer} $B$r9=J82r@O$7!"$=$N7k2L$r(B @var{buffer} $B$N(B
-@code{mime-message-structure} $B$K3JG<$9$k!#(B@refill
+Return entity from @var{entity-node-id} in @var{message}.@refill
 
-@var{buffer} $B$,>JN,$5$l$?>l9g!"8=:_$N(B buffer $B$r9=J82r@O$9$k!#(B
+If @var{message} is not specified, @code{mime-message-structure} is
+used.
 @end defun
 
 
 
-@node Entity as node in message, Entity-header, Message parser, Entity
-@section Entity $B$N0LCV4X78$K4X$9$k5!G=(B
+@node Entity Attributes, Entity-header, Entity hierarchy, Entity
+@section Entity $B$NB0@-(B
 
-@defvar mime-message-structure
+@defun mime-entity-content-type entity
 
-$B8=:_$N(B buffer $B$K$*$1$k(B message $BA4BN$N(B mime-entity $B9=B$BN$r3JG<$9$k(Bbuffer
-local $BJQ?t!#(B
-@end defvar
+@var{entity} $B$N(B content-type $B$rJV$9!#(B(cf. @ref{mime-content-type})
+@end defun
 
 
-@defun mime-entity-number entity
+@defun mime-entity-content-disposition entity
 
-@var{entity} $B$N(B entity-number $B$rJV$9!#(B
+@var{entity} $B$N(B content-disposition $B$rJV$9!#(B
+(cf. @ref{mime-content-disposition})
 @end defun
 
 
-@defun mime-entity-parent entity  &optional  message-structure
+@defun mime-entity-filename entity
 
-@var{entity} $B$N?F$N(B entity $B$rJV$9!#(B@refill
+Entity $B$N(B file $BL>$rJV$9!#(B
+@end defun
 
-@var{message-structure} $B$,>JN,$5$l$?>l9g$O(B entity $B$,B8:_$9$k(B buffer $B$K$*(B
-$B$1$k(B @code{mime-message-structure} $B$NCM$rMQ$$$k!#(B@refill
 
-@var{message-structure} $B$,;XDj$5$l$?>l9g!"$3$l$r:,$H8+Jo$9!#(B
+@defun mime-entity-encoding entity
+
+@var{entity} $B$N(B content-transfer-encoding $B$rJV$9!#(B
+(cf. @ref{Content-Transfer-Encoding})
 @end defun
 
 
-@defun mime-root-entity-p entity
+@defun mime-entity-cooked-p entity
 
-@var{entity} $B$,:,!JB($A!"(Bmessage $BA4BN!K$G$"$k>l9g$K!"Hs(B-@code{nil} $B$rJV(B
-$B$9!#(B
+Return non-nil if contents of @var{entity} has been already
+code-converted.
 @end defun
 
 
 
-@node Entity-header, Entity-content, Entity as node in message, Entity
+@node Entity-header, Entity-content, Entity Attributes, Entity
 @section Entity header $B$N>pJs(B
 
-@defun mime-fetch-field field-name
-	     &optional  entity
+@defun mime-fetch-field field-name  &optional  entity
 
 @var{entity} $B$N(B header $BCf$N(B @var{field-name} $BMs$N(B body $B$rJV$9!#(B@refill
 
@@ -280,8 +263,7 @@ local $BJQ?t!#(B
 @end defun
 
 
-@defun mime-read-field field-name
-	     &optional  entity
+@defun mime-read-field field-name  &optional  entity
 
 @var{entity} $B$N(B header $BCf$N(B @var{field-name} $BMs$r9=J82r@O$7$?7k2L$rJV$9!#(B
 @refill
@@ -299,7 +281,6 @@ local $BJQ?t!#(B
 
 
 @defun mime-insert-decoded-header entity  &optional  invisible-fields visible-fields
-	    code-conversion
 
 $B8=:_0LCV$K(B @var{entity} $B$NI|9f$7$?(B header $B$rA^F~$9$k!#(B@refill
 
@@ -313,7 +294,7 @@ local $BJQ?t!#(B
 
 
 
-@node Entity-content,  , Entity-header, Entity
+@node Entity-content, Entity buffer, Entity-header, Entity
 @section Entity $B$NFbMF(B
 
 @defun mime-entity-content entity
@@ -322,6 +303,128 @@ local $BJQ?t!#(B
 @end defun
 
 
+@defun mime-write-entity-content entity filename
+
+Write content of @var{entity} into @var{filename}.
+@end defun
+
+
+@defun mime-write-entity entity filename
+
+Write representation of @var{entity} into @var{filename}.
+@end defun
+
+
+@defun mime-write-entity-body entity filename
+
+Write body of @var{entity} into @var{filename}.
+@end defun
+
+
+
+@node Entity buffer, mm-backend, Entity-content, Entity
+@section Entity $B$N(B buffer $B$K$h$kI=8=(B
+
+@defun mime-entity-buffer entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$rJV$9!#(B
+@end defun
+
+
+@defun mime-entity-point-min entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(B@var{entity} $B$,@j$a$kNN0h$N@hF,(B
+$B0LCV$rJV$9!#(B
+@end defun
+
+
+@defun mime-entity-point-max entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(B@var{entity} $B$,@j$a$kNN0h$NKvHx(B
+$B0LCV$rJV$9!#(B
+@end defun
+
+
+@defun mime-entity-header-start entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bheader $B$,@j$a$kNN0h$N@hF,0LCV$r(B
+$BJV$9!#(B
+@end defun
+
+
+@defun mime-entity-header-end entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bheader $B$,@j$a$kNN0h$NKvHx0LCV$r(B
+$BJV$9!#(B
+@end defun
+
+
+@defun mime-entity-body-start entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bbody $B$,@j$a$kNN0h$N@hF,0LCV$rJV(B
+$B$9!#(B
+@end defun
+
+
+@defun mime-entity-body-end entity
+
+@var{entity} $B$,B8:_$9$k(B buffer $B$K$*$1$k!"(Bbody $B$,@j$a$kNN0h$NKvHx0LCV$rJV(B
+$B$9!#(B
+@end defun
+
+
+
+@node mm-backend,  , Entity buffer, Entity
+@section Entity $B$NI=8=$H<B8=(B
+@cindex mm-backend
+@cindex entity $B=hM}(B method
+@cindex representation-type
+
+Entity $B$OCj>]2=$5$l$?%G!<%?I=8=$G!"<B:]$N%G!<%?I=8=$H$7$F$OMQES$K1~$8$F(B
+$B$5$^$6$^$J$b$N$,MxMQ$G$-$k$h$&$K@_7W$5$l$F$$$^$9!#(B@refill
+
+$B$3$3$G!"(Bentity $B$,$I$&$$$&<oN`$NI=8=$r9T$C$F$$$k$+$r<($9$N$,(B
+@strong{representation-type} $B$G!"(Bentity $B$r@8@.$9$k;~$K$O$3$l$r;XDj$7$^$9!#(B
+(cf. @ref{Entity Creation}) @refill
+
+$BA0@a$^$G$K=R$Y$FMh$?(B entity $B$KBP$9$k=hM}$O!"(Bentity $B$KBP$7$F$=$N=hM}$r0M(B
+$BMj$9$k$3$H$K$h$C$F<B8=$5$l$F$$$^$9!#(BEntity $B$O<+J,$N(B representation-type 
+$B$rCN$C$F$*$j!"$=$N(B representation-type $B$K1~$8$F<B:]$N=hM}$r9T$&4X?t$r8F(B
+$B$S=P$7$^$9!#$3$N$h$&$J4X?t$r(B @strong{entity $B=hM}(Bmethod} $B$H8F$S$^$9!#$^$?!"(B
+representation-type $BKh$K$3$N$h$&$J4X?t$r$^$H$a$?$b$N$r(B 
+@strong{mm-backend} $B$H8F$S$^$9!#(B@refill
+
+mm-backend $B$O(B representation-type $B$NL>A0$N@hF,$K(B @code{mm} $B$H$$$&(B
+$B@\F,<-$rIU$1$?4X?tL>$+$i$J$k(B module $B$G!"$=$N(B module $BL>$OF1MM$K(B
+representation-type $B$NL>A0$N@hF,$K(B @code{mm} $B$rIU$1$?$b$N$K$J$C$F(B
+$B$$$^$9!#$3$N(B module $B$O(B representation-type $B$N(B entity $B$,:G=i$K@8@.$5$l$k(B
+$B;~$K<+F0E*$K(B require $B$5$l$^$9!#(B
+
+
+@menu
+* Request for entity::          Entity $B$X$NJX$j(B
+* mm-backend module::           mm-backend $B$N:n$jJ}(B
+@end menu
+
+@node Request for entity, mm-backend module, mm-backend, mm-backend
+@subsection Entity $B$X$NJX$j(B
+
+@defun mime-entity-send entity message  &rest  args
+
+@var{entity} $B$K(B @var{message} $B$rAw$k!#(B@refill
+
+@var{args} $B$O(B @var{message} $B$N0z?t$G$"$k!#(B
+@end defun
+
+
+
+@node mm-backend module,  , Request for entity, mm-backend
+@subsection mm-backend $B$N:n$jJ}(B
+
+$B!J$9$_$^$;$s!#$=$N$&$A=q$-$^$9(B (^_^;$B!K(B@refill
+
+$B!J$H$j$"$($:!"(Bmm*.el $B$r;29M$K$7$F$/$@$5$$!K(B
+
 
 @node Content-Type, Content-Disposition, Entity, Top
 @chapter Content-Type $BMs$N>pJs(B
@@ -1290,7 +1393,7 @@ FLIM $B$N(B file $B$O(B CVS $B$r;H$C$F4IM}$5$l$F$$$^$9!#$3$N$?$a!"0J2<$NJ}K
 (1) checkout
 
     % cvs -d :pserver:anonymous@@chamonix.jaist.ac.jp:/hare/cvs/root \
-	checkout [-r TAG] gnus
+	checkout [-r TAG] flim
 @end example