Installing HTML Mail Plugin
===========================

1) Start with untaring the file into the plugins directory.
   Here is a example for the 1.0 version of the html_mail plugin.

  $ cd plugins
  $ tar -zxvf html_mail-1.0-1.4.tar.gz

2) Change into the html_mail directory, copy config.php.sample
   to config.php and edit config.php, making adjustments as
   you deem necessary.

  $ cd html_mail
  $ cp config.php.sample config.php
  $ vi config.php

3) If you have SquirrelMail version 1.4.2, skip to step 4.
   Otherwise, you need to patch the SquirrelMail source code.  
   Do so from the html_mail directory:

  $ patch -p0 < patches/squirrelmail-1.4-html_mail.diff

   Make sure that you use the patch file that matches your
   SquirrelMail version.

   Note for Windows users: you can get native patch functionality
   by installing this very useful package:
   http://unxutils.sourceforge.net/

4) If you do not wish to provide emoticon functionality, skip 
   to step 5.  Otherwise, you need to patch the SquirrelMail 
   source code.  Do so from the html_mail directory:

  $ patch -p0 < patches/squirrelmail-1.4.2-emoticons.diff

   Make sure that you use the patch file that matches your
   SquirrelMail version.

   Note for Windows users: you can get native patch functionality
   by installing this very useful package:
   http://unxutils.sourceforge.net/

5) Then go to your config directory and run conf.pl.  Choose
   option 8 and move the plugin from the "Available Plugins"
   category to the "Installed Plugins" category.  Save and exit.

  $ cd ../../config/
  $ ./conf.pl

6) Also, please verify that you have the "compatibility" plugin
   installed.

7) If you plan to use the integrated spell checking mechanism,
   configure your server to allow CGI execution in the spell
   checker directory and make sure your Perl installation has
   the correct modules.  See the README file for more information.



Upgrading HTML Mail Plugin
==========================

1) Start with untaring the file into the plugins directory.
   Here is a example for the 1.0 version of the html_mail plugin.

  $ cd plugins
  $ tar -zxvf html_mail-1.0-1.4.tar.gz

2) Change into the html_mail directory, check your config.php
   file against the new version, to see if there are any new
   settings that you must add to your config.php file.

  $ diff -Nau config.php config.php.sample

   Or simply replace your config.php file with the provided sample
   and reconfigure the plugin from scratch (see step 2 under the
   installation procedure above).

