annotate man/tm/tm-edit-en.texi @ 10:49a24b4fd526 r19-15b6

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