Overview
********

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

   Until recently VM did not support the MIME standard. Kyle Jones has
begun to implement it in VM 6.0 however TM provides a much more complete
support of MIME than the one currently offered in VM 6. 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. tm-vm adds
MIME features to VM 5 and replaces the native features offered by VM 6.

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

   tm-vm tries to integrate as transparently as possible with VM so that
MIME messages appear to you just like 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.  Note that the word *previewing* has two
different meanings for VM and TM. In VM, it means view the first lines
of a message only, as defined by the variable `vm-preview-lines', to
avoid confusion we call this *message previewing*. In TM, previewing
means parsing the contents of a message according to the rules of the
MIME standard and display a corresponding view of it. We call that more
specifically *MIME previewing*.

   The MIME Viewer offers all the functionality to view/extract the MIME
components (attachments) of the message. It also displays images inline
in XEmacs. See MIME Viewer: (tm-view-en)Top. Note however that for a
better VM integration, tm-vm overrides the standard bindings of the
MIME-Viewer and makes them available with a <C-c> prefix.

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 microphone attached to the
     computer

   * Enclose message sections as PGP encrypted

   and much more. For details, see MIME Editor: (tm-edit-en)Top..

   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::.).