--------------------------------------------------------------------------------
IMPORTANT                    READ BEFORE UPGRADING                     IMPORTANT
--------------------------------------------------------------------------------
Contact List requires PHP 4.1.0 or later to run on your server.  (Please note I
said PHP, not phpBB.  They are two different things.)

Contact List is a BETA modification.  This means that it is not complete - there
are features I have not yet added or fully developed.  It also means that there
may be bugs in the code.  While I do test Contact List before releasing it, I
cannot recreate every environment that may cause a problem or error.  You may
encounter unexpected effects when installing or using Contact List.  If you do,
I would appreciate it if you would give me as much information as possible about
the problem so that I can try to correct it in future releases.

Contact List is tested on MySQL 3 databases only.  It has not been, and will not
be, tested on other types of databases (largely because I don't have them).  I
have provided *.sql files for other types of databases.  However, since I have
no way of testing those files, I do not know if they work.  If you are familiar
with table creation, table alteration, and insertion queries for your type of
database, you should look the sql files over for mistakes before trying to
install.

If you need support or have questions during the upgrade process, please
check the Mini FAQ section of the readme.txt file.  Many of the more common
questions have already been answered there.
--------------------------------------------------------------------------------
                             UPGRADING INSTRUCTIONS
--------------------------------------------------------------------------------

To upgrade a previously installed version of this hack on a phpBB forum to the
current version, follow these steps.

1) If upgrading from Contact/BID List 0.2.1 Beta, stop.  Upgrading from versions
   earlier than 0.2.5 is not supported or recommended due to the amount of
   changes required.  Please uninstall your previous version and then do a fresh
   install using this version.

2) If you have not done so already, unpack ZIP file you have downloaded.  This
   will create new directories and files as described the readme.txt file.

   But, you've probably already done this step since you're reading this file,
   right?

3) Look at the top of the docs/changelog.txt file for descriptions of changes
   made in each release.  At the bottom of each version's changes list, there is
   a section labeled "Changed Files List."  These files are those added or
   changed in the release.  You only need to update those files changed since
   the release of the version of this hack from which you are upgrading.

4) This hack adds some new files to your forum.  At this point, you should
   upload the files in hack_files.  Maintain the directory structure in
   hack_files, while considering it equivalent to the phpBB root directory.
   That means that files in hack_files/admin/ should be place in your forum's
   admin/ directory, and so on.  If directories found in hack_files do not exist
   on your forum, create matching directories on your forum as needed.

   If you wish, you only have to upload files in the hack_files directory that
   are also in the Changed Files List.  It might be easier for you to upload all
   the files at once, which is also fine.

   Special Notes on this Step:
     - The upload procedure is the same as the COPY command mentioned in
       file_edits.txt and is duplicated here due to the number of people that
       never understand the COPY command.  You only need to copy/upload once.
     - If you do not have the subSilver template installed, then you do not need
       to copy any hack_files/templates/subSilver files to a subSilver directory
       on your forum.
     - If you have non-subSilver templates installed, do be sure to copy the
       hack_files/templates/subSilver files to the directories of all templates.

5) In this step, you will prepare to edit your previously existing forum files.
   All of the instructions for doing this are listed in the file_edits.txt file.
   Open this file in your favorite text editor, such as Notepad, Wordpad,
   PHPEdit, or EditPlus.  If you use Dreamweaver for this step, be CERTAIN that
   you have activated the "Code" mode of that program, or you will have problems
   later.

   Check the file for an Author's Notes section near the top for any special
   instructions that you may need to follow.  If there are none, or no Author's
   Notes at all, look near the top for a section labeled "Files To Edit."  This
   is a list of the files you'll be editing.  Obvious, huh?  Before you do
   anything else, make certain you have two local copies of each of these files.
   One copy is for editing and the other is for a backup of the unchanged file.
   If there is a problem later, you can restore the backup file(s) as needed.  
   If you don't have two local copies, make them.  When you don't have *any*
   local copies, download a copy from your web site via FTP, SSH, or another
   file transfer method.

   Special Note on this Step:
     - The local copy of the file(s) you're editing should NOT be the actual
       files being used on your site.  An exact copy of them, yes, but not the
       real thing.  Changes should not be appear on your site as you edit the
       files.
     - If you have already installed Prillian 0.7.1, some of the changes in
       file_edits.txt are unnecessary.  Please use the prillian_file_edits.txt
       file instead of file_edits.txt.

6) Now need to edit your local copy of each file in the "Files to Edit" list.
   The instructions for editing these files are store in file_edits.txt.  If you
   do not understand the format used, check the Mini FAQ in readme.txt.

   Finish this step up by uploading the edited version of the files to your web
   site.

   Special Note on this Step:
     - If you have non-subSilver templates installed, remember that you need to
       adapt the subSilver file instructions for editing those templates.  The
       features of this hack will not be available on other templates until they
       are edited appropriately.

7) That's it, you're officially done.

8) This is an optional step.
   If the hack has an .hl file in the docs/ directory, you may be able to use
   that.  If you don't know how to use it or what an .hl file is, check the
   Mini FAQ in readme.txt.