Help.txt file for picsize_finder.pl version 1.41, copyright 2000 by Michael K. Goode.

The home of this script is http://www.mikegoode.com/web/scripts/
Check there for any updates, and to see my other scripts.

The actual script is very well commented, at least in my opinion, so this file will deal mostly 
with any possible problems of installation.

First, as of right now, the program does not chmod, so you must manually chmod the directories you
are getting the information from to world writeable. I have tried writing automatic chmoding into
 the program, but for some weird reason it is not working right.


To install, upload this program to your cgi-bin directory, and then chmod it to world-writeable. 
Then, you run it from the URL, calling it from its absolute url location (for example, for me to 
run it would be http://www.mikegoode.com/cgi-bin/picsize_finder.pl?password).
You must configure a password for the program and then enter that after the question mark in the 
url (in the query string, as it is called, for any novices out there)

######################################################################
Program Run-time errors:
######################################################################

There are a few possible ways for this program to run; here are the major possibilities and the 
ways to fix them:

When program called, displays "you do not have permission to access /cgi-bin/ . . ." this means you 
need to chmod the program to world executeable

When called, the program displays an error message "you do not have authorization" and a link to my
 homepage: you did not enter your password correctly in the query string

when called, program displays "cannot chdir": this means it cannot change the root directory to the
 gallery directory. Either you entered the $main_directory absolute location wrong, or you entered 
a wrong name in @directories

when called, the program displays, "could not write to gallery.txt" (or something similar) -- for 
some reason, the program could not write to your $gallery_file, because it was not chmoded 
world writeable. Manually chmod the directory to world writeable and the program will create the
file. 

when called, displays "The End, and displays a list of your $gallery_file  files. That means the 
program parsed. Check the $gallery_file files to make sure it worked, and if it did, then you can 
add titles to the end of each line (with a tab separating the title from the height of the full 
sized image).
#######################################################################

Things that I plan to add to future versions of this program:
1. Automatic chmoding of $gallery_file files(in version 1.51)
2. use of Image::Size.pm, to allow the sizing of any image files (version 2.01).

I am working (and having problems with) both upgrades right now
#######################################################################
Version change history:
######################################################################
Version 1.31: 

First version made public. Makes a tab-delimited text file with the file names and sizes of 
different jpeg images. 

version 1.41

added automatic creation of $gallery_file 's and a few minor things to tidy up the code