|
76
|
1 \input texinfo.tex
|
|
|
2 @c %**start of header
|
|
78
|
3 @setfilename tm-vm-en.info
|
|
76
|
4 @settitle tm-vm Manual (English Version)
|
|
|
5 @c %**end of header
|
|
|
6
|
|
|
7 @ifinfo
|
|
|
8 This file documents tm-vm.el v7.79.
|
|
|
9
|
|
|
10 tm-vm is part of the TM Package.
|
|
|
11
|
|
|
12 tm-vm is an interface between tm and the VM mail user agent that lets
|
|
|
13 you read and write multimedia mail on the Internet using the MIME
|
|
|
14 standard.
|
|
|
15
|
|
|
16 tm-vm and its documentation are distributed under the same terms as
|
|
|
17 TM. Please refer to the TM Manual.
|
|
|
18
|
|
|
19 Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
|
|
|
20
|
|
|
21 @end ifinfo
|
|
|
22
|
|
|
23
|
|
|
24
|
|
|
25
|
|
|
26 @titlepage
|
|
|
27 @title tm-vm Manual (English Version)
|
|
|
28 @author by Oscar Figueiredo
|
|
80
|
29 @code{$Id: tm-vm-en.texi,v 1.3 1997/01/11 20:14:34 steve Exp $}
|
|
76
|
30 @page
|
|
|
31
|
|
|
32 tm-vm is part of the TM Package.
|
|
|
33
|
|
|
34 tm-vm and its documentation are distributed under the same terms as
|
|
|
35 TM. Please refer to the TM Manual.
|
|
|
36
|
|
|
37 Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
|
|
|
38 @end titlepage
|
|
|
39
|
|
|
40
|
|
|
41
|
|
|
42
|
|
|
43
|
|
|
44 @node Top, Overview, (dir), (dir)
|
|
|
45 @ifinfo
|
|
|
46 @chapter tm-vm Manual
|
|
|
47 tm-vm is an interface between tm and the VM mail user agent that lets
|
|
|
48 you read and write multimedia mail on the Internet using the MIME
|
|
|
49 standard.
|
|
|
50
|
|
|
51 This document applies to release 7.79 of tm-vm.el
|
|
|
52 @end ifinfo
|
|
|
53
|
|
|
54 @menu
|
|
|
55 * Overview:: Reading and writing MIME mail in VM
|
|
|
56 * Install:: Installation procedure
|
|
|
57 * Usage:: Detailed usage of tm-vm
|
|
|
58 * Customization:: How to customize tm-vm behavior.
|
|
78
|
59 * News:: Recent modifications
|
|
76
|
60 * Copyright::
|
|
|
61 * Variable Index::
|
|
|
62 * Concept Index::
|
|
|
63 @end menu
|
|
|
64
|
|
|
65
|
|
|
66
|
|
|
67
|
|
|
68
|
|
|
69 @node Overview, Install, Top, Top
|
|
|
70 @chapter Overview
|
|
|
71
|
|
80
|
72 tm-vm is an interface between TM (@pxref{Top,TM,,tm-en,TM Manual}.) and the VM
|
|
|
73 mail user agent (@pxref{Top,VM,,vm,VM Manual}.).
|
|
76
|
74
|
|
|
75 In its current version VM does not provide functionality to support the
|
|
|
76 MIME standard. tm-vm integrates the TM package into VM so as to give you
|
|
|
77 a powerful MIME support in your usual mail environment for both mail
|
|
|
78 reading and composing.
|
|
|
79
|
|
|
80 @section Mail Reading Features
|
|
|
81
|
|
80
|
82 tm-vm tries to integrate as transparently as possible with VM so that
|
|
|
83 MIME messages appear to you just like plain messages.
|
|
76
|
84
|
|
|
85 tm-vm detects MIME messages when you try to view them and, if automatic
|
|
|
86 MIME previewing is enabled (the default), then it automatically parses
|
|
|
87 the message and displays a "beautified" version under the MIME Viewer.
|
|
|
88
|
|
|
89 The MIME Viewer offers all the functionality to view/extract the MIME
|
|
|
90 components (attachments) of the message. It also displays images inline
|
|
|
91 in XEmacs. @xref{tm-view,,MIME Viewer tm-view,tm-en,TM Manual}.
|
|
|
92
|
|
|
93 @section Mail Composing Features
|
|
|
94
|
|
|
95 Composing a new message places you in a compose buffer as usual under VM
|
|
|
96 but a special minor mode (@samp{mime-editor}) is made available that
|
|
|
97 lets you perform such operations as:
|
|
|
98
|
|
|
99 @itemize @bullet
|
|
|
100 @item
|
|
|
101 Insert arbitrary files
|
|
|
102 @item
|
|
|
103 Insert another message
|
|
|
104 @item
|
|
80
|
105 Insert a voice sample recorded from a microphone attached to the computer
|
|
76
|
106 @item
|
|
|
107 Enclose message sections as PGP encrypted
|
|
|
108 @end itemize
|
|
|
109
|
|
80
|
110 and much more. For details, @pxref{tm-edit,,MIME Editor,tm-en,TM Manual}.
|
|
76
|
111
|
|
|
112 When you reply to a message citing the original and tm-vm is active,
|
|
|
113 tm-vm will insert the contents of the MIME-Preview buffer in the reply
|
|
80
|
114 buffer. You can also insert the raw message if you want (@pxref{Usage}).
|
|
76
|
115
|
|
|
116
|
|
|
117
|
|
|
118
|
|
|
119
|
|
|
120 @node Install, Usage, Overview, Top
|
|
|
121 @chapter Installing tm-vm
|
|
|
122
|
|
|
123 To take advantage of the benefits of tm-vm, you need to have VM and tm
|
|
|
124 already installed.
|
|
|
125
|
|
80
|
126 VM is part of XEmacs distributions and so if you're running XEmacs you
|
|
76
|
127 don't need to install it. If you're running Emacs, you will need to
|
|
80
|
128 install VM. The official VM distribution site is
|
|
|
129 @file{ftp://ftp.uu.net/networking/mail/vm/}.
|
|
76
|
130
|
|
|
131 If you're reading this manual then there is a pretty good chance you
|
|
80
|
132 already have a recent version of tm. The official tm distribution site
|
|
|
133 is @file{ftp://ftp.jaist.ac.jp/pub/GNU/mime/}. Follow the installation
|
|
|
134 procedure for tm as described in the documentation.
|
|
76
|
135
|
|
80
|
136 Once these steps are completed, tm-vm installation is very simple. You
|
|
76
|
137 just need to insert the following lines in your VM configuration file
|
|
80
|
138 (generally @file{.vm}):
|
|
76
|
139
|
|
|
140 @lisp
|
|
|
141 (require 'mime-setup)
|
|
|
142 (require 'tm-vm)
|
|
|
143 @end lisp
|
|
|
144
|
|
|
145 That's it. You are ready to read and send multimedia mail! You may also
|
|
80
|
146 want to customize some aspects of tm-vm behaviour (@pxref{Customization}).
|
|
76
|
147
|
|
80
|
148 If you use BBDB, you must load tm-vm @strong{after} BBDB. Please be sure
|
|
76
|
149 to respect the following sequence in your initialization file:
|
|
|
150
|
|
|
151 @lisp
|
|
|
152 (bbdb-insinuate-vm)
|
|
|
153 (require 'tm-vm)
|
|
|
154 @end lisp
|
|
|
155
|
|
|
156
|
|
|
157
|
|
|
158
|
|
|
159
|
|
|
160 @node Usage, Customization, Install, Top
|
|
|
161 @chapter Using tm-vm
|
|
|
162
|
|
|
163
|
|
|
164 @menu
|
|
|
165 * Reading MIME mail:: Commands for MIME previewing
|
|
|
166 * Composing MIME mail:: Writing/Replying to/Forwarding MIME messages
|
|
|
167 * Printing:: Printing MIME messages
|
|
|
168 * Using BBDB:: BBDB integration
|
|
|
169 @end menu
|
|
|
170
|
|
|
171
|
|
|
172 @node Reading MIME mail, Composing MIME mail, Usage, Usage
|
|
|
173 @section Reading MIME mail
|
|
|
174
|
|
|
175 When reading mail, tm-vm can operate in two different modes:
|
|
|
176 @emph{automatic preview} and @emph{on-demand preview}. In automatic
|
|
|
177 preview mode (the default) MIME messages are automatically decoded. In
|
|
|
178 on-demand preview mode all messages are presented by VM as they are (as
|
|
|
179 if tm were not loaded). The user can request the decoding of a message
|
|
|
180 at any time with @code{tm-vm/view-message} (bound to @kbd{Z}).
|
|
|
181
|
|
|
182
|
|
|
183 @subsection VM folder buffer and MIME Preview buffer
|
|
|
184
|
|
|
185 Though tm-vm tries to hide this fact as much as possible, it is
|
|
|
186 important to note that when MIME previewing is enabled the current
|
|
|
187 message actually exists in @strong{two} separate buffers:
|
|
|
188
|
|
|
189 @itemize @bullet
|
|
|
190
|
|
|
191 @item
|
|
|
192 @cindex VM folder buffer
|
|
|
193 @emph{the VM folder buffer}: always displays the @strong{raw} message
|
|
|
194 buffer where the MIME contents remain unparsed
|
|
|
195
|
|
|
196 @item
|
|
|
197 @cindex MIME Preview buffer
|
|
|
198 @emph{the MIME Preview buffer}: displays a MIME parsed version of the
|
|
80
|
199 message. It is generally what you want to see as it is more readable.
|
|
76
|
200 @end itemize
|
|
|
201
|
|
80
|
202 There are two different buffers due to the current VM implementation
|
|
|
203 that makes TM/VM integration difficult. However, we try hard to make the
|
|
|
204 MIME Preview buffer act as if it were the real VM message buffer by
|
|
|
205 making all bindings act the same in the Preview buffer as in the folder
|
|
|
206 buffer.
|
|
76
|
207
|
|
|
208
|
|
|
209 @code{tm-vm/toggle-preview-mode} (bound to @kbd{M-t}) lets you toggle
|
|
|
210 between automatic and on-demand preview modes.
|
|
|
211
|
|
|
212
|
|
|
213 @node Composing MIME mail, Printing, Reading MIME mail, Usage
|
|
|
214 @section Composing MIME mail
|
|
|
215
|
|
80
|
216 Regardless of the current preview mode, tm-vm activates the mime-editor
|
|
|
217 mode each time you compose a mail message (new message, reply or
|
|
|
218 forward). @xref{tm-edit,,MIME Editor,tm-en,TM Manual}, for details on
|
|
|
219 mime-editor mode.
|
|
76
|
220
|
|
80
|
221 When you reply to a message, tm-vm will insert the contents of the
|
|
76
|
222 @strong{decoded} message if there exists a MIME Preview buffer. This is
|
|
80
|
223 generally what you want for quoted-printable text, for instance. Inline
|
|
76
|
224 images are removed from the reply. If for some reason you want the
|
|
|
225 @strong{raw} message to be inserted instead of the decoded one you have
|
|
|
226 to kill the MIME Preview buffer first. You do this with
|
|
|
227 @code{kill-buffer} (bound to @kbd{C-x k}) in the MIME Preview
|
|
80
|
228 buffer. You can also toggle automatic preview off, if it was on, with
|
|
76
|
229 @kbd{M-t}.
|
|
|
230
|
|
80
|
231 Forwarding a message always inserts the raw message with its own MIME
|
|
|
232 headers. The recipient will thus receive exactly the same message as you
|
|
|
233 did.
|
|
76
|
234
|
|
|
235
|
|
|
236
|
|
|
237 @node Printing, Using BBDB, Composing MIME mail, Usage
|
|
|
238 @section Printing MIME messages
|
|
|
239
|
|
|
240 For non-MULE Emacses, printing of MIME messages uses Postscript printing
|
|
|
241 (through the ps-print package). Non-MIME messages are printed the usual
|
|
|
242 way as configured in VM. This is controlled by the variable
|
|
|
243 @code{tm-vm/use-ps-print}.
|
|
|
244
|
|
|
245
|
|
|
246 @node Using BBDB, , Printing, Usage
|
|
|
247 @section Notes about BBDB Usage
|
|
|
248
|
|
|
249 BBDB, the Big Brother's Database, should operate normally with
|
|
80
|
250 VM/tm-vm. You must ensure, however, that tm-vm is loaded @strong{after}
|
|
76
|
251 BBDB has installed its hooks. Therefore be sure to respect the following
|
|
|
252 sequence in your initialization file:
|
|
|
253 @lisp
|
|
|
254 (bbdb-insinuate-vm)
|
|
|
255 (require 'tm-vm)
|
|
|
256 @end lisp
|
|
|
257
|
|
|
258
|
|
|
259
|
|
|
260
|
|
78
|
261 @node Customization, News, Usage, Top
|
|
76
|
262 @chapter Customization
|
|
|
263
|
|
|
264 Several variables let you adapt the behavior of tm-vm to your needs. You
|
|
80
|
265 can set these variables to the appropriate value in your initialization
|
|
76
|
266 file prior to loading tm.
|
|
|
267
|
|
|
268
|
|
|
269 @defopt tm-vm/automatic-mime-preview
|
|
80
|
270 If non-@code{nil} then tm-vm will start in automatic mime preview mode
|
|
|
271 (@pxref{Usage}). Default @code{t}.
|
|
76
|
272 @end defopt
|
|
|
273
|
|
|
274 @defopt tm-vm/strict-mime
|
|
80
|
275 If non-@code{nil} tm-vm will automatically decode MIME messages
|
|
|
276 only. MIME messages have a @code{MIME-Version} header. If @code{nil}
|
|
|
277 then all messages will be decoded and viewed in the MIME Preview buffer
|
|
|
278 regardless of the existence of a @code{MIME-Version} header. Default
|
|
|
279 @code{t}.
|
|
76
|
280 @end defopt
|
|
|
281
|
|
|
282 @defopt tm-vm/use-xemacs-popup-menu
|
|
80
|
283 If this is non-@code{nil} and you're running XEmacs, tm-vm will install a
|
|
76
|
284 menu of MIME commands as a mode popup (@key{Button 3}) in message
|
|
80
|
285 composition buffers. Default @code{t}.
|
|
76
|
286 @end defopt
|
|
|
287
|
|
|
288 @defopt tm-vm/use-ps-print
|
|
80
|
289 If this is non-@code{nil} then MIME messages will be printed in
|
|
|
290 Postscript using the ps-print package. By default it is @code{t} for
|
|
|
291 non-MULE Emacses.
|
|
76
|
292 @end defopt
|
|
|
293
|
|
|
294 @defvar tm-vm/select-message-hook
|
|
|
295 tm-vm runs the hooks in this list after selecting a message. You can
|
|
|
296 attach your own hook functions using @code{add-hook}.
|
|
|
297 @end defvar
|
|
|
298
|
|
|
299 @defvar tm-vm/forward-message-hook
|
|
|
300 tm-vm runs the hooks in this list after a Mail mode buffer has been
|
|
|
301 created to forward a message in message/rfc822 type format.
|
|
|
302 If @code{vm-forwarding-digest-type} is @samp{rfc1521}, tm-vm runs this
|
|
|
303 hook instead of @code{vm-forward-message-hook}.
|
|
|
304 @end defvar
|
|
|
305
|
|
|
306 @defvar tm-vm/send-digest-hook
|
|
|
307 tm-vm runs the hooks in this list after a Mail mode buffer has been
|
|
|
308 created to send a digest in multipart/digest type format.
|
|
|
309 If @code{vm-digest-send-type} is @samp{rfc1521}, tm-vm runs this hook
|
|
80
|
310 instead of @code{vm-send-digest-hook}.
|
|
76
|
311 @end defvar
|
|
|
312
|
|
|
313 @section X-Faces
|
|
|
314 @cindex X-Faces
|
|
|
315 tm-vm displays X-Faces inline for XEmacs users in the same way as
|
|
|
316 VM. X-Faces are turned on by default. You need to disable their display
|
|
|
317 explicitly if you want to:
|
|
|
318
|
|
|
319 @lisp
|
|
|
320 (setq vm-use-lucid-highlighting nil)
|
|
|
321 (setq vm-display-xfaces nil)
|
|
|
322 @end lisp
|
|
|
323
|
|
|
324
|
|
78
|
325 @node News, Copyright, Customization, Top
|
|
|
326 @chapter News
|
|
76
|
327
|
|
|
328 This section documents the changes in the latest releases of tm-vm.
|
|
|
329
|
|
|
330 @section 7.79
|
|
|
331
|
|
|
332 @itemize @bullet
|
|
|
333 @item
|
|
|
334 Minor bug fixes.
|
|
|
335 @end itemize
|
|
|
336
|
|
|
337 @section 7.78
|
|
|
338
|
|
|
339 @itemize @bullet
|
|
|
340 @item
|
|
|
341 Better compatibility with MULE in respect of the ps-print package
|
|
|
342 @end itemize
|
|
|
343
|
|
|
344
|
|
|
345 @section 7.77
|
|
|
346
|
|
|
347 @itemize @bullet
|
|
|
348 @item
|
|
|
349 A bug in byte-compilation introduced in 7.76 was fixed
|
|
|
350 @item
|
|
|
351 Window configurations are restored more correctly (point stays where it
|
|
|
352 should :-) when paging through messages.
|
|
|
353 @end itemize
|
|
|
354
|
|
|
355
|
|
|
356 @section 7.76
|
|
|
357
|
|
|
358 @itemize @bullet
|
|
|
359 @item
|
|
|
360 Forwarding a MIME message now always forwards the @strong{raw} message.
|
|
|
361 @item
|
|
|
362 Forwarding a message from the @samp{Dispose} pull-down menu now works
|
|
|
363 correctly in XEmacs. Untested in Emacs.
|
|
|
364 @item
|
|
|
365 Forwarding a message when the current buffer is the MIME-Preview buffer
|
|
|
366 now works correctly
|
|
|
367 @item
|
|
|
368 @code{tm-vm/use-ps-print} was introduced @pxref{Customization}.
|
|
|
369
|
|
|
370 @end itemize
|
|
|
371
|
|
|
372
|
|
|
373 @section 7.75
|
|
|
374
|
|
|
375 @itemize @bullet
|
|
|
376 @item
|
|
|
377 Bug fixes: BBDB record creation and MIME component extraction from new
|
|
|
378 messages
|
|
|
379
|
|
|
380 @end itemize
|
|
|
381
|
|
|
382
|
|
|
383 @section 7.74
|
|
|
384
|
|
|
385 @itemize @bullet
|
|
|
386 @item
|
|
|
387 X-Faces are displayed by default. @pxref{Customization}
|
|
|
388 @end itemize
|
|
|
389
|
|
|
390
|
|
|
391
|
|
|
392
|
|
|
393
|
|
|
394
|
|
78
|
395 @node Copyright, Variable Index, News, Top
|
|
76
|
396 @ifinfo
|
|
|
397 @chapter Copyright
|
|
|
398
|
|
|
399 This file documents tm-vm 7.76, an interface between tm and the VM mail
|
|
|
400 user agent.
|
|
|
401
|
|
|
402 Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
|
|
|
403
|
|
|
404 tm-vm is part of the TM package. tm-vm and its documentation are
|
|
|
405 distributed under the same terms as TM itself
|
|
|
406 @xref{Copyright, Copyright, tm-en, TM}.
|
|
|
407 @end ifinfo
|
|
|
408
|
|
|
409
|
|
|
410 @node Variable Index, Concept Index, Copyright, Top
|
|
|
411 @unnumbered Variable Index
|
|
|
412
|
|
|
413 @printindex vr
|
|
|
414
|
|
|
415 @node Concept Index, , Variable Index, Top
|
|
|
416 @unnumbered Concept Index
|
|
|
417
|
|
|
418 @printindex cp
|
|
|
419
|
|
|
420 @contents
|
|
|
421 @bye
|
