This file details how to apply the patch for the select_range plugin.  See
../README for details on the functionality this adds, how to contact the
author, etc.



-PATCH INSTALLATION

Change to the Squirrelmail base directory

Run the following to show the select range link next to toggle all, and enable
shift-click in the message list (x.x.x is your current or next closest
Squirrelmail version):

patch -p0 < plugins/select_range/patch/versions/x.x.x/mailbox_display.diff

Run the following to show the select range and toggle all links in the address
book (x.x.x is your current or next closest Squirrelmail version): 

patch -p0 < plugins/select_range/patch/versions/x.x.x/addressbook.diff

Run the following to allow shift-click in the address book (x.x.x is your
current or next closest Squirrelmail version): 

patch -p0 < plugins/select_range/patch/versions/x.x.x/forms.diff



-FILE COPY INSTALLATION 

(This will obviously remove any other patches you have applied)

Change directory to the "versions" folder of this plugin

Change directory to your version of squirrelmail or the next closest version

To show the select range link next to the toggle all link, and enable
shift-click in the message list:
- Move the existing functions/mailbox_display.php out of the way (ex: rename to
  functions/mailbox_display_orig.php)
- Copy mailbox_display.php from current location to squirrelmail/functions

To show the select range and toggle all links in the address book:
- Move the existing src/addressbook.php out of the way (ex: rename to
  src/addressbook_orig.php)
- Copy addressbook.php from current location to squirrelmail/src

To allow shift-click in the address book:
- Move the existing functions/forms.php out of the way (ex: rename to
  forms_orig.php)
- Copy forms.php from current location to squirrelmail/functions




-GENERATING YOUR OWN PATCHES

If your squirrelmail release's pre-patched files aren't in one of the
patch/versions directories you can send me your patched version along with the
Squirrelmail version number it should go with. I will include it in the next
release. If you would also/instead like to generate a diff file, you should do
the following (where x.x.x is the current Squirrelmail version you are
patching):

To show the select range link next to the toggle all link, and allow
shift-click in the message list:
- cd to functions
- copy mailbox_display.php to mailbox_display_orig.php
- make changes to mailbox_display.php
- cd ..
- run `diff -Nau functions/mailbox_display_orig.php
  functions/mailbox_display.php >
  plugins/select_range/patch/versions/x.x.x/mailbox_display.diff`

To show the select range and toggle all links, and allow shift-click in the
address book:
- cd to src
- copy addressbook.php to addressbook_orig.php
- make changes to addressbook.php
- cd to ../functions
- copy forms.php to forms_orig.php
- make changes to forms.php
- cd ..
- run `diff -Nau src/addressbook_orig.php src/addressbook.php >
  plugins/select_range/patch/versions/x.x.x/addressbook.diff`
- run `diff -Nau functions/forms_orig.php functions/forms.php >
  plugins/select_range/patch/versions/x.x.x/forms.diff`

send me the diffs and tell me what Squirrelmail version they go with

I will include and credit you with any files you generate so others may use
them.



-CREDITS FOR PATCHED VERSIONS

01/26/04 added mbox.diff and abook.diff for Squirrelmail 1.4.4; thanks to
Shadow2531

06/13/04 New abook.diff and mbox.diff patches for Squirrelmail 1.4.3a.  Thanks
to Shadow2531 and Simon Matter for their help.

03/17/04 new patch to allow extra functionality for address book

03/11/04 Removed patches for versions before 1.4.2, since they will no longer
work. Simplified 1.4.2 patch to only add a new hook.

02/25/04 re-did 1.4.2 patch to fix issue with search page

02/17/04 re-did 1.4.2 patch to work with new select_range version

02/12/04 Sorry Graeme, I re-did the patch using the new simpler method; the old
method was a real PITA! (I think either Starkey or Jennifer tried to give me a
patch using the new method earlier; sorry guys!) Thanks to pdontthink for
showing me how to do this.

02/05/04 Graeme for 1.4.2 (thanks also to Starkey and Jennifer Pinkham, even
though I didn't end up using their patches)

03/28/03 Starkey, Jamuel, NLNS for 1.4.0-rc2a
