|
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
|
|
146
|
8 This file documents tm-vm.el v8.12
|
|
76
|
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
|
|
146
|
29 @code{$Id: tm-vm-en.texi,v 1.5 1997/05/14 02:01:53 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
|
|
146
|
51 This document applies to release 8.12 of tm-vm.el
|
|
76
|
52 @end ifinfo
|
|
|
53
|
|
|
54 @menu
|
|
124
|
55 * Overview::
|
|
|
56 * Install::
|
|
|
57 * Usage::
|
|
|
58 * Customization::
|
|
|
59 * News::
|
|
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
|
|
124
|
75 Until recently VM did not support the MIME standard. Kyle Jones has
|
|
|
76 begun to implement it in VM 6.0 however TM provides a much more complete
|
|
|
77 support of MIME than the one currently offered in VM 6. tm-vm integrates
|
|
|
78 the TM package into VM so as to give you a powerful MIME support in your
|
|
|
79 usual mail environment for both mail reading and composing. tm-vm adds
|
|
|
80 MIME features to VM 5 and replaces the native features offered by VM 6.
|
|
76
|
81
|
|
|
82 @section Mail Reading Features
|
|
|
83
|
|
80
|
84 tm-vm tries to integrate as transparently as possible with VM so that
|
|
|
85 MIME messages appear to you just like plain messages.
|
|
76
|
86
|
|
|
87 tm-vm detects MIME messages when you try to view them and, if automatic
|
|
|
88 MIME previewing is enabled (the default), then it automatically parses
|
|
|
89 the message and displays a "beautified" version under the MIME Viewer.
|
|
124
|
90 Note that the word @emph{previewing} has two different meanings for VM and
|
|
|
91 TM. In VM, it means view the first lines of a message only, as defined by
|
|
|
92 the variable @code{vm-preview-lines}, to avoid confusion we call this
|
|
|
93 @emph{message previewing}. In TM, previewing means parsing the contents
|
|
|
94 of a message according to the rules of the MIME standard and display a
|
|
|
95 corresponding view of it. We call that more specifically @emph{MIME
|
|
|
96 previewing}.
|
|
76
|
97
|
|
|
98 The MIME Viewer offers all the functionality to view/extract the MIME
|
|
|
99 components (attachments) of the message. It also displays images inline
|
|
124
|
100 in XEmacs. @xref{Top,MIME Viewer,MIME Viewer,tm-view-en,TM View
|
|
|
101 Manual}. Note however that for a better VM integration, tm-vm
|
|
|
102 overrides the standard bindings of the MIME-Viewer and makes them
|
|
|
103 available with a @key{C-c} prefix.
|
|
76
|
104
|
|
|
105 @section Mail Composing Features
|
|
|
106
|
|
|
107 Composing a new message places you in a compose buffer as usual under VM
|
|
|
108 but a special minor mode (@samp{mime-editor}) is made available that
|
|
|
109 lets you perform such operations as:
|
|
|
110
|
|
|
111 @itemize @bullet
|
|
|
112 @item
|
|
|
113 Insert arbitrary files
|
|
|
114 @item
|
|
|
115 Insert another message
|
|
|
116 @item
|
|
80
|
117 Insert a voice sample recorded from a microphone attached to the computer
|
|
76
|
118 @item
|
|
|
119 Enclose message sections as PGP encrypted
|
|
|
120 @end itemize
|
|
|
121
|
|
124
|
122 and much more. For details, @pxref{Top,MIME Editor,MIME
|
|
|
123 Editor,tm-edit-en,TM Edit Manual}.
|
|
76
|
124
|
|
|
125 When you reply to a message citing the original and tm-vm is active,
|
|
|
126 tm-vm will insert the contents of the MIME-Preview buffer in the reply
|
|
80
|
127 buffer. You can also insert the raw message if you want (@pxref{Usage}).
|
|
76
|
128
|
|
|
129
|
|
|
130
|
|
|
131
|
|
|
132
|
|
|
133 @node Install, Usage, Overview, Top
|
|
|
134 @chapter Installing tm-vm
|
|
|
135
|
|
|
136 To take advantage of the benefits of tm-vm, you need to have VM and tm
|
|
|
137 already installed.
|
|
|
138
|
|
80
|
139 VM is part of XEmacs distributions and so if you're running XEmacs you
|
|
76
|
140 don't need to install it. If you're running Emacs, you will need to
|
|
80
|
141 install VM. The official VM distribution site is
|
|
124
|
142 @file{ftp://ftp.uu.net/networking/mail/vm/}.
|
|
76
|
143
|
|
|
144 If you're reading this manual then there is a pretty good chance you
|
|
80
|
145 already have a recent version of tm. The official tm distribution site
|
|
|
146 is @file{ftp://ftp.jaist.ac.jp/pub/GNU/mime/}. Follow the installation
|
|
|
147 procedure for tm as described in the documentation.
|
|
76
|
148
|
|
80
|
149 Once these steps are completed, tm-vm installation is very simple. You
|
|
76
|
150 just need to insert the following lines in your VM configuration file
|
|
80
|
151 (generally @file{.vm}):
|
|
76
|
152
|
|
|
153 @lisp
|
|
|
154 (require 'mime-setup)
|
|
|
155 (require 'tm-vm)
|
|
|
156 @end lisp
|
|
|
157
|
|
|
158 That's it. You are ready to read and send multimedia mail! You may also
|
|
80
|
159 want to customize some aspects of tm-vm behaviour (@pxref{Customization}).
|
|
76
|
160
|
|
80
|
161 If you use BBDB, you must load tm-vm @strong{after} BBDB. Please be sure
|
|
76
|
162 to respect the following sequence in your initialization file:
|
|
|
163
|
|
|
164 @lisp
|
|
|
165 (bbdb-insinuate-vm)
|
|
|
166 (require 'tm-vm)
|
|
|
167 @end lisp
|
|
|
168
|
|
|
169
|
|
|
170
|
|
|
171
|
|
|
172
|
|
|
173 @node Usage, Customization, Install, Top
|
|
|
174 @chapter Using tm-vm
|
|
|
175
|
|
|
176
|
|
|
177 @menu
|
|
124
|
178 * Reading MIME mail:: Commands for MIME previewing
|
|
|
179 * Composing MIME mail:: Writing/Replying to/Forwarding MIME messages
|
|
|
180 * Printing:: Printing MIME messages
|
|
|
181 * Using BBDB:: BBDB integration
|
|
76
|
182 @end menu
|
|
|
183
|
|
|
184
|
|
|
185 @node Reading MIME mail, Composing MIME mail, Usage, Usage
|
|
|
186 @section Reading MIME mail
|
|
|
187
|
|
|
188 When reading mail, tm-vm can operate in two different modes:
|
|
|
189 @emph{automatic preview} and @emph{on-demand preview}. In automatic
|
|
|
190 preview mode (the default) MIME messages are automatically decoded. In
|
|
|
191 on-demand preview mode all messages are presented by VM as they are (as
|
|
|
192 if tm were not loaded). The user can request the decoding of a message
|
|
|
193 at any time with @code{tm-vm/view-message} (bound to @kbd{Z}).
|
|
|
194
|
|
|
195
|
|
|
196 @subsection VM folder buffer and MIME Preview buffer
|
|
|
197
|
|
|
198 Though tm-vm tries to hide this fact as much as possible, it is
|
|
|
199 important to note that when MIME previewing is enabled the current
|
|
|
200 message actually exists in @strong{two} separate buffers:
|
|
|
201
|
|
|
202 @itemize @bullet
|
|
|
203
|
|
|
204 @item
|
|
|
205 @cindex VM folder buffer
|
|
|
206 @emph{the VM folder buffer}: always displays the @strong{raw} message
|
|
|
207 buffer where the MIME contents remain unparsed
|
|
|
208
|
|
|
209 @item
|
|
|
210 @cindex MIME Preview buffer
|
|
|
211 @emph{the MIME Preview buffer}: displays a MIME parsed version of the
|
|
80
|
212 message. It is generally what you want to see as it is more readable.
|
|
76
|
213 @end itemize
|
|
|
214
|
|
124
|
215 There are two different buffers due to the VM 5 implementation that
|
|
|
216 makes TM/VM integration difficult. However, we try hard to make the MIME
|
|
|
217 Preview buffer act as if it were the real VM message buffer by making
|
|
|
218 all bindings act the same in the Preview buffer as in the folder
|
|
|
219 buffer. In this version of tm-vm, most of the usual VM bindings are made
|
|
|
220 available transparently in the MIME Preview buffer, others will be in
|
|
|
221 the future, contact the maintainer for more information.
|
|
76
|
222
|
|
|
223
|
|
|
224 @code{tm-vm/toggle-preview-mode} (bound to @kbd{M-t}) lets you toggle
|
|
|
225 between automatic and on-demand preview modes.
|
|
|
226
|
|
|
227
|
|
|
228 @node Composing MIME mail, Printing, Reading MIME mail, Usage
|
|
|
229 @section Composing MIME mail
|
|
|
230
|
|
124
|
231 Regardless of the current MIME preview mode (automatic or on-demand),
|
|
|
232 tm-vm activates the mime-editor mode each time you compose a mail
|
|
|
233 message (new message, reply or forward). @xref{Top,MIME Editor,MIME
|
|
|
234 Editor,tm-edit-en,TM Edit Manual}, for details on mime-editor mode.
|
|
76
|
235
|
|
80
|
236 When you reply to a message, tm-vm will insert the contents of the
|
|
76
|
237 @strong{decoded} message if there exists a MIME Preview buffer. This is
|
|
80
|
238 generally what you want for quoted-printable text, for instance. Inline
|
|
76
|
239 images are removed from the reply. If for some reason you want the
|
|
124
|
240 @strong{raw} message to be inserted instead of the decoded one, you have
|
|
76
|
241 to kill the MIME Preview buffer first. You do this with
|
|
|
242 @code{kill-buffer} (bound to @kbd{C-x k}) in the MIME Preview
|
|
80
|
243 buffer. You can also toggle automatic preview off, if it was on, with
|
|
76
|
244 @kbd{M-t}.
|
|
|
245
|
|
80
|
246 Forwarding a message always inserts the raw message with its own MIME
|
|
|
247 headers. The recipient will thus receive exactly the same message as you
|
|
|
248 did.
|
|
76
|
249
|
|
|
250
|
|
|
251
|
|
|
252 @node Printing, Using BBDB, Composing MIME mail, Usage
|
|
|
253 @section Printing MIME messages
|
|
|
254
|
|
|
255 For non-MULE Emacses, printing of MIME messages uses Postscript printing
|
|
|
256 (through the ps-print package). Non-MIME messages are printed the usual
|
|
|
257 way as configured in VM. This is controlled by the variable
|
|
|
258 @code{tm-vm/use-ps-print}.
|
|
|
259
|
|
|
260
|
|
|
261 @node Using BBDB, , Printing, Usage
|
|
|
262 @section Notes about BBDB Usage
|
|
|
263
|
|
|
264 BBDB, the Big Brother's Database, should operate normally with
|
|
80
|
265 VM/tm-vm. You must ensure, however, that tm-vm is loaded @strong{after}
|
|
76
|
266 BBDB has installed its hooks. Therefore be sure to respect the following
|
|
|
267 sequence in your initialization file:
|
|
124
|
268
|
|
76
|
269 @lisp
|
|
|
270 (bbdb-insinuate-vm)
|
|
|
271 (require 'tm-vm)
|
|
|
272 @end lisp
|
|
|
273
|
|
|
274
|
|
|
275
|
|
|
276
|
|
78
|
277 @node Customization, News, Usage, Top
|
|
76
|
278 @chapter Customization
|
|
|
279
|
|
|
280 Several variables let you adapt the behavior of tm-vm to your needs. You
|
|
80
|
281 can set these variables to the appropriate value in your initialization
|
|
76
|
282 file prior to loading tm.
|
|
|
283
|
|
|
284
|
|
|
285 @defopt tm-vm/automatic-mime-preview
|
|
80
|
286 If non-@code{nil} then tm-vm will start in automatic mime preview mode
|
|
|
287 (@pxref{Usage}). Default @code{t}.
|
|
76
|
288 @end defopt
|
|
|
289
|
|
|
290 @defopt tm-vm/strict-mime
|
|
80
|
291 If non-@code{nil} tm-vm will automatically decode MIME messages
|
|
|
292 only. MIME messages have a @code{MIME-Version} header. If @code{nil}
|
|
|
293 then all messages will be decoded and viewed in the MIME Preview buffer
|
|
|
294 regardless of the existence of a @code{MIME-Version} header. Default
|
|
|
295 @code{t}.
|
|
76
|
296 @end defopt
|
|
|
297
|
|
124
|
298 @defopt tm-vm/use-vm-bindings
|
|
|
299 If non-@code{nil} tm-vm will use usual VM bindings in MIME-Preview
|
|
|
300 buffers and make TM bindings available with a prefix. Otherwise usual TM
|
|
|
301 bindings are used without prefix (this was the default in versions of
|
|
|
302 tm-vm older than 8.0). Default @code{t}.
|
|
|
303 @end defopt
|
|
|
304
|
|
|
305 @defopt tm-vm/attach-to-popup-menus
|
|
|
306 If this is non-@code{nil}, tm-vm will append a menu of MIME commands to
|
|
|
307 the VM standard mode popup (@key{Button 3}). Default @code{t}. Untested
|
|
|
308 in Emacs.
|
|
|
309 @end defopt
|
|
|
310
|
|
|
311 @defopt tm-vm/use-original-url-button
|
|
|
312 If this is non-@code{nil}, tm-vm will use VM to energize URL's contained
|
|
|
313 in the message body as weel as message headers. Default @code{t}.
|
|
76
|
314 @end defopt
|
|
|
315
|
|
|
316 @defopt tm-vm/use-ps-print
|
|
80
|
317 If this is non-@code{nil} then MIME messages will be printed in
|
|
|
318 Postscript using the ps-print package. By default it is @code{t} for
|
|
|
319 non-MULE Emacses.
|
|
76
|
320 @end defopt
|
|
|
321
|
|
124
|
322 @defvar tm-vm/build-mime-preview-buffer-hook
|
|
|
323 tm-vm runs the hooks in this list each time it builds a MIME-Preview
|
|
|
324 buffer for a message. You can attach your own hook functions using
|
|
|
325 @code{add-hook}.
|
|
|
326 @end defvar
|
|
|
327
|
|
76
|
328 @defvar tm-vm/select-message-hook
|
|
|
329 tm-vm runs the hooks in this list after selecting a message. You can
|
|
|
330 attach your own hook functions using @code{add-hook}.
|
|
|
331 @end defvar
|
|
|
332
|
|
|
333 @defvar tm-vm/forward-message-hook
|
|
|
334 tm-vm runs the hooks in this list after a Mail mode buffer has been
|
|
|
335 created to forward a message in message/rfc822 type format.
|
|
|
336 If @code{vm-forwarding-digest-type} is @samp{rfc1521}, tm-vm runs this
|
|
|
337 hook instead of @code{vm-forward-message-hook}.
|
|
|
338 @end defvar
|
|
|
339
|
|
|
340 @defvar tm-vm/send-digest-hook
|
|
|
341 tm-vm runs the hooks in this list after a Mail mode buffer has been
|
|
|
342 created to send a digest in multipart/digest type format.
|
|
|
343 If @code{vm-digest-send-type} is @samp{rfc1521}, tm-vm runs this hook
|
|
80
|
344 instead of @code{vm-send-digest-hook}.
|
|
76
|
345 @end defvar
|
|
|
346
|
|
|
347 @section X-Faces
|
|
|
348 @cindex X-Faces
|
|
|
349 tm-vm displays X-Faces inline for XEmacs users in the same way as
|
|
|
350 VM. X-Faces are turned on by default. You need to disable their display
|
|
|
351 explicitly if you want to:
|
|
|
352
|
|
|
353 @lisp
|
|
|
354 (setq vm-use-lucid-highlighting nil)
|
|
|
355 (setq vm-display-xfaces nil)
|
|
|
356 @end lisp
|
|
|
357
|
|
|
358
|
|
78
|
359 @node News, Copyright, Customization, Top
|
|
|
360 @chapter News
|
|
76
|
361
|
|
124
|
362 This section documents the user-visible changes in the latest releases
|
|
|
363 of tm-vm. For more technical details see the ChangeLog.
|
|
|
364
|
|
146
|
365 @section 8.5 to 8.12
|
|
124
|
366
|
|
|
367 @itemize @bullet
|
|
|
368 @item
|
|
|
369 Bug fixes
|
|
|
370 @item
|
|
|
371 Compatible with successive VM 6 versions (tested up to VM 6.24).
|
|
|
372 @item
|
|
|
373 Improved overall VM integration.
|
|
|
374 @item
|
|
|
375 New hook variable @code{tm-vm/build-mime-preview-buffer-hook}.
|
|
|
376 @end itemize
|
|
|
377
|
|
|
378 @section 8.4
|
|
|
379
|
|
|
380 @itemize @bullet
|
|
|
381 @item
|
|
|
382 Bug fixes in Emacs menus.
|
|
|
383 @end itemize
|
|
|
384
|
|
|
385 @section 8.0 to 8.3
|
|
|
386 @itemize @bullet
|
|
|
387 @item
|
|
|
388 Most usual VM bindings are available in MIME-Preview buffers (motion
|
|
|
389 commands, summary generation). Usual TM bindings are prefixed with
|
|
|
390 @key{C-c} now. See the variable @code{tm-vm/use-vm-bindings}.
|
|
|
391 @item
|
|
|
392 VM menu bar and toolbar are accessible from MIME-Preview buffers
|
|
|
393 @item
|
|
|
394 MIME-Preview buffers support header toggling
|
|
|
395 @item
|
|
|
396 VM message previewing is correctly supported
|
|
|
397 @item
|
|
|
398 Bug fixes
|
|
|
399 @end itemize
|
|
76
|
400
|
|
|
401 @section 7.79
|
|
|
402
|
|
|
403 @itemize @bullet
|
|
|
404 @item
|
|
|
405 Minor bug fixes.
|
|
|
406 @end itemize
|
|
|
407
|
|
|
408 @section 7.78
|
|
|
409
|
|
|
410 @itemize @bullet
|
|
|
411 @item
|
|
|
412 Better compatibility with MULE in respect of the ps-print package
|
|
|
413 @end itemize
|
|
|
414
|
|
|
415
|
|
|
416 @section 7.77
|
|
|
417
|
|
|
418 @itemize @bullet
|
|
|
419 @item
|
|
|
420 A bug in byte-compilation introduced in 7.76 was fixed
|
|
|
421 @item
|
|
|
422 Window configurations are restored more correctly (point stays where it
|
|
|
423 should :-) when paging through messages.
|
|
|
424 @end itemize
|
|
|
425
|
|
|
426
|
|
|
427 @section 7.76
|
|
|
428
|
|
|
429 @itemize @bullet
|
|
|
430 @item
|
|
|
431 Forwarding a MIME message now always forwards the @strong{raw} message.
|
|
|
432 @item
|
|
|
433 Forwarding a message from the @samp{Dispose} pull-down menu now works
|
|
|
434 correctly in XEmacs. Untested in Emacs.
|
|
|
435 @item
|
|
|
436 Forwarding a message when the current buffer is the MIME-Preview buffer
|
|
|
437 now works correctly
|
|
|
438 @item
|
|
|
439 @code{tm-vm/use-ps-print} was introduced @pxref{Customization}.
|
|
|
440
|
|
|
441 @end itemize
|
|
|
442
|
|
|
443
|
|
|
444 @section 7.75
|
|
|
445
|
|
|
446 @itemize @bullet
|
|
|
447 @item
|
|
|
448 Bug fixes: BBDB record creation and MIME component extraction from new
|
|
|
449 messages
|
|
|
450
|
|
|
451 @end itemize
|
|
|
452
|
|
|
453
|
|
|
454 @section 7.74
|
|
|
455
|
|
|
456 @itemize @bullet
|
|
|
457 @item
|
|
|
458 X-Faces are displayed by default. @pxref{Customization}
|
|
|
459 @end itemize
|
|
|
460
|
|
|
461
|
|
|
462
|
|
|
463
|
|
|
464
|
|
|
465
|
|
78
|
466 @node Copyright, Variable Index, News, Top
|
|
76
|
467 @ifinfo
|
|
|
468 @chapter Copyright
|
|
|
469
|
|
146
|
470 This file documents tm-vm 8.12, an interface between tm and the VM mail
|
|
76
|
471 user agent.
|
|
|
472
|
|
|
473 Copyright 1996 Tomohiko Morioka, Oscar Figueiredo
|
|
|
474
|
|
|
475 tm-vm is part of the TM package. tm-vm and its documentation are
|
|
|
476 distributed under the same terms as TM itself
|
|
|
477 @xref{Copyright, Copyright, tm-en, TM}.
|
|
|
478 @end ifinfo
|
|
|
479
|
|
|
480
|
|
|
481 @node Variable Index, Concept Index, Copyright, Top
|
|
|
482 @unnumbered Variable Index
|
|
|
483
|
|
|
484 @printindex vr
|
|
|
485
|
|
|
486 @node Concept Index, , Variable Index, Top
|
|
|
487 @unnumbered Concept Index
|
|
|
488
|
|
|
489 @printindex cp
|
|
|
490
|
|
|
491 @contents
|
|
|
492 @bye
|
