(mmbuffer-write-entity): Use `mime-entity-buffer-internal',
[elisp/flim.git] / mime-ja.texi
index 0ac8e6a..8a3c58d 100644 (file)
@@ -1,13 +1,13 @@
 \input texinfo.tex
 @setfilename mime-ja.info
-@settitle{FLIM 1.7 MIME \e$B5!G=@bL@=q\e(B}
+@settitle{FLIM 1.8 MIME \e$B5!G=@bL@=q\e(B}
 @titlepage
-@title FLIM 1.7 MIME \e$B5!G=@bL@=q\e(B
+@title FLIM 1.8 MIME \e$B5!G=@bL@=q\e(B
 @author \e$B<i2,\e(B \e$BCNI'\e(B <morioka@@jaist.ac.jp>
-@subtitle 1998/06/23
+@subtitle 1998/07/01
 @end titlepage
 @node Top, Introduction, (dir), (dir)
-@top FLIM 1.7 MIME \e$B5!G=@bL@=q\e(B
+@top FLIM 1.8 MIME \e$B5!G=@bL@=q\e(B
 
 @ifinfo
 
@@ -108,23 +108,29 @@ local \e$BJQ?t\e(B @code{mime-message-structure} \e$B$K3JG<$9$k$3$H$K$7$^$9!#\e(B
 \e$B07$&$3$H$,$G$-$^$9!#\e(B
 
 
-
-
-
-
-
-
 @menu
-* Message parser::              Message \e$B$N2r@O4o\e(B
+* Entity creation::             Entity \e$B$N@8@.\e(B
 * Entity hierarchy::            Entity \e$B3,AX\e(B
-* Entity buffer::               Entity \e$B$N\e(B buffer \e$B$K$h$kI=8=\e(B
-* Entity-header::               Entity header \e$B$N>pJs\e(B
 * Entity Attributes::           Entity \e$B$NB0@-\e(B
+* Entity-header::               Entity header \e$B$N>pJs\e(B
 * Entity-content::              Entity \e$B$NFbMF\e(B
+* Entity buffer::               Entity \e$B$N\e(B buffer \e$B$K$h$kI=8=\e(B
+* mm-backend::                  Entity \e$B$NI=8=$H<B8=\e(B
 @end menu
 
-@node Message parser, Entity hierarchy, Entity, Entity
-@section Message \e$B$N2r@O4o\e(B
+@node Entity creation, Entity hierarchy, Entity, Entity
+@section Entity \e$B$N@8@.\e(B
+
+@defun mime-open-entity &optional  type location
+
+Open an entity and return it.@refill
+
+@var{type} is representation-type. (cf. @ref{mm-backend}) @refill
+
+@var{location} is location of entity.  Specification of it is depended
+on representation-type.
+@end defun
+
 
 @defun mime-parse-message &optional  default-ctl node-id
 
@@ -142,7 +148,7 @@ local \e$BJQ?t\e(B @code{mime-message-structure} \e$B$K3JG<$9$k$3$H$K$7$^$9!#\e(B
 
 
 
-@node Entity hierarchy, Entity buffer, Message parser, Entity
+@node Entity hierarchy, Entity Attributes, Entity creation, Entity
 @section Entity \e$B3,AX\e(B
 
 @defvar mime-message-structure
@@ -204,59 +210,44 @@ used.
 
 
 
-@node Entity buffer, Entity-header, Entity hierarchy, Entity
-@section Entity \e$B$N\e(B buffer \e$B$K$h$kI=8=\e(B
-
-@defun mime-entity-buffer entity
-
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$rJV$9!#\e(B
-@end defun
-
-
-@defun mime-entity-point-min entity
-
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(B@var{entity} \e$B$,@j$a$kNN0h$N@hF,\e(B
-\e$B0LCV$rJV$9!#\e(B
-@end defun
-
+@node Entity Attributes, Entity-header, Entity hierarchy, Entity
+@section Entity \e$B$NB0@-\e(B
 
-@defun mime-entity-point-max entity
+@defun mime-entity-content-type entity
 
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(B@var{entity} \e$B$,@j$a$kNN0h$NKvHx\e(B
-\e$B0LCV$rJV$9!#\e(B
+@var{entity} \e$B$N\e(B content-type \e$B$rJV$9!#\e(B(cf. @ref{mime-content-type})
 @end defun
 
 
-@defun mime-entity-header-start entity
+@defun mime-entity-content-disposition entity
 
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bheader \e$B$,@j$a$kNN0h$N@hF,0LCV$r\e(B
-\e$BJV$9!#\e(B
+@var{entity} \e$B$N\e(B content-disposition \e$B$rJV$9!#\e(B
+(cf. @ref{mime-content-disposition})
 @end defun
 
 
-@defun mime-entity-header-end entity
+@defun mime-entity-filename entity
 
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bheader \e$B$,@j$a$kNN0h$NKvHx0LCV$r\e(B
-\e$BJV$9!#\e(B
+Entity \e$B$N\e(B file \e$BL>$rJV$9!#\e(B
 @end defun
 
 
-@defun mime-entity-body-start entity
+@defun mime-entity-encoding entity
 
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bbody \e$B$,@j$a$kNN0h$N@hF,0LCV$rJV\e(B
-\e$B$9!#\e(B
+@var{entity} \e$B$N\e(B content-transfer-encoding \e$B$rJV$9!#\e(B
+(cf. @ref{Content-Transfer-Encoding})
 @end defun
 
 
-@defun mime-entity-body-end entity
+@defun mime-entity-cooked-p entity
 
-@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bbody \e$B$,@j$a$kNN0h$NKvHx0LCV$rJV\e(B
-\e$B$9!#\e(B
+Return non-nil if contents of @var{entity} has been already
+code-converted.
 @end defun
 
 
 
-@node Entity-header, Entity Attributes, Entity buffer, Entity
+@node Entity-header, Entity-content, Entity Attributes, Entity
 @section Entity header \e$B$N>pJs\e(B
 
 @defun mime-fetch-field field-name  &optional  entity
@@ -290,7 +281,6 @@ used.
 
 
 @defun mime-insert-decoded-header entity  &optional  invisible-fields visible-fields
-           code-conversion
 
 \e$B8=:_0LCV$K\e(B @var{entity} \e$B$NI|9f$7$?\e(B header \e$B$rA^F~$9$k!#\e(B@refill
 
@@ -304,45 +294,137 @@ used.
 
 
 
-@node Entity Attributes, Entity-content, Entity-header, Entity
-@section Entity \e$B$NB0@-\e(B
+@node Entity-content, Entity buffer, Entity-header, Entity
+@section Entity \e$B$NFbMF\e(B
 
-@defun mime-entity-content-type entity
+@defun mime-entity-content entity
 
-@var{entity} \e$B$N\e(B content-type \e$B$rJV$9!#\e(B(cf. @ref{mime-content-type})
+@var{entity} \e$B$NFbMF$N\e(B byte \e$BNs$rJV$9!#\e(B
 @end defun
 
 
-@defun mime-entity-content-disposition entity
+@defun mime-write-entity-content entity filename
 
-@var{entity} \e$B$N\e(B content-disposition \e$B$rJV$9!#\e(B
-(cf. @ref{mime-content-disposition})
+Write content of @var{entity} into @var{filename}.
 @end defun
 
 
-@defun mime-entity-filename entity
+@defun mime-write-entity entity filename
 
-Entity \e$B$N\e(B file \e$BL>$rJV$9!#\e(B
+Write representation of @var{entity} into @var{filename}.
 @end defun
 
 
-@defun mime-entity-encoding entity
+@defun mime-write-entity-body entity filename
 
-@var{entity} \e$B$N\e(B content-transfer-encoding \e$B$rJV$9!#\e(B
-(cf. @ref{Content-Transfer-Encoding})
+Write body of @var{entity} into @var{filename}.
 @end defun
 
 
 
-@node Entity-content,  , Entity Attributes, Entity
-@section Entity \e$B$NFbMF\e(B
+@node Entity buffer, mm-backend, Entity-content, Entity
+@section Entity \e$B$N\e(B buffer \e$B$K$h$kI=8=\e(B
 
-@defun mime-entity-content entity
+@defun mime-entity-buffer entity
 
-@var{entity} \e$B$NFbMF$N\e(B byte \e$BNs$rJV$9!#\e(B
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$rJV$9!#\e(B
+@end defun
+
+
+@defun mime-entity-point-min entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(B@var{entity} \e$B$,@j$a$kNN0h$N@hF,\e(B
+\e$B0LCV$rJV$9!#\e(B
+@end defun
+
+
+@defun mime-entity-point-max entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(B@var{entity} \e$B$,@j$a$kNN0h$NKvHx\e(B
+\e$B0LCV$rJV$9!#\e(B
+@end defun
+
+
+@defun mime-entity-header-start entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bheader \e$B$,@j$a$kNN0h$N@hF,0LCV$r\e(B
+\e$BJV$9!#\e(B
+@end defun
+
+
+@defun mime-entity-header-end entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bheader \e$B$,@j$a$kNN0h$NKvHx0LCV$r\e(B
+\e$BJV$9!#\e(B
 @end defun
 
 
+@defun mime-entity-body-start entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bbody \e$B$,@j$a$kNN0h$N@hF,0LCV$rJV\e(B
+\e$B$9!#\e(B
+@end defun
+
+
+@defun mime-entity-body-end entity
+
+@var{entity} \e$B$,B8:_$9$k\e(B buffer \e$B$K$*$1$k!"\e(Bbody \e$B$,@j$a$kNN0h$NKvHx0LCV$rJV\e(B
+\e$B$9!#\e(B
+@end defun
+
+
+
+@node mm-backend,  , Entity buffer, Entity
+@section Entity \e$B$NI=8=$H<B8=\e(B
+@cindex mm-backend
+@cindex entity \e$B=hM}\e(B method
+@cindex representation-type
+
+Entity \e$B$OCj>]2=$5$l$?%G!<%?I=8=$G!"<B:]$N%G!<%?I=8=$H$7$F$OMQES$K1~$8$F\e(B
+\e$B$5$^$6$^$J$b$N$,MxMQ$G$-$k$h$&$K@_7W$5$l$F$$$^$9!#\e(B@refill
+
+\e$B$3$3$G!"\e(Bentity \e$B$,$I$&$$$&<oN`$NI=8=$r9T$C$F$$$k$+$r<($9$N$,\e(B
+@strong{representation-type} \e$B$G!"\e(Bentity \e$B$r@8@.$9$k;~$K$O$3$l$r;XDj$7$^$9!#\e(B
+(cf. @ref{Entity Creation}) @refill
+
+\e$BA0@a$^$G$K=R$Y$FMh$?\e(B entity \e$B$KBP$9$k=hM}$O!"\e(Bentity \e$B$KBP$7$F$=$N=hM}$r0M\e(B
+\e$BMj$9$k$3$H$K$h$C$F<B8=$5$l$F$$$^$9!#\e(BEntity \e$B$O<+J,$N\e(B representation-type 
+\e$B$rCN$C$F$*$j!"$=$N\e(B representation-type \e$B$K1~$8$F<B:]$N=hM}$r9T$&4X?t$r8F\e(B
+\e$B$S=P$7$^$9!#$3$N$h$&$J4X?t$r\e(B @strong{entity \e$B=hM}\e(Bmethod} \e$B$H8F$S$^$9!#$^$?!"\e(B
+representation-type \e$BKh$K$3$N$h$&$J4X?t$r$^$H$a$?$b$N$r\e(B 
+@strong{mm-backend} \e$B$H8F$S$^$9!#\e(B@refill
+
+mm-backend \e$B$O\e(B representation-type \e$B$NL>A0$N@hF,$K\e(B @code{mm} \e$B$H$$$&\e(B
+\e$B@\F,<-$rIU$1$?4X?tL>$+$i$J$k\e(B module \e$B$G!"$=$N\e(B module \e$BL>$OF1MM$K\e(B
+representation-type \e$B$NL>A0$N@hF,$K\e(B @code{mm} \e$B$rIU$1$?$b$N$K$J$C$F\e(B
+\e$B$$$^$9!#$3$N\e(B module \e$B$O\e(B representation-type \e$B$N\e(B entity \e$B$,:G=i$K@8@.$5$l$k\e(B
+\e$B;~$K<+F0E*$K\e(B require \e$B$5$l$^$9!#\e(B
+
+
+@menu
+* Request for entity::          Entity \e$B$X$NJX$j\e(B
+* mm-backend module::           mm-backend \e$B$N:n$jJ}\e(B
+@end menu
+
+@node Request for entity, mm-backend module, mm-backend, mm-backend
+@subsection Entity \e$B$X$NJX$j\e(B
+
+@defun mime-entity-send entity message  &rest  args
+
+@var{entity} \e$B$K\e(B @var{message} \e$B$rAw$k!#\e(B@refill
+
+@var{args} \e$B$O\e(B @var{message} \e$B$N0z?t$G$"$k!#\e(B
+@end defun
+
+
+
+@node mm-backend module,  , Request for entity, mm-backend
+@subsection mm-backend \e$B$N:n$jJ}\e(B
+
+\e$B!J$9$_$^$;$s!#$=$N$&$A=q$-$^$9\e(B (^_^;\e$B!K\e(B@refill
+
+\e$B!J$H$j$"$($:!"\e(Bmm*.el \e$B$r;29M$K$7$F$/$@$5$$!K\e(B
+
 
 @node Content-Type, Content-Disposition, Entity, Top
 @chapter Content-Type \e$BMs$N>pJs\e(B