# written ?? 2001 by Matthew Andrew (mzandrew@users.sourceforge.net)
# updated July, 2001
# updated a bunch - November, 2001
# updated to work with non-jpegs and to append .jpeg to thumbnails - February 16, 2002 - version 21a descended from 20 (not 21)
# updated to work better with non-jpegs and added a couple things - July, 2002
# licensed under the GNU GPL on July 11, 2002 initial version 0.1 - name changed to opengallery
# further notes in doc/changelog

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
things todo:

	(also check the RFE at sf.net...)

	need an option to sort by filename

	need an option to sort by file date

	make link to entire tree of children & descendants (site map style)
	maybe this is unnecessary/extraneous
	no, this is good
	root { descendants... } tree

	check the rez of each thumbnail to make sure it's the currently desired res
	this is slow
	also, if a thumbnail file's contents change, opengallery happily continues without fixing it.
	make a script to go through a heirarchy and check thumbnails to see whether they're corrupt / the right resolution.  or make that an option for ogre.

	add ability to ignore dir in everything with existance of file ".thumbnail/skip"

	add ability to ignore dir in count with existance of file ".thumbnail/nocount"

	add ability to ignore dir in index/listing with existance of file ".thumbnail/noshow"

	change 'tree' to 'subdirectories' or 'subdirectory list'

	parameterize the 'galleries with missing dirs' filename and the list of bad thumbnails - make sure to take out the ~ if they're absolute filenames

	make a command-line option to just go through and write color files ("-c" maybe)

	make a command-line option to just go through and make requisite thumbnails

	make sure html output conforms to the spec.  there is still the lingering frameborder=0 problem.

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
working on:

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
thingy todo maybe - I forgot whether it already does this:

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
things that are done:

	put the opengallery junk removal script in the user's $HOME/bin/ dir if bin/ exists, otherwise $HOME

	add build and release scripts to repository and share them

	optionally cull output junkiness (quiet mode)

	performance is slow.  could write a c program to get the nth line from a file or to sort the list of images (by aspect).  These would speed up the non-thumbnail-generation parts of the program.

	make sure error messages (and only error messages) go to the error device - this is done for process, internal_process and make_thumbnail

	remove extra files from thumbnails dir
	partially done - removes 'sane'-ly named extra thumbnails that are referenced in thumbnails.info
	this only removes thumbnails listed in the .info that no longer correspond to actual files
	generate list of unused .thumbnails/ files
	make sure not to delete things like 'color' and 'thumbnail.info' and 'skipme' and 'hideme'

	take initializations out of the initializations file and hard-code them into the opengallery function so all of src/ can be sourced exactly once, from ogre.  then rename the init file to something better

	somehow make sure it's obvious from which part of the tree (one level up) that the current dir inherits
	somehow highlight current choice - javascript may be necessary :(

	generate stats

	include optional recursion; display totals for everything (thumbnails updated, errors, etc)
	do this from ogre, with some sort of non-named piping or something

	make light pseudorandom pastel colors the backgrounds for the different tree levels
	alternate white and light-grey

	maybe incorporate the colors thing and the ?? thing into some way to pass info between ogre and opengallery to allow for alternating background colors and a totals output.  should be okay to run scripts that update files in .thumbnails without having to re-run ogre on them.  this will be consistent until the next running of ogre, when everything is updated at once.  this is good for the tree thingy so clicking on trees/ in some destinations/ subdir will update a higher-level frame in the set of tree frames.  Maybe should make opengallery script into a function.  This will simplify the message passing interface.

	add up the letters in the dir names and do a browser width guesstomation and wrap as much as is necessary

	fix names of 'bad' files:  blah.Jpeg blah.jpEg (extensions should be all lower-case)
	works with manual use of fix-image-file-filename-extensions [-r]
	not necessary anymore as of 0.1-7

	display a this-many thumbnails need to be created output

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
don't do these:

	if all the images are portraits, the full width of the thumbnails frame is not necessary
	but maybe it's not good to change the parent width
	it's also not good here because more than 2 portraits can fit in any row

	stop netscape 4 from crashing
	screw that - use mozilla

	clean up output while running
	not much extraneous there though

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *