This is Info file ../../info/tm-vm-en.info, produced by Makeinfo-1.64
from the input file tm-vm-en.texi.

   This file documents tm-vm.el v7.79.

   tm-vm is part of the TM Package.

   tm-vm is an interface between tm and the VM mail user agent that lets
you read and write multimedia mail on the Internet using the MIME
standard.

   tm-vm and its documentation are distributed under the same terms as
TM. Please refer to the TM Manual.

   Copyright 1996 Tomohiko Morioka, Oscar Figueiredo


File: tm-vm-en.info,  Node: Top,  Next: Overview,  Prev: (dir),  Up: (dir)

tm-vm Manual
************

   tm-vm is an interface between tm and the VM mail user agent that lets
you read and write multimedia mail on the Internet using the MIME
standard.

   This document applies to release 7.79 of tm-vm.el

* Menu:

* Overview::                    Reading and writing MIME mail in VM
* Install::                     Installation procedure
* Usage::                       Detailed usage of tm-vm
* Customization::               How to customize tm-vm behavior.
* News::                  	Recent modifications
* Copyright::
* Variable Index::
* Concept Index::


File: tm-vm-en.info,  Node: Overview,  Next: Install,  Prev: Top,  Up: Top

Overview
********

   tm-vm is an interface between TM (*Note TM: (tm-en)Top.) and the VM
mail user agent (*Note VM: (vm)Top.).

   In its current version VM does not provide functionality to support
the MIME standard. tm-vm integrates the TM package into VM so as to
give you a powerful MIME support in your usual mail environment for
both mail reading and composing.

Mail Reading Features
=====================

   tm-vm tries to integrate as transparently as possible within VM so
that MIME messages appear to you the same as plain messages.

   tm-vm detects MIME messages when you try to view them and, if
automatic MIME previewing is enabled (the default), then it
automatically parses the message and displays a "beautified" version
under the MIME Viewer.

   The MIME Viewer offers all the functionality to view/extract the MIME
components (attachments) of the message. It also displays images inline
in XEmacs. *Note MIME Viewer tm-view: (tm-en)tm-view.

Mail Composing Features
=======================

   Composing a new message places you in a compose buffer as usual
under VM but a special minor mode (`mime-editor') is made available that
lets you perform such operations as:

   * Insert arbitrary files

   * Insert another message

   * Insert a voice sample recorded from a micro attached to the
     computer

   * Enclose message sections as PGP encrypted

   and much more. For details *Note MIME Editor: (tm-en)tm-edit.

   When you reply to a message citing the original and tm-vm is active,
tm-vm will insert the contents of the MIME-Preview buffer in the reply
buffer. You can also insert the raw message if you want *note Usage::..


File: tm-vm-en.info,  Node: Install,  Next: Usage,  Prev: Overview,  Up: Top

Installing tm-vm
****************

   To take advantage of the benefits of tm-vm, you need to have VM and
tm already installed.

   VM is part of XEmacs distributions and if you're running XEmacs you
don't need to install it.  If you're running Emacs, you will need to
install VM. Official distribution site is
`ftp://ftp.uu.net/networking/mail/vm/'

   If you're reading this manual then there is a pretty good chance you
already retrieved a recent version of tm. Official distribution site is
`ftp://ftp.jaist.ac.jp/pub/GNU/mime/'Follow the installation procedure
for tm as it is described in the documentation.

   Once these steps are completed, tm-vm installation is very simple you
just need to insert the following lines in your VM configuration file
(generally .vm):

     (require 'mime-setup)
     (require 'tm-vm)

   That's it. You are ready to read and send multimedia mail! You may
also want to customize some aspects of tm-vm behaviour *note
Customization::.

   If you use BBDB you must load tm-vm *after* BBDB. Please be sure to
respect the following sequence in your initialization file:

     (bbdb-insinuate-vm)
     (require 'tm-vm)


File: tm-vm-en.info,  Node: Usage,  Next: Customization,  Prev: Install,  Up: Top

Using tm-vm
***********

* Menu:

* Reading MIME mail::       Commands for MIME previewing
* Composing MIME mail::     Writing/Replying to/Forwarding MIME messages
* Printing::                Printing MIME messages
* Using BBDB::              BBDB integration


File: tm-vm-en.info,  Node: Reading MIME mail,  Next: Composing MIME mail,  Prev: Usage,  Up: Usage

Reading MIME mail
=================

   When reading mail, tm-vm can operate in two different modes:
*automatic preview* and *on-demand preview*. In automatic preview mode
(the default) MIME messages are automatically decoded. In on-demand
preview mode all messages are presented by VM as they are (as if tm
were not loaded). The user can request the decoding of a message at any
time with `tm-vm/view-message' (bound to `Z').

VM folder buffer and MIME Preview buffer
----------------------------------------

   Though tm-vm tries to hide this fact as much as possible, it is
important to note that when MIME previewing is enabled the current
message actually exists in *two* separate buffers:

   * *the VM folder buffer*: always displays the *raw* message buffer
     where the MIME contents remain unparsed

   * *the MIME Preview buffer*: displays a MIME parsed version of the
     message. It is generally what you want to see as it is more
     readable

   The reasons why there are two different buffers are due to current VM
implementation that turns tm integration difficult. However we try hard
to make the MIME Preview buffer act as if it were the real VM message
buffer by making all bindings act the same in Preview buffer as in
folder buffer.

   `tm-vm/toggle-preview-mode' (bound to `M-t') lets you toggle between
automatic and on-demand preview modes.


File: tm-vm-en.info,  Node: Composing MIME mail,  Next: Printing,  Prev: Reading MIME mail,  Up: Usage

Composing MIME mail
===================

   Regardless of current preview mode tm-vm activates the mime-editor
mode each time you compose a mail message (new message, reply or
forward). Functionalities provided by the mime-editor are described in
*Note MIME Editor: (tm-en)tm-edit.

   When you reply to a message tm-vm will insert the contents of the
*decoded* message if there exists a MIME Preview buffer. This is
generally what you want for quoted-printable text for instance. Inline
images are removed from the reply. If for some reason you want the
*raw* message to be inserted instead of the decoded one you have to
kill the MIME Preview buffer first. You do this with `kill-buffer'
(bound to `C-x k') in the MIME Preview buffer. You can also toggle
automatic preview off if it was on with `M-t'.

   Forwarding a message inserts always inserts the raw message with its
own MIME headers. The recipient will thus receive exactly the same
message as you did.


File: tm-vm-en.info,  Node: Printing,  Next: Using BBDB,  Prev: Composing MIME mail,  Up: Usage

Printing MIME messages
======================

   For non-MULE Emacses, printing of MIME messages uses Postscript
printing (through the ps-print package). Non-MIME messages are printed
the usual way as configured in VM. This is controlled by the variable
`tm-vm/use-ps-print'.


File: tm-vm-en.info,  Node: Using BBDB,  Prev: Printing,  Up: Usage

Notes about BBDB Usage
======================

   BBDB, the Big Brother's Database, should operate normally with
VM/tm-vm. You must ensure however that tm-vm is loaded *after* BBDB has
installed its hooks. Therefore be sure to respect the following
sequence in your initialization file:
     (bbdb-insinuate-vm)
     (require 'tm-vm)


File: tm-vm-en.info,  Node: Customization,  Next: News,  Prev: Usage,  Up: Top

Customization
*************

   Several variables let you adapt the behavior of tm-vm to your needs.
You can set this variables to the appropriate value in your
initialization file prior to loading tm.

 - User Option: tm-vm/automatic-mime-preview
     If non-nil then tm-vm will start in automatic mime preview mode
     (*note Usage::.). Default t.

 - User Option: tm-vm/strict-mime
     If non-nil tm-vm will automatically decode MIME messages only. MIME
     messages have a MIME-Version header. If nil then all messages will
     be decoded and viewed in the MIME Preview buffer regardless of the
     existence of a MIME-Version header. Default t.

 - User Option: tm-vm/use-xemacs-popup-menu
     If this is non nil and you're running XEmacs, tm-vm will install a
     menu of MIME commands as a mode popup (Button 3) in message
     composition buffers. Default t.

 - User Option: tm-vm/use-ps-print
     If this is non-nil then MIME messages will be printed in Postscript
     using the ps-print package. By default it is t for non
     MULE-Emacses.

 - Variable: tm-vm/select-message-hook
     tm-vm runs the hooks in this list after selecting a message. You
     can attach your own hook functions using `add-hook'.

 - Variable: tm-vm/forward-message-hook
     tm-vm runs the hooks in this list after a Mail mode buffer has been
     created to forward a message in message/rfc822 type format.  If
     `vm-forwarding-digest-type' is `rfc1521', tm-vm runs this hook
     instead of `vm-forward-message-hook'.

 - Variable: tm-vm/send-digest-hook
     tm-vm runs the hooks in this list after a Mail mode buffer has been
     created to send a digest in multipart/digest type format.  If
     `vm-digest-send-type' is `rfc1521', tm-vm runs this hook instead
     of `vm-send-digest-hook'."

X-Faces
=======

   tm-vm displays X-Faces inline for XEmacs users in the same way as
VM. X-Faces are turned on by default. You need to disable their display
explicitly if you want to:

     (setq vm-use-lucid-highlighting nil)
     (setq vm-display-xfaces nil)


File: tm-vm-en.info,  Node: News,  Next: Copyright,  Prev: Customization,  Up: Top

News
****

   This section documents the changes in the latest releases of tm-vm.

7.79
====

   * Minor bug fixes.

7.78
====

   * Better compatibility with MULE in respect of the ps-print package

7.77
====

   * A bug in byte-compilation introduced in 7.76 was fixed

   * Window configurations are restored more correctly (point stays
     where it should :-) when paging through messages.

7.76
====

   * Forwarding a MIME message now always forwards the *raw* message.

   * Forwarding a message from the `Dispose' pull-down menu now works
     correctly in XEmacs. Untested in Emacs.

   * Forwarding a message when the current buffer is the MIME-Preview
     buffer now works correctly

   * `tm-vm/use-ps-print' was introduced *note Customization::..

7.75
====

   * Bug fixes: BBDB record creation and MIME component extraction from
     new messages

7.74
====

   * X-Faces are displayed by default. *note Customization::.


File: tm-vm-en.info,  Node: Copyright,  Next: Variable Index,  Prev: News,  Up: Top

Copyright
*********

   This file documents tm-vm 7.76, an interface between tm and the VM
mail user agent.

   Copyright 1996 Tomohiko Morioka, Oscar Figueiredo

   tm-vm is part of the TM package. tm-vm and its documentation are
distributed under the same terms as TM itself *Note Copyright:
(TM)Copyright.


File: tm-vm-en.info,  Node: Variable Index,  Next: Concept Index,  Prev: Copyright,  Up: Top

Variable Index
**************

* Menu:

* tm-vm/automatic-mime-preview:         Customization.
* tm-vm/forward-message-hook:           Customization.
* tm-vm/select-message-hook:            Customization.
* tm-vm/send-digest-hook:               Customization.
* tm-vm/strict-mime:                    Customization.
* tm-vm/use-ps-print:                   Customization.


File: tm-vm-en.info,  Node: Concept Index,  Prev: Variable Index,  Up: Top

Concept Index
*************

* Menu:

* MIME Preview buffer:                  Reading MIME mail.
* VM folder buffer:                     Reading MIME mail.



Tag Table:
Node: Top494
Node: Overview1156
Node: Install2894
Node: Usage4129
Node: Reading MIME mail4475
Node: Composing MIME mail5951
Node: Printing7022
Node: Using BBDB7399
Node: Customization7805
Node: News9954
Node: Copyright10979
Node: Variable Index11376
Node: Concept Index11843

End Tag Table
