palbum.pl README file
---------------------

WHAT IS palbum ?

   palbum is a perl script that generates and quickly updates
   pretty thumbnail galleries for a directory tree full of image files.

FEATURES

   * No configuration required.
   * Makes thumbnails and index.html files.
   * Fairly intelligent - doesn't generate thumbnails if
     they already exist. Slow the first time you run it,
     fast for subsequent invocations.

INSTALLATION

   It's a standalone perl script -- just run it, or put it 
   wherever you put your executables. It is recommended that
   you have it run automatically from your crontab (running 
   it on the appropriate sub-directories of your website).

USAGE

   palbum.pl dir

   Example: Lets say you have pictures in the following directories

            /www/pictures
            /www/pictures/friday
            /www/pictures/people
            /www/pictures/people/friends
            /www/pictures/foo

   In this case you would do "palbum.pl /www/pictures"
   ( You probably should NOT run it on your entire "www" directory. )

PORTABILITY

   Meant to work on unix-like systems. Has been
   tested on GNU/Linux, FreeBSD, and OpenBSD.

DEPENDENCIES

   The script will usually locate the tools it needs by itself, and
   they're present on most systems. The dependencies are:

      * md5 or md5sum
      * the netpbm package
      * libs for various image formats (used by netpbm)

LICENSE

   MIT style license. Read the source, that's where it is.

WEBSITE

   http://palbum.sourceforge.net

CONTACT

   The primary author is Peter Weisz. You can reach me by email:
      superpete_AT_users.sourceforge.net
   Greetings, bug reports, fixes, improvements, etc. are all welcome :-)

CONTRIBUTORS

   Big Thanks to the following people for testing and suggestions
     Thomas Laubel
     Seamus Hanley
     Ralph Dahlgren
     Uri Elias
     Mike Pagano