usage for ogre (OpenGallery REcursive):
	To run opengallery, first cd (change directory) to the directory with all the image files.  opengallery and ogre are used interchangably in this and other documents.
	"ogre -r" is the recommended mode to run.  This supports recursion (-r) as well as javascript highlighting in the generated website.  ogre will take care of generating the thumbnails in addition to creating the html and javascript.  Thumbnails are stored in the ".thumbnails/" subdirectory for every dir in the tree that has image files.  Information about these thumbnails is also stored here to save time during the next run of ogre (to refresh the dirtree in case more images have been added / taken away).
	For most consistent results, run "ogre -r" from the topmost directory of images first.  This is because the background color for each dir is generated when ogre is run and stored in each directory's ".thumbnails/" subdirectory.  If there are too many subdirs to fit on one line in a web browser, ogre splits the list into multiple rows.  The worst that can happen if one doesn't follow this advice (running ogre -r from the top of the tree first) is that adjascent blocks will have the same color (and thus it will be difficult but not impossible to tell which rows of subdirs go together).
	Giving "ogre smurfs cars" produces the same result as if you went to the smurfs dir, ran ogre and then went to the cars dir and ran ogre there.
	For more information on usage, try "ogre -h".

usage for some helper utilities (found in the contrib/shell-scripts/ dir):

	usage for fix-image-file-filenames:
		If there are any files that are 'improperly' named, ie blah.jpg or penguin.GIF or Snail.tif, then it will be good to run "contrib/shell-scripts/fix-image-file-filename-extensions" from the dir where the files exist.  This will rename those files to blah.jpeg, penguin.gif and Snail.tiff.  "-r" to recurse subdirectories.  (This script is no longer necessary for use with opengallery >= 0.1-7, but it's still handy)

	usage for modify-filename-extensions:
		"modify-filename-extensions <original-extension-wildcard> <final-extension>"
		examples:
			"modify-filename-extensions [tT][xX][tT] text" moves all files .txt .TXT .tXt etc to .text
			"modify-filename-extensions tif tiff" moves all files .tif (only) to .tiff

	usage for tilt:
		"tilt <image-file-name list...>" ...self-explanatory, but:  tilt takes each image listed on the command line and tilts or rotates it 90 degrees with ImageMagick's convert (through the use of a temp file - and then swaps the two and deletes the now deprecated version which is named as the temp file was).

	usage for recurse:
		First, set dome_dir and dome_file to the shell script or shell function to perform on dirs and files, respectively.  Second, run "recurse"
		examples:
			dome_dir='ls *.txt'; dome_file=''; recurse
				this just goes through a dirtree and lists all the .txt files.
			dome_dir='chmod 755 *.sh'; dome_file='echo '; recurse
				this will echo each filename in the dirtree and changes the permissions of each .sh file in the dirtree to 755 (rwxr-xr-x)