Installing Mark Read
====================

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

  $ cd plugins
  $ tar -zxvf mark_read-1.0.tar.gz


2) If you have SquirrelMail version 1.4.2 or above, skip to step
   number three.  Otherwise, remaining in the plugins directory, 
   you may do one of the following two things:

     A) This is the recommended method, which guarantees you will not
        lose any other changes you may have made to your SquirrelMail
        installation.  Run the following command to patch your 
        SquirrelMail source code for this plugin:

       $ patch -p0 < mark_read/patches/mark_read_patch_squirrelmail-1.4.0.diff

        Note that if you have version 1.2.x, change that last command to use the 
        correct .diff file (currently, 1.2.11 diff file should work with most 
        SquirrelMail 1.2.x versions).

        If the output of this command indicates any FAILUREs, you either
        need to update the patch utility on your system or you have some
        non-standard/modified SquirrelMail source code. You need to patch it
        manually.

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

     B) If you are certain you have an unmodified SquirrelMail installation
        or are having problems with the patch command above, you may use the 
        provided pre-patched source file by running this command:

       $ cp mark_read/source_files/left_main.php-1.4.0 ../src/left_main.php
       cp: overwrite `../src/left_main.php'? y

        Note that if you have version 1.2.x, change that last command to use the 
        correct file (currently, 1.2.11 file should work with most SquirrelMail 
        1.2.x versions).


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

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


4) 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


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

