annotate man/tm/tm-edit-en.texi @ 83:ba3ba6e17456

Added tag r20-0b91 for changeset 6a378aca36af
author cvs
date Mon, 13 Aug 2007 09:07:39 +0200
parents c0c698873ce1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
1 \input texinfo.tex
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
2 @setfilename tm-edit-en.info
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
3 @settitle{tm-edit 7.100 Reference Manual (English Version)}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
4 @titlepage
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
5 @title tm-edit 7.100 Reference Manual (English Version)
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
6 @author MORIOKA Tomohiko <morioka@@jaist.ac.jp>
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
7 @subtitle 1996/12/25
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
8 @end titlepage
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
9 @node Top, Introduction, (dir), (dir)
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
10 @top tm-edit 7.100 Reference Manual (English Version)
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
11
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
12 @ifinfo
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
13
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
14 This file documents tm-edit, a MIME composer for GNU Emacs.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
15 @end ifinfo
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
16
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
17 @menu
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
18 * Introduction:: What is tm-edit?
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
19 * mime/editor-mode::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
20 * single-part operations::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
21 * enclosure operation::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
22 * other operations of mime/editor-mode::
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
23 * tag specification for inserted file:: Default media-type or encoding for inserted file
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
24 * transfer level::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
25 * header:: Using non-ASCII characters in header
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
26 * PGP::
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
27 * Acknowledgments::
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
28 * Concept Index::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
29 * Function Index::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
30 * Variable Index::
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
31 @end menu
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
32
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
33 @node Introduction, mime/editor-mode, Top, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
34 @chapter What is tm-edit?
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
35 @cindex tm-edit
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
36
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
37 @strong{tm-edit} is a general MIME composer for GNU Emacs.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
38
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
39 tm-edit is based on mime.el by UMEDA Masanobu
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
40 <umerin@@mse.kyutech.ac.jp>, who is famous as the author of
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
41 GNUS. tm-edit expands following points from @file{mime.el}:
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
42
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
43 @itemize @bullet
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
44 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
45 based on RFC 1521/1522
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
46 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
47 Content-Disposition field (@ref{(tm-en)Content-Disposition}) (RFC 1806)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
48 supports
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
49 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
50 nested multi-part message (@ref{(tm-en)multipart})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
51 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
52 PGP (@ref{PGP}) (PGP/MIME (RFC 2015) based on security multipart (RFC
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
53 1847) and application/pgp based on traditional PGP)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
54 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
55 strength automatic specification for parameter of file type
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
56 @end itemize
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
57
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
58
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
59 In tm-MUA (@ref{(tm-en)tm-MUA}), you can edit MIME message easily to use
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
60 tm-edit.
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
61
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
62
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
63 @node mime/editor-mode, single-part operations, Introduction, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
64 @chapter mime/editor-mode
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
65 @cindex enclosure
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
66 @cindex multi-part ending tag
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
67 @cindex multi-part beginning tag
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
68 @cindex tag
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
69 @cindex mime/editor-mode
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
70
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
71 @strong{mime/editor-mode} is a minor mode to compose MIME message. In
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
72 this mode, @strong{tag} represents various kinds of data, you can edit
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
73 multi part (@ref{(tm-en)multipart}) message.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
74
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
75 There are 2 kinds of tags:
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
76
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
77 @itemize @bullet
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
78 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
79 single-part tag
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
80 @item
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
81 multi-part tag
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
82 @end itemize
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
83
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
84 single-part tag represents single part, this form is following:
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
85
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
86 @example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
87 --[[TYPE/SUBTYPE;PARAMETERS][ENCODING]
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
88 OPTIONAL-FIELDS]
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
89 @end example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
90
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
91 TYPE/SUBTYPE and PARAMETERS indicates type/subtype and parameters of
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
92 Content-Type field (@ref{(tm-en)Content-Type field}). TYPE/SUBTYPE is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
93 required, PARAMETERS is optional.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
94
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
95 ENCODING indicates Content-Transfer-Encoding field. It is optional
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
96 too.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
97
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
98 OPTIONAL-FIELDS is to represent another fields except Content-Type field
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
99 and Content-Transfer-Encoding field.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
100
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
101 multi-part tags represent multi part (@ref{(tm-en)multipart}). They
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
102 consist of a pair of @strong{multi-part beginning tag} and
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
103 @strong{multi-part ending tag}.@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
104
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
105 multi-part beginning tag's form is following:@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
106
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
107 @example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
108 --<<TYPE>>-@{
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
109 @end example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
110
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
111 multi-part ending tag's form is following:@refill
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
112
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
113 @example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
114 --@}-<<TYPE>>
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
115 @end example
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
116
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
117 A region from multi-part beginning tag to multi-part ending tag is
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
118 called as @strong{enclosure}.
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
119
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
120
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
121 @node single-part operations, enclosure operation, mime/editor-mode, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
122 @chapter single-part operations
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
123
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
124 Operations to make single-part are following:
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
125
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
126 @table @kbd
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
127 @item @key{C-c C-x C-t}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
128 Insert single-part tag indicates text part.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
129
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
130 @item @key{C-c C-x C-i}
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
131 Insert file as a MIME attachment. If @kbd{C-u} is followed by it, it
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
132 asks media-type, subtype or encoding even if their default values are
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
133 specified. (cf. @ref{tag specification for inserted file})
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
134
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
135 @item @key{C-c C-x C-e}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
136 Insert external part.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
137
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
138 @item @key{C-c C-x C-v}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
139 Record audio input until @kbd{C-g} is pressed, and insert as a
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
140 audio part. (It requires /dev/audio in default.)
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
141
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
142 @item @key{C-c C-x C-y}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
143 Insert current (mail or news) message. (It is MUA depended.)
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
144
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
145 @item @key{C-c C-x C-m}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
146 Insert mail message. (It is MUA depended.)
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
147
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
148 @item @key{C-c C-x C-w}, @key{C-c C-x C-s}
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
149 Insert signature.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
150
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
151 @item @key{C-c C-x C-k}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
152 Insert PGP (@ref{PGP}) public key. (It requires Mailcrypt package.)
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
153
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
154 @item @key{C-c C-x t}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
155 Insert any single-part tag.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
156
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
157 @end table
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
158
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
159
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
160
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
161 @node enclosure operation, other operations of mime/editor-mode, single-part operations, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
162 @chapter enclosure operation
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
163
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
164 Operations to make enclosure are following:
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
165
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
166 @table @kbd
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
167 @item @key{C-c C-x a}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
168 Enclose specified region as multipart/alternative.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
169
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
170 @item @key{C-c C-x p}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
171 Enclose specified region as multipart/parallel.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
172
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
173 @item @key{C-c C-x m}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
174 Enclose specified region as multipart/mixed.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
175
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
176 @item @key{C-c C-x d}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
177 Enclose specified region as multipart/digest.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
178
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
179 @item @key{C-c C-x s}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
180 Digital-sign to specified region. (cf. @ref{PGP})
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
181
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
182 @item @key{C-c C-x e}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
183 Encrypt to specified region. (cf. @ref{PGP})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
184
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
185 @item @key{C-c C-x q}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
186 avoid to encode tags in specified region. In other words, tags is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
187 interpreted as such string. (In current version, it may be
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
188 incomplete. Maybe PGP-signature does not work for this enclosure.)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
189
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
190 @end table
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
191
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
192
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
193
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
194 @node other operations of mime/editor-mode, tag specification for inserted file, enclosure operation, Top
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
195 @chapter other operations of mime/editor-mode
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
196
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
197 There are another operations in mime/editor-mode.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
198
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
199 @table @kbd
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
200 @item @key{C-c C-c}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
201 Send current editing message.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
202
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
203 @item @key{C-c C-x C-p}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
204 Preview current editing message. (@ref{(tm-view-en)mime/viewer-mode})
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
205
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
206 @item @key{C-c C-x C-z}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
207 Exit mime/editor-mode. (@key{M-x mime/edit-again} is available to
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
208 reedit.)
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
209
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
210 @item @key{C-c C-x ?}
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
211 Display help message.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
212
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
213 @item @key{C-c C-x /}
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
214 Set current editing message to enable automatic splitting or not.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
215 Form of automatic split messages is message/partial.
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
216
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
217 @item @key{C-c C-x 7}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
218 Set 7bit (@ref{(tm-en)7bit}) to transfer level (@ref{transfer level}).
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
219
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
220 @item @key{C-c C-x 8}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
221 Set 8bit (@ref{(tm-en)8bit}) to transfer level (@ref{transfer level}).
10
49a24b4fd526 Import from CVS: tag r19-15b6
cvs
parents: 8
diff changeset
222
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
223 @item @key{C-c C-x v}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
224 Set current editing message to digital-sign or not. (cf. @ref{PGP})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
225
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
226 @item @key{C-c C-x h}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
227 Set current editing message to encrypt or not. (cf. @ref{PGP})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
228
10
49a24b4fd526 Import from CVS: tag r19-15b6
cvs
parents: 8
diff changeset
229 @end table
49a24b4fd526 Import from CVS: tag r19-15b6
cvs
parents: 8
diff changeset
230
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
231
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
232
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
233 @node tag specification for inserted file, transfer level, other operations of mime/editor-mode, Top
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
234 @chapter Default media-type or encoding for inserted file
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
235
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
236 When @kbd{C-c C-x C-i} (@code{mime-editor/insert-file}) is pressed, tag
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
237 parameters for inserted file, such as media-type or encoding, are
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
238 detected by variable @code{mime-file-types}.@refill
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
239
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
240 When @kbd{C-u} is followed by it or parameter is not found from the
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
241 variable, it asks from user. (When @kbd{C-u} is followed by it,
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
242 detected value is used as default value)@refill
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
243
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
244 If you want to change default value for file names, please change
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
245 variable @code{mime-file-types}.
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
246
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
247
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
248 @defvar mime-file-types
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
249
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
250 Specification of default value of tag for file name of inserted
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
251 file.@refill
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
252
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
253 It is a list of following list:
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
254
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
255 @lisp
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
256 (FILE_PAT TYPE SUBTYPE PARAMS ENCODING
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
257 DISPOSITION_TYPE DISPOSITION_PARAMS)
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
258 @end lisp
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
259
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
260
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
261 Each elements of the list are following:
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
262
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
263 @table @samp
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
264 @item FILE_PAT
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
265 regular expression of file name
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
266
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
267 @item TYPE
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
268 media type
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
269
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
270 @item SUBTYPE
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
271 media subtype
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
272
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
273 @item PARAMS
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
274 parameters of Content-Type field
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
275
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
276 @item ENCODING
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
277 Content-Transfer-Encoding
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
278
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
279 @item DISPOSITION_TYPE
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
280 disposition-type
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
281
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
282 @item DISPOSITION_PARAMS
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
283 parameters of Content-Disposition field
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
284
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
285 @end table
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
286
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
287 @noindent
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
288 Example: Specify application/rtf as default media type for
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
289 @file{*.rtf}
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
290
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
291 @lisp
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
292 (call-after-loaded
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
293 'tm-edit
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
294 (lambda ()
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
295 (set-alist 'mime-file-types
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
296 "\\.rtf$"
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
297 '("application" "rtf" nil nil
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
298 "attachment" (("filename" . file)))
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
299 )))
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
300 @end lisp
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
301 @end defvar
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
302
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
303
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
304
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
305 @node transfer level, header, tag specification for inserted file, Top
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
306 @chapter transfer level
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
307 @cindex transfer level
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
308
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
309 Contents inserted in a message are represented by 7bit
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
310 (@ref{(tm-en)7bit}), 8bit (@ref{(tm-en)8bit}) or binary
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
311 (@ref{(tm-en)binary}).@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
312
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
313 If a message is translated by 7bit-through MTA (@ref{(tm-en)MTA}), there
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
314 is no need to encode 7bit data, but 8bit and binary data must be encoded
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
315 to 7bit data.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
316
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
317 Similarly, if a message is translated by 8bit-through MTA, there is no
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
318 need to encode 7bit or 8bit data, but binary data must be encoded to
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
319 7bit or 8bit data.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
320
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
321 @noindent
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
322 @strong{[Memo]}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
323 @quotation
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
324 EBCDIC MTA breaks 7bit data, so in this case, 7bit data must be
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
325 encoded by base64. But I don't know EBCDIC. (^_^;
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
326
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
327 Similarly, I wish ASCII-printable only MTA and code-conversion MTA
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
328 disappeared. (^_^;@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
329
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
330 Maybe there are binary-through MTA, but I think it is not major.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
331 @end quotation
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
332
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
333 @strong{transfer level} represents how range data is
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
334 available. tm-edit has a variable
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
335 @code{mime-editor/transfer-level} to represent transfer level.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
336
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
337
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
338 @defvar mime-editor/transfer-level
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
339
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
340 transfer level.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
341
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
342 If transfer level of a data is over it, a data is encoded to
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
343 7bit.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
344
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
345 Currently, 7 or 8 is available. Default value is 7.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
346
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
347 In extension plan, EBCDIC will be 5, ASCII printable only will be 6,
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
348 binary will be 9. But it will not be implemented.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
349 @end defvar
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
350
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
351
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
352
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
353 @noindent
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
354 @strong{[Memo]}
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
355 @quotation
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
356 transfer level is only for body, not for header (@ref{header}). RFC
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
357 1521 extends RFC 822 (@ref{(tm-en)RFC 822}) to use 8bit data in body,
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
358 but it requires to use us-ascii (@ref{(tm-en)us-ascii}) in header.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
359 @end quotation
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
360
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
361
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
362
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
363 @node header, PGP, transfer level, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
364 @chapter Using non-ASCII characters in header
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
365 @cindex encoded-word
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
366
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
367 RFC 1522 (@ref{(tm-en)RFC 1522}) defines representation of non-ASCII
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
368 characters in header.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
369
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
370 It is a format called as @strong{encoded-word}
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
371 (@ref{(tm-en)encoded-word}), it is available to represent every
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
372 non-ASCII characters by 7bit (@ref{(tm-en)7bit}) to declare MIME charset
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
373 (@ref{(tm-en)MIME charset}).
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
374
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
375
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
376 @menu
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
377 * evil setting in header:: If you can not allow encoded-word
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
378 * API about header:: Functions and variables about header
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
379 @end menu
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
380
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
381 @node evil setting in header, API about header, header, header
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
382 @section If you can not allow encoded-word
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
383
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
384 It is wrong to use ``raw'' non-ASCII characters in header not to use
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
385 encoded-word. Because there are various kinds of coded character set
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
386 (@ref{(tm-en)Coded character set}) in the Internet, so we can not
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
387 distinguish them if MIME charset (@ref{(tm-en)MIME charset}) is not
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
388 declared.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
389
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
390 For example, we can not distinguish iso-8859-1 (@ref{(tm-en)iso-8859-1})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
391 and iso-8859-2 (@ref{(tm-en)iso-8859-2}) if MIME charset is not
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
392 declared.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
393
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
394 However you can not permit to use encoded-word, please set to
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
395 following variables:
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
396
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
397
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
398 @defvar mime/field-encoding-method-alist
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
399
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
400 Association-list to specify field encoding method. Its key is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
401 field-name, value is encoding method.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
402
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
403 field-name allows string or @code{t} meaning any fields.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
404
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
405 Encoding method allows following: @code{nil} means no-conversion,
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
406 @code{mime} means to convert as encoded-word, symbol represent MIME
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
407 charset means to convert as the coded character set instead of to
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
408 convert as encoded-word.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
409
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
410 field-name is searched from string. If it is not found, @code{t} is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
411 used.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
412
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
413 Default value of @code{mime/field-encoding-method-alist} is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
414 following:
8
4b173ad71786 Import from CVS: tag r19-15b5
cvs
parents:
diff changeset
415
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
416 @lisp
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
417 (("X-Nsubject" . iso-2022-jp-2)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
418 ("Newsgroups" . nil)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
419 (t . mime)
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
420 ))
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
421 @end lisp
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
422 @end defvar
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
423
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
424
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
425 In addition, if you want to specify by coded character set instead of
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
426 field, please use @code{mime-eword/charset-encoding-alist}.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
427 (cf. @ref{API about header})
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
428
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
429
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
430
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
431 @node API about header, , evil setting in header, header
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
432 @section Functions and variables about header
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
433
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
434 @deffn{Command} mime/encode-message-header &optional code-conversion
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
435
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
436 It translate non-ASCII characters in message header of current buffer
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
437 into network representation, such as encoded-words.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
438
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
439 If @var{code-conversion} is non-@code{nil}, field not encoded by
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
440 encoded-word is converted by @code{mime/field-encoding-method-alist}.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
441 @end deffn
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
442
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
443
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
444 @defun mime/encode-field string
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
445
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
446 It encodes @var{string} into encoded-words as a field.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
447
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
448 Long lines are folded.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
449 @end defun
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
450
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
451
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
452 @defun mime-eword/encode-string string &optional column mode
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
453
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
454 It encodes @var{string} into encoded-words.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
455
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
456 Long lines are folded.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
457
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
458 @var{column} specifies start column. If it is omitted, 0 is
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
459 used.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
460
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
461 @var{mode} specifies where @var{string} is in. Available values are
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
462 @code{text}, @code{comment}, @code{phrase}. If it is omitted,
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
463 @code{phrase} is used.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
464 @end defun
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
465
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
466
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
467 @defvar mime-eword/charset-encoding-alist
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
468
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
469 Association-list of symbol represent MIME charset vs. nil, @code{"B"} or
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
470 @code{"Q"}.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
471
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
472 @code{nil} means not to encode as encoded-word. @code{"B"} means to use
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
473 B-encoding. @code{"Q"} means to use Q-encoding.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
474 @end defvar
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
475
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
476
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
477
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
478 @node PGP, Acknowledgments, header, Top
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
479 @chapter PGP
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
480 @cindex PGP-kazu
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
481 @cindex PGP/MIME
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
482
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
483 tm-edit provides PGP encryption, signature and inserting public-key
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
484 features based on @strong{PGP/MIME} (@ref{(tm-en)PGP/MIME}) (RFC 2015)
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
485 or @strong{PGP-kazu} (@ref{(tm-en)PGP-kazu})
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
486 (draft-kazu-pgp-mime-00.txt).@refill
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
487
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
488 This feature requires pgp command and Mailcrypt package
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
489 (@ref{(mailcrypt)}).@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
490
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
491 If you want to use this feature, please set @code{pgp-elkins} or
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
492 @code{pgp-kazu} to variable @code{mimed-editor/signing-type} and
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
493 variable @code{mime-editor/encrypting-type}.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
494
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
495 If @code{pgp-elkins} is specified, PGP/MIME is used. If
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
496 @code{pgp-kazu} is specified, PGP-kazu is used.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
497
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
498
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
499 @defvar mime-editor/signing-type
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
500
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
501 Format of PGP signature.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
502
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
503 It allows @code{pgp-elkins} or @code{pgp-kazu}.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
504
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
505 Default value is @code{nil}.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
506 @end defvar
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
507
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
508
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
509 @defvar mime-editor/encrypting-type
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
510
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
511 Format of PGP encryption.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
512
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
513 It allows @code{pgp-elkins} or @code{pgp-kazu}.@refill
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
514
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
515 Default value is @code{nil}.
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
516 @end defvar
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
517
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
518
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
519
76
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
520 @node Acknowledgments, Concept Index, PGP, Top
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
521 @chapter Acknowledgments
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
522
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
523 First of all, I thank UMEDA Masanobu for his work of @file{mime.el},
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
524 which is the origin of tm-edit, and permission to rewrite his work as
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
525 tm-edit.@refill
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
526
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
527 I thank members of two tm mailing lists, Japanese and English version.
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
528
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
529
c0c698873ce1 Import from CVS: tag r20-0b33
cvs
parents: 74
diff changeset
530 @node Concept Index, Function Index, Acknowledgments, Top
74
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
531 @chapter Concept Index
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
532
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
533 @printindex cp
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
534
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
535 @node Function Index, Variable Index, Concept Index, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
536 @chapter Function Index
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
537
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
538 @printindex fn
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
539
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
540 @node Variable Index, , Function Index, Top
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
541 @chapter Variable Index
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
542
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
543 @printindex vr
54cc21c15cbb Import from CVS: tag r20-0b32
cvs
parents: 70
diff changeset
544 @bye