MH-E for Debian
---------------

Documentation: 
~~~~~~~~~~~~~~ 
In addition to the MH-E Info node, the MH-E manual is also available on the
web in HTML and PDF formats.  See http://mh-e.sourceforge.net/manual/.


Contributed files:
~~~~~~~~~~~~~~~~~~
The following contrib files are included.  Please see the files themselves
for full documentation.

mh-frame.el - Open MH-E in a separate frame

 /usr/share/emacs/site-lisp/mh-e/mh-frame.el  

 Visit (or, if necessary, open) a frame called "MH-E" for mh-rmail,
 rescan folder and show current message.  On mh-quit from +inbox in
 MH-E frame, delete that frame, and if there's a pid argument
 argument, kill the proc with that pid.

 Start up MH-E in a separate frame with

	M-x mh-frame

 or you could bind a key to this function:

      (global-set-key "\C-x\r" 'mh-frame)

 This was originally designed to be used with a shell script that calls it
 via the gnuserv package.  This shell script is in the commentary section
 of /usr/share/emacs/site-lisp/mh-e/mh-frame.el


mh-comp-frame.el - Message composition in a separate frame

 If this file is loaded into emacs then commands like mh-send, mh-reply,
 mh-forward etc. will create a new frame in which the draft is opened. When
 the mail is sent (or the draft deleted) this frame goes away. This means
 that I can continue visiting other messages or folders or read new mail in
 the original frame. It works best when `mh-delete-yanked-msg-window-flag'
 is nil.

 To enable this, add the line:
  (require 'mh-comp-frame)
 to your .emacs file.


Using MH-E with other Debian packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

swish++:     Actually, MH-E is compatible with many search engines, but
             this one seems to work particularly well.  To use swish++ with
             MH-E, read the documentation for the function
             mh-swish++-execute-search:

              C-h f mh-swish++-execute-search

             and then use the command `mh-index-search'.

gnus:        A much nicer interface to GPG can be had when gnus 5.9.0 is
             installed. On Debian, install the gnus package instead of
             using the likely older version of gnus bundled with Emacs and
             XEmacs.

             Messages that have been signed or encrypted with GPG are
             verified and decrypted automatically. To sign or encrypt a
             message, use "C-c RET C-s
             (mh-mml-secure-message-sign-pgpmime)" and "C-c C-m C-e
             (mh-mml-secure-message-encrypt-pgpmime)."

             Also, better handling of HTML parts can be achieved with
             gnus 5.9.0 in conjunction with handler packages.  Set the
             variable mm-text-html-renderer to 'w3 and install the
             w3-el-e21 package, or alternatively, Bill Wohler reports
             good results setting mm-text-html-renderer to 'w3m with the
             packages w3mmee, w3mmee-img and w3m-el installed.

mailcrypt:   Lets you sign and/or encrypt out-going messages and decrypt
             received messages.  Just install the package and it sets
             itself up correctly in MH-E.  Not as fancy as the support
             provided by the gnus package.

compface:    Needed for the X-Face and Face header fields.

wget and imagemagick:
             Needed for the X-Image-URL header field.

w3-el-e21 or w3m-el:
             When used with a recent version of gnus, these will render HTML
             parts of MIME messages.  Set the Emacs variable
             `mm-text-html-renderer' appropriately.

picon-domains:
             If a Face or X-Face or X-Image-URL header field is not present,
             the icon for the originator's domain will be displayed in the
             mail header.

 -- Peter S Galbraith <psg@debian.org>, Thu,  2 Mar 2006 23:26:11 -0500
