  /////////////////////////////////////////////////////////////////////////////
  // This file is part of Bevey (www.bevey.org)
  //
  // Copyright (C) 2011 Bevey.org
  //
  // You can redistribute this code and/or modify it under the terms of the
  // GNU General Public License as published by the Free Software Foundation;
  // either version 2 of the License, or (at your option) any later version
  /////////////////////////////////////////////////////////////////////////////

  /////////////////////////////////////////////////////////////////////////////
  // I.    License
  // II.   Requirements
  // III.  Installation
  // IV.   Use
  // V.    API
  /////////////////////////////////////////////////////////////////////////////

  /////////////////////////////////////////////////////////////////////////////
  // I. License
  /////////////////////////////////////////////////////////////////////////////

  For full licensing information, view the included LICENSE.txt

  Bevey has no warranty - neither expressed nor implied.  We cannot be found
  liable for any loss of data, equipment, value of time or any other loss.

  Bevey has been made available in the hopes that someone may find it useful.
  Please don't abuse this gesture.

  /////////////////////////////////////////////////////////////////////////////
  // II. Requirements
  /////////////////////////////////////////////////////////////////////////////

  * PHP 5.2.0+
  * Apache
  * GD with support for jpg, gif, png and bmp
  * mod_rewrite
  * Bevey has only been tested on Unix based systems

  /////////////////////////////////////////////////////////////////////////////
  // III. Installation
  /////////////////////////////////////////////////////////////////////////////

  * Unzip the gallery.zip.
  * Check the requirements in II.
  * Ensure you have the newest version by comparing the value of the contents
    VERSION.txt to the download page.
  * Open Gallery/settings.php
  * Edit the $_address variable to reflect the location that the page will live.
  * You may edit other values in Gallery/settings.php - however most have sane
    default values.
  * Upload the contents of the Gallery/ directory to your webserver - which
    must match the $_address variable set in the step above.

  /////////////////////////////////////////////////////////////////////////////
  // IV. Use
  /////////////////////////////////////////////////////////////////////////////

  * To create a new gallery, upload a directory with the name of the gallery
    you want to create into the images/ directory.
  * To give a more elaborate name (or a name different from the path), you can
    upload a text file with the directory name containing the description.
    Example: Uploading the directory My_Pets, you may upload a text file into:
             My_Pets/My_Pets.txt that contains the description of that
             gallery.
  * Upload only the original sized images into this gallery directory.
    Thumbnails will be generated automatically.
  * To give a more elaborate name (or a name different from the path), you can
    upload a text file with the image name containing the description.
    Example: Uploading the image My_Pets/My_Cat.jpg, you may upload a text
             file into:
             My_Pets/My_Cat.txt that contains the description of that image.
  * Once you've uploaded your images, visit the page so that the thumbnails may
    be generated (you may need to reload the page if there are many images).
  * If the page seems "stale", it's likely that an older instance has been
    cached.  Visit the page: http://example.com/clear to clear your cache.
    NOTE: Because this path is reserved for clearing your cache, "clear" cannot
          be used as a gallery path.

  /////////////////////////////////////////////////////////////////////////////
  // V. API
  /////////////////////////////////////////////////////////////////////////////

  An API is built in with the hopes that it will be useful for Flash (or other)
  developers to use this for image management and resizing.  The API pages are:
  http://example.com/index.xml (XML of available galleries)
  http://example.com/My_Pets.xml (XML of available images within a given
                                  gallery).
  NOTE: Serialized PHP and JSON API outputs are also available.  Simply change
        the ".xml" file extension to ".json" or ".php" for your desired output.