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 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/mbox.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/abook.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 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.php)
Copy addressbook.php from current location to squirrelmail/src




-GENERATING YOUR OWN PATCHES

If your squirrelmail release's mailbox_display.php or addressbook.php
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:

*To show the select range link next to the toggle all link 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 > mbox.diff

*To show the select range and toggle all links in the address book:
cd to src
copy addressbook.php to addressbook_orig.php
make changes to addressbook.php
cd ..
run
diff -Nau src/addressbook_orig.php src/addressbook.php > abook.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

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
