2 @setfilename mime-ui-en.info
3 @settitle{SEMI 1.8 Manual}
6 @author MORIOKA Tomohiko <morioka@@jaist.ac.jp>
9 @node Top, Introduction, (dir), (dir)
14 This file documents SEMI, a MIME user interface for GNU Emacs.
18 * Introduction:: What is SEMI?
19 * MIME-View:: MIME message viewing
20 * MIME-Edit:: MIME message editing
21 * Various:: Miscellaneous
27 @node Introduction, MIME-View, Top, Top
28 @chapter What is SEMI?
30 SEMI is a package for GNU Emacs to provide features related with MIME
31 user interface.@refill
33 SEMI
\e$B$,Ds6!$9$k
\e(B MIME user interface
\e$B$O
\e(B MIME-View
\e$B$H
\e(B MIME-Edit
\e$B$+$i$J$j$^
\e(B
37 MIME-View
\e$B$O
\e(B MIME
\e$B$d
\e(B STD 11
\e$B$*$h$S!XCO0h2=$5$l$?
\e(B RFC 822
\e$B!Y
\e(Bmessage
\e$B$rI=<(
\e(B
38 \e$B$7$?$j!"A`:n$7$?$j$9$k$?$a$N
\e(B user interface
\e$B$NCf3K$G$9!#
\e(B@refill
40 MIME-Edit
\e$B$O
\e(B MIME message
\e$B$r@8@.$9$k$?$a$N
\e(B user interface
\e$B$G$9!#
\e(B@refill
42 \e$B3F
\e(B MUA
\e$B$G$3$l$i$N5!G=$rMxMQ$9$k$3$H$K$h$j!"9bEY$J
\e(B MIME
\e$B5!G=$rMxMQ$9$k$3
\e(B
43 \e$B$H$,$G$-$^$9!#
\e(B
46 @node MIME-View, MIME-Edit, Introduction, Top
47 @chapter MIME message viewing
49 MIME-View
\e$B$O
\e(B GNU Emacs
\e$B$GF0:n$9$kHFMQE*$J
\e(B MIME viewer
\e$B$G$9!#
\e(B@refill
51 MIME-View
\e$B$O
\e(B MIME message
\e$B$r1\Mw$9$k$?$a$NMxMQ<T3&LL
\e(B (user interface)
52 \e$B$N3K$G$"$j!"$3$N>e$G
\e(B presentation-method
\e$B$H8F$P$l$kI=<($r:n$k%W%m%0%i%`
\e(B
53 \e$B$rF0$+$7$?$j!"
\e(Bacting-method
\e$B$H8F$P$l$k
\e(B entity
\e$B$N=hM}%W%m%0%i%`$rF0$+$9
\e(B
54 \e$B$3$H$,2DG=$G!"$5$^$6$^$J<oN`$N
\e(B entity
\e$B$r07$&;v$,$G$-$k$h$&$K$J$C$F$$$^$9!#
\e(B
58 * Overview of MIME-View:: Basic design
59 * MIME-Preview:: Presentation of mime-preview-buffer
60 * mime-view-mode:: Operation in mime-preview-buffer
63 @node Overview of MIME-View, MIME-Preview, MIME-View, MIME-View
66 Internet
\e$B$NEE;R=q4J!&%M%C%H%K%e!<%9$J$I$N=qLL
\e(B (message)
\e$B$NI=8=7A<0$O
\e(B STD
67 11
\e$B$K4p$E$$$F$$$^$9!#
\e(BSTD 11
\e$B$N=qLLK\BN
\e(B (message body)
\e$B$O9T$rM#0l$N9=B$$H
\e(B
68 \e$B$9$k4J0WJ8LL
\e(B (plain text)
\e$B$G$"$j!"J8;zId9f$b
\e(B us-ascii
\e$B$HDj$a$i$l$F$$$^$9!#
\e(B
69 \e$B<B:]$K$O!"J8;zId9f$r
\e(B us-ascii
\e$B$NBe$o$j$K$=$N8@8l7w$GMQ$$$i$l$kJ8;zId9f$H
\e(B
70 \e$B$7$?!XCO0h2=$5$l$?
\e(B STD 11
\e$B!Y=qLL$bMQ$$$i$l$F$-$^$7$?$,!"$3$N>l9g$b=qLL$N
\e(B
71 \e$BJ8;zId9f$O#1$D$G$9!#$3$N$?$a!"MxMQ<T3&LL
\e(B (Message User Agent)
\e$B$O!"$7$P$7
\e(B
72 \e$B$P!"
\e(Bbyte
\e$BNs
\e(B = us-ascii
\e$BJ8;zNs!"$J$$$7$O!"
\e(Bbyte
\e$BNs
\e(B =
\e$B$=$N8@8l7w$GMQ$$$kJ8
\e(B
73 \e$B;zId9f$NJ8;zNs$N$h$&$K8+Jo$7$F$-$^$7$?!#
\e(B@refill
75 \e$B$7$+$7$J$,$i!"
\e(BMIME
\e$B$G$O=qLL$O
\e(B entity
\e$B$rC10L$H$9$kLZ9=B$$K$J$j!"$^$?!"#1
\e(B
76 \e$B$D$N=qLL$GJ#?t$NJ8;zId9f$rMQ$$$k$3$H$,$G$-$^$9!#$^$?!"
\e(Bentity
\e$B$NFbMF$OJ8
\e(B
77 \e$BLL$d3($N$h$&$JC1=c$KI=<(2DG=$J$b$N$@$1$G$J$/!"2;@<$dF02h$J$I$N0lDj;~4V:F
\e(B
78 \e$B@8$5$l$k$h$&$J$b$N$dFCDj$N%"%W%j%1!<%7%g%s$N%G!<%?$d%W%m%0%i%`$N%=!<%9!"
\e(B
79 \e$B$"$k$$$O!"
\e(Bftp
\e$B$d
\e(B mail service
\e$B$NMxMQK!$d
\e(B URL
\e$B$H$$$C$?7A$GI=$5$l$?30It;2
\e(B
80 \e$B>H$J$I$N$5$^$6$^$J$b$N$,9M$($i$^$9!#$3$N$?$a!"I=<($@$1$r9M$($F$$$?
\e(B STD
81 11
\e$B$K$*$1$kMxMQ<T3&LL$NC1=c$J1dD9$G$O
\e(B MIME
\e$B$NA4$F$N5!G=$r07$&$3$H$O$G$-
\e(B
82 \e$B$^$;$s!#$D$^$j!"
\e(BMIME
\e$B$N7A<0$K9g$o$;$FI|9f$9$k$@$1$G$OIT==J,$G$"$j!"MxMQ
\e(B
83 \e$B<T$H$NBPOCE*$J:F@8=hM}$r9MN8$9$kI,MW$,$"$j$^$9!#
\e(BMIME
\e$B=qLL$N7A<0$O<+F0=h
\e(B
84 \e$BM}$,$7$d$9$/@_7W$5$l$F$$$^$9$,!"
\e(BMIME
\e$B=qLL$K4^$^$l$kFbMF$NCf$K$O%;%-%e%j
\e(B
85 \e$B%F%#!<>e$NLdBj$+$i<+F0=hM}$r$9$k$Y$-$G$J$$$b$N$,$"$j!"$3$&$$$C$?$b$N$N:F
\e(B
86 \e$B@8$K4X$7$F$OMxMQ<T$NH=CG$r6D$0$h$&$K@_7W$5$l$k$Y$-$G$7$g$&!#7k6I!"
\e(BMIME
87 \e$B=qLL$r07$&$?$a$K$O
\e(B STD 11
\e$B$*$h$S
\e(B MIME
\e$B$N9=J8$G5-=R$5$l$?%a%C%;!<%8$N>pJs
\e(B
88 \e$B8r49MQI=8=$H$=$N2r<a7k2L$G$"$kI=<(2hLL$d:F@8Ey$N=hM}$r6hJL$7$F9M$($kI,MW
\e(B
89 \e$B$,$"$j$^$9!#$^$?!"MxMQ<T$H$NBPOCE*$J:F@8=hM}$,I,MW$G$9!#
\e(B@refill
91 \e$B$3$N$?$a!"
\e(BMIME-View
\e$B$O#1$D$N=qLL$KBP$7$F!">pJs8r49MQI=8=$r3JG<$9$k
\e(B
92 mime-raw-buffer
\e$B$HI=<(MQI=8=$r3JG<$9$k
\e(B mime-preview-buffer
\e$B$N#2$D$N
\e(B
93 buffer
\e$B$rMQ$$$^$9!#
\e(B@refill
95 MIME-View
\e$B$O
\e(B mime-preview-buffer
\e$B$KBP$7$F
\e(B mime-view-mode
\e$B$H$$$&
\e(B MIME
96 message
\e$B$r1\Mw$9$k$?$a$N
\e(B mode
\e$B$rDs6!$7$^$9!#MxMQ<T$O$3$3$G3F
\e(B entity
\e$B$K
\e(B
97 \e$BBP$7$FA`:n$r9T$&$3$H$,$G$-$^$9!#
\e(B
100 @node MIME-Preview, mime-view-mode, Overview of MIME-View, MIME-View
101 @section Presentation of mime-preview-buffer
103 mime-view-mode
\e$B$G$O3F
\e(B entity
\e$B$KBP$7$F
\e(B@refill
114 \e$B$H$$$&>pJs$rI=<($7$^$9!#$3$l$i$O>r7o$K=>$C$F
\e(B design
\e$B$rJQ99$7$?$j!"I=<(
\e(B
115 \e$B$rM^@)$9$k$3$H$b$G$-$^$9!#
\e(B
117 \e$B0J2<$K!"I=<(Nc$r<($7$^$9!#
\e(B
121 From: morioka@@jaist.ac.jp (
\e$B<i2,
\e(B
\e$BCNI'
\e(B / MORIOKA Tomohiko)
122 Subject: Re:
\e$B<ALd!)
\e(B
123 Newsgroups: zxr.message.mime
124 Date: 22 Oct 93 11:02:44
126 Organization: Japan Advanced Institute of Science and Technology,
130 MIME-Edit mode
\e$B$K$*$1$k!"
\e(BMIME message
\e$B$N:n$jJ}!#
\e(B
132 C-c C-x ?
\e$B$r2!$9$H
\e(B help
\e$B$,=P$F$/$k!#
\e(B
134 C-c C-x C-t insert a text message.
135 C-c C-x TAB insert a (binary) file.
136 C-c C-x C-e insert a reference to external body.
137 C-c C-x C-v insert a voice message.
138 C-c C-x C-y insert a mail or news message.
139 C-c C-x RET insert a mail message.
140 C-c C-x C-s insert a signature file at end.
141 C-c C-x t insert a new MIME tag.
142 C-c C-x a enclose as multipart/alternative.
143 C-c C-x p enclose as multipart/parallel.
144 C-c C-x m enclose as multipart/mixed.
145 C-c C-x d enclose as multipart/digest.
146 C-c C-x s enclose as PGP signed.
147 C-c C-x e enclose as PGP encrypted.
148 C-c C-x C-k insert PGP public key.
149 C-c C-x C-p preview editing MIME message.
152 \e$B$C$FLu$G!"
\e(BC-c C-x C-i
\e$B$r2!$7$F!"A^F~$7$?$$
\e(B binary file
\e$B$r;XDj$7$^$9!#
\e(B
154 binary file
\e$B$N
\e(B MIME encoding
\e$B$K$O!"IaDL!"
\e(BBase64
\e$B$r;XDj$7$^$9!#
\e(B
160 \e$B$3$s$JIw$K!"3(F~$j
\e(B message
\e$B$N$G$->e$,$j!#
\e(B
162 \e$B".".".".".".".".".".".
\e(B
\e$B%m%7%"%s!&%F%#!<$r0lGU!#
\e(B
\e$B".".".".".".".".".".".
\e(B
163 \e$B".".".".".
\e(B
\e$B!y
\e(B
\e$B%8%c%`$G$O$J$/%^!<%^%l!<%I$G$b$J$/K*L*$G
\e(B
\e$B!y
\e(B
\e$B".".".".".
\e(B
164 \e$B".".".".".
\e(B
\e$B'.'0'2$$'0','!
\e(B
\e$B'4'0'.'0'7'*','0
\e(B
\e$B".".".".".
\e(B
165 \e$B".".".".".".".
\e(B Internet E-mail: <morioka@@jaist.ac.jp>
\e$B".".".".".".".
\e(B
176 @node entity-button, entity-header, MIME-Preview, MIME-Preview
177 @subsection entity-button
178 @cindex entity-number
179 @cindex entity-button
181 @strong{entity-button}
\e$B$O
\e(B entity
\e$B$N@hF,$K$"$C$F!"$=$N
\e(B entity
\e$B$K4X$9$kBg
\e(B
182 \e$B$^$+$J>pJs$rI=<($9$kItJ,$G$9!#
\e(B@refill
187 [1.3 test (text/plain)]
191 \e$B$N$h$&$J46$8$KI=<($5$l$^$9!#
\e(B
193 \e$B:G=i$N?t;z$O
\e(B message
\e$BCf$N$3$N
\e(B entity
\e$B$N0LCV$r@aHV9f$N$h$&$KI=$7$?$b$N$G!"
\e(B
194 @strong{entity-number}
\e$B$H8F$S$^$9!#
\e(B@refill
196 \e$B#2HVL\$NJ8;zNs$OI=Bj$rI=$7$^$9!#$3$N>pJs$O!"
\e(B
200 Content-Description field
\e$B$b$7$/$O
\e(B Subject field
\e$B$K=q$+$l$?I=Bj
\e(B
202 Content-Disposition field
\e$B$N
\e(B filename parameter
\e$B$K=q$+$l$?
\e(B file
\e$BL>
\e(B
204 Content-Type field
\e$B$N
\e(B name parameter
\e$B$K=q$+$l$?
\e(B file
\e$BL>
\e(B
206 uuencode
\e$B$N>l9g$N
\e(B file
\e$BL>
\e(B
210 \e$B$+$i:n$j$^$9!#$I$l$bB8:_$7$J$$>l9g$O6uGr$,I=<($5$l$^$9!#
\e(B
212 \e$B#3HVL\$N3g8L$NCf$N>pJs$O$=$N
\e(B entity
\e$B$N
\e(B media-type/subtype
\e$B$rI=$7$^$9!#Hs
\e(B
213 MIME entity
\e$B$N>l9g!"
\e(B@code{nil}
\e$B$,I=<($5$l$^$9!#
\e(B@refill
215 \e$B$3$N
\e(B entity-button
\e$B$O
\e(B entity
\e$B$NFbMF$r>]D'$9$k
\e(B icon
\e$B$N$h$&$JLr3d$r2L$?
\e(B
216 \e$B$7$^$9!#Nc$($P!"
\e(B
223 \e$B$N>e$G
\e(B @kbd{v}
\e$B$r2!$;$P$3$3$KF~$C$F$$$k3($,I=<($5$l$^$9!#
\e(B
225 \e$B$^$?!"
\e(Bmouse
\e$BA`:n$,2DG=$J>l9g!"
\e(Bentity-button
\e$B$rBh#2%\%?%s!J
\e(B3 button
226 mouse
\e$B$N>l9g!"Cf1{$N%\%?%s!K$G2!$;$P!"F1MM$K$=$N3($,I=<($5$l$^$9!#
\e(B
229 @node entity-header, entity-body, entity-button, MIME-Preview
230 @subsection entity-header
231 @cindex entity-header
233 @strong{entity-header}
\e$B$O$"$k
\e(B entity
\e$B$N
\e(B header
\e$B$rI=<($9$kIt
\e(B
234 \e$BJ,$G$9!J!V$=$N$^$^$d$s$1!W$C$FE\$i$J$$$G!#$=$&$$$&$b$s$J$s$G$9!K!#
\e(B
237 @node entity-body, , entity-header, MIME-Preview
238 @subsection entity-body
241 @strong{entity-body}
\e$B$O
\e(B part
\e$B$NFbMF$rI=<($9$kItJ,$G$9!#
\e(B@refill
243 \e$B$3$l$b$R$M$j$,B-$j$J$$$G$9$,!"$^$"!"$=$&$$$&$b$s$G$9!#
\e(B@refill
245 \e$B$H$O$$$(!"<B:]$K$O>/$7$R$M$C$F$^$9!#
\e(B@refill
247 text entity
\e$B$N>l9g$O
\e(B charset
\e$B$K1~$8$F
\e(B code
\e$BJQ49$7$?$j$7$^$9$7!"
\e(BXEmacs
\e$B$G
\e(B
248 \e$B$O
\e(B image entity
\e$B$rJQ49$7$J$$$H$$$1$J$$$7!#
\e(B@refill
250 \e$B>\$7$/$O$^$?8e$G!#
\e(B
253 @node mime-view-mode, , MIME-Preview, MIME-View
254 @section Operation in mime-preview-buffer
256 mime-preview-buffer
\e$B$K$O0J2<$N5!G=$,$"$j$^$9!#
\e(B@refill
260 \e$B>e$N
\e(B part
\e$B$KLa$k!J
\e(Bmessage
\e$B$N0lHV>e$N
\e(B part
\e$B$G$3$l$r9T$J$&$H
\e(B Summary
261 mode
\e$B$KLa$k
\e(B (*1)
\e$B!K
\e(B
264 \e$BA0$N
\e(B part
\e$B$K0\F0$9$k
\e(B
267 \e$BA0$N
\e(B part
\e$B$K0\F0$9$k
\e(B
270 \e$B<!$N
\e(B part
\e$B$K0\F0$9$k
\e(B
273 \e$B<!$N
\e(B part
\e$B$K0\F0$9$k
\e(B
276 scroll up
\e$B$9$k
\e(B
279 scroll down
\e$B$9$k
\e(B
282 scroll down
\e$B$9$k
\e(B
285 \e$B<!$N9T$K0\F0$9$k
\e(B
288 \e$BA0$N9T$K0\F0$9$k
\e(B
291 part
\e$B$r:F@8$9$k
\e(B (*2)
294 part
\e$B$+$i
\e(B file
\e$B$r<h$j=P$9
\e(B (*2)
297 part
\e$B$r0u:~$9$k
\e(B (*2)
299 @item @key{mouse-button-2}
300 preview-buffer
\e$BCf$N
\e(B mouse button
\e$B$r5/F0$9$k
\e(B
302 content-button
\e$B$r2!$;$P!"$=$N
\e(B part
\e$B$,:F@8$5$l$k
\e(B(*2)@refill
304 URL-button
\e$B$r2!$;$P!"$=$N
\e(B WWW browser
\e$B$,5/F0$5$l$k
\e(B@refill
309 @strong{[
\e$BCm0U
\e(B]}
312 (*1) MUA
\e$B$G
\e(B mime-view
\e$B$N@_Dj$r$7$F$$$J$$>l9g!"
\e(BSummary mode
\e$B$K$OLa$j$^$;
\e(B
315 (*2)
\e$B<B:]$NF0:n$OBP1~$9$k
\e(B method
\e$B$K0M$j$^$9!#
\e(B
320 @node MIME-Edit, Various, MIME-View, Top
321 @chapter MIME message editing
324 @strong{MIME-Edit} is a general MIME composer for GNU Emacs.
328 * mime-edit-mode:: Minor-mode to edit MIME message
329 * single-part tags:: Operations for single-part
330 * enclosure tags:: Operations for enclosure
331 * other MIME-Edit operations:: Other operations
332 * file-type specification:: How to detect tag for inserted file
336 @node mime-edit-mode, single-part tags, MIME-Edit, MIME-Edit
337 @section Minor-mode to edit MIME message
339 @cindex multi-part ending tag
340 @cindex multi-part beginning tag
342 @cindex mime-edit-mode
344 @strong{mime-edit-mode} is a minor mode to compose MIME message. In
345 this mode, @strong{tag} represents various kinds of data, so you can
346 edit multi part message consists of various kinds of data, such as text,
347 image, audio, etc.@refill
349 There are 2 kinds of tags:
358 single-part tag represents single part, this form is following:@refill
361 --[[TYPE/SUBTYPE;PARAMETERS][ENCODING]
365 TYPE/SUBTYPE and PARAMETERS indicates type/subtype and parameters of
366 Content-Type (@ref{(mime-en)Content-Type}) field. TYPE/SUBTYPE is
367 required, PARAMETERS is optional.@refill
369 ENCODING indicates Content-Transfer-Encoding
370 (@ref{(mime-ja)Content-Transfer-Encoding}) field. It is optional
373 OPTIONAL-FIELDS is to represent another fields except Content-Type field
374 and Content-Transfer-Encoding field.@refill
376 multi-part tags represent multi part (@ref{(mime-en)multipart}). They
377 consist of a pair of @strong{multi-part beginning tag} and
378 @strong{multi-part ending tag}.@refill
380 multi-part beginning tag's form is following:
386 multi-part ending tag's form is following:
392 A region from multi-part beginning tag to multi-part ending tag is
393 called as @strong{enclosure}.
396 @node single-part tags, enclosure tags, mime-edit-mode, MIME-Edit
397 @section Operations for single-part
399 Operations to make single-part are following:
402 @item @key{C-c C-x C-t}
403 Insert single-part tag indicates text part.
405 @item @key{C-c C-x C-i}
406 Insert file as a MIME attachment. If @kbd{C-u} is followed by it, it
407 asks media-type, subtype or encoding even if their default values are
408 specified. (cf. @ref{tag specification for inserted file})
410 @item @key{C-c C-x C-e}
411 Insert external part.
413 @item @key{C-c C-x C-v}
414 Record audio input until @kbd{C-g} is pressed, and insert as a
415 audio part. (It requires /dev/audio in default.)
417 @item @key{C-c C-x C-y}
418 Insert current (mail or news) message. (It is MUA depended.)
420 @item @key{C-c C-x C-m}
421 Insert mail message. (It is MUA depended.)
423 @item @key{C-c C-x C-w}, @key{C-c C-x C-s}
426 @item @key{C-c C-x C-k}
427 Insert PGP (@ref{PGP}) public key. (It requires Mailcrypt package.)
429 @item @key{C-c C-x t}
430 Insert any single-part tag.
436 @node enclosure tags, other MIME-Edit operations, single-part tags, MIME-Edit
437 @section Operations for enclosure
439 Operations to make enclosure are following:
442 @item @key{C-c C-m C-a}
443 Enclose specified region as multipart/alternative.
445 @item @key{C-c C-x C-p}
446 Enclose specified region as multipart/parallel.
448 @item @key{C-c C-x C-m}
449 Enclose specified region as multipart/mixed.
451 @item @key{C-c C-x C-d}
452 Enclose specified region as multipart/digest.
454 @item @key{C-c C-x C-s}
455 Digital-sign to specified region. (cf. @ref{PGP})
457 @item @key{C-c C-x C-e}
458 Encrypt to specified region. (cf. @ref{PGP})
460 @item @key{C-c C-x C-q}
461 avoid to encode tags in specified region. In other words, tags is
462 interpreted as such string. (In current version, it may be
463 incomplete. Maybe PGP-signature does not work for this enclosure.)
469 @node other MIME-Edit operations, file-type specification, enclosure tags, MIME-Edit
470 @section Other operations
472 There are another operations in mime-edit-mode.
476 Send current editing message.
478 @item @key{C-c C-x p}
479 Preview current editing message. (cf. @ref{MIME-View})
481 @item @key{C-c C-x C-z}
482 Exit mime-edit-mode without sending.
484 @item @key{C-c C-x /}
485 Set current editing message to enable automatic splitting or not.
486 Form of automatic split messages is message/partial.
488 @item @key{C-c C-x 7}
489 Set 7bit (@ref{(mime-en)7bit}) to transfer level (@ref{transfer level}).
491 @item @key{C-c C-x 8}
492 Set 8bit (@ref{(mime-en)8bit}) to transfer level (@ref{transfer level}).
494 @item @key{C-c C-x v}
495 Set current editing message to digital-sign or not. (cf. @ref{PGP})
497 @item @key{C-c C-x h}
498 Set current editing message to encrypt or not. (cf. @ref{PGP})
500 @item @key{C-c C-x ?}
501 Display help message.
507 @node file-type specification, transfer level, other MIME-Edit operations, MIME-Edit
508 @section How to detect tag for inserted file
510 When @kbd{C-c C-x C-i} (@code{mime-edit-insert-file}) is pressed, tag
511 parameters for inserted file, such as media-type or encoding, are
512 detected by variable @code{mime-file-types}.@refill
514 When @kbd{C-u} is followed by it or parameter is not found from the
515 variable, it asks from user. (When @kbd{C-u} is followed by it,
516 detected value is used as default value)@refill
518 If you want to change default value for file names, please change
519 variable @code{mime-file-types}.
521 @defvar mime-file-types
523 Specification of default value of tag for file name of inserted
526 It is a list of following list:
529 (FILE_PAT TYPE SUBTYPE PARAMS ENCODING
530 DISPOSITION_TYPE DISPOSITION_PARAMS)
534 Each element of the list is following:
538 regular expression of file name
541 primary-type of media-type
544 subtype of media-type
547 parameters of Content-Type field
550 Content-Transfer-Encoding
552 @item DISPOSITION_TYPE
555 @item DISPOSITION_PARAMS
556 parameters of Content-Disposition field
561 Example: Specify application/rtf as default media type for
567 '(set-alist 'mime-file-types
569 '("application" "rtf" nil nil
570 "attachment" (("filename" . file)))
577 @node transfer level, , file-type specification, MIME-Edit
578 @section transfer level
579 @cindex transfer level
581 Each content inserted in a message is represented by 7bit
582 (@ref{(mime-en)7bit}), 8bit (@ref{(mime-en)8bit}) or binary
583 (@ref{(mime-en)binary}).@refill
585 If a message is translated by 7bit-through MTA (@ref{(mime-en)MTA}),
586 there is no need to encode 7bit data, but 8bit and binary data must be
587 encoded to 7bit data.@refill
589 Similarly, if a message is translated by 8bit-through MTA, there is no
590 need to encode 7bit or 8bit data, but binary data must be encoded to
591 7bit or 8bit data.@refill
596 EBCDIC MTA breaks 7bit data, so in this case, 7bit data must be
597 encoded by base64. But I don't know EBCDIC. (^_^;
599 Similarly, I wish ASCII-printable only MTA and code-conversion MTA
600 disappeared. (^_^;@refill
602 Maybe there are binary-through MTA, but I think it is not major.
605 @strong{transfer level} represents how range data are
606 available. mime-edit has a variable @code{mime-transfer-level}
607 to represent transfer level.
610 @defvar mime-transfer-level
612 transfer level.@refill
614 If transfer level of a data is over it, a data is encoded to
617 Currently, 7 or 8 is available. Default value is 7.@refill
619 In extension plan, EBCDIC will be 5, ASCII printable only will be 6,
620 binary will be 9. But it will not be implemented.
628 transfer level is only for body, not for message header (@ref{header}).
629 MIME extends RFC 822 (@ref{(mime-en)RFC 822}) to use 8bit data in body,
630 but it requires to use us-ascii (@ref{(mime-en)us-ascii}) in header.
635 @node Various, Concept Index, MIME-Edit, Top
636 @chapter Miscellaneous
641 * Buttons:: Mouse button
642 * Acting-condition configuration:: Utility for configuration
645 @node PGP, Buttons, Various, Various
650 mime-edit provides PGP encryption, signature and inserting public-key
651 features based on @strong{PGP/MIME} (RFC 2015) or @strong{PGP-kazu}
652 (draft-kazu-pgp-mime-00.txt).@refill
654 This feature requires pgp command and pgp interface package, such as
655 Mailcrypt package (@ref{(mailcrypt)}).
657 @defvar pgp-function-alist
659 Alist of service names vs. corresponding functions and its filenames.
660 Each element looks like @code{(SERVICE FUNCTION FILE)}.@refill
662 SERVICE is a symbol of PGP processing. It allows `verify', `decrypt',
663 `fetch-key', `snarf-keys', `mime-sign', `traditional-sign', `encrypt' or
666 Function is a symbol of function to do specified SERVICE.@refill
668 FILE is string of filename which has definition of corresponding
673 @defun pgp-function method
675 Return function to do service @var{method}.
680 @node Buttons, Acting-condition configuration, PGP, Various
681 @section Mouse button
683 @defvar mime-button-face
685 Face used for content-button or URL-button of MIME-Preview buffer.
689 @defvar mime-button-mouse-face
691 Face used for MIME-preview buffer mouse highlighting.
695 @defvar mime-browse-url-function
697 Function to browse URL.
702 @node Acting-condition configuration, , Buttons, Various
703 @section Utility for configuration
705 @defun mime-add-condition target-type condition &optional mode file
707 Add @var{condition} to database specified by @var{target-type}.@refill
709 @var{target-type} must be @code{preview} or @code{action}.@refill
711 If optional argument @var{mode} is @code{strict} or @code{nil}
712 (omitted), @var{condition} is added strictly.@refill
714 If optional argument @var{mode} is @code{with-default}, @var{condition}
715 is added with default rule.@refill
717 If optional argument @var{file} is specified, it is loaded when
718 @var{condition} is activate.
723 @node Concept Index, Function Index, Various, Top
724 @chapter Concept Index
728 @node Function Index, Variable Index, Concept Index, Top
729 @chapter Function Index
733 @node Variable Index, , Function Index, Top
734 @chapter Variable Index