WHAT'S GUASH (Version 1.0)?
	Guash (Gimp Users' Another SHell) is a visual shell for loading,
	deleting, copying, moving and mapping a command on image files.

* <-	Lines that start with `*' are added recently (after 1.0.0).

IMPORTANT CHANGES FROM THE PREVIOUS REGISTERED VERSION:
*	(for 1.0.1)
	o Guash works on 8bit screen.
	 (But guash uses shared color map even if install-colormap in gimprc.)
	o This version is two times as fast as old ones in loading thumbnail.
	o Widgets are redrawed correctly after directory scan.
	o The bug that the thumbnail of the 1st image in dir wasn't checked,
	  is fixed.
	(for 1.0.0)
	o Guash uses gtk+-1.0.0 or upper.
	(for 0.99.5)
	o You can resize the window.
	o You can drag-and-drop to copy selected image files on a guash from
	  another guash.
	(for 0.99.2)
	o Guash shares thumbnail files with XV now.
	  (If you used old guash, please delete .guash-cache directories by
	  hand :-)
	o More configurable through gimprc
	o Key accelerations are added.
	o Sort by name/date
	o Symbolic link is shown in green (Sea green).

INSTALL:
*	I think (hope) compilation is easy. Check the definitions
	(especially THUMBNAIL_FONT_* and HAVE_UNISTD_H) in config.h,
	then do:

*	make -f makefile

	But Guash is depended on file operation library or platform
	heavily. Since only linux (debian 1.3/2.0) is available to me, if
	you had to modify the source, please send your patch to me.

*	Some reported problems in compilation are summarized in file BUGS.
*	(You could generate Makefile with GIMP's configure script.)

	If success, mv guash to ~/.gimp/plug-in.

	And move map-on-guash-selection.scm to your (or site) script-fu
	directory. (guash-mapper-sample.scm is a sample file. Move it if you 
	think it's useful.)  

	guash.xpm and wilber-mini.xpm are sample icon files.

CUSTOMIZATION:
	The initial size (# of columns/rows) of thumbnail panel can be
	changed by inserting following declarations to your ~/.gimp/gimprc

	(guash-ncol "5")	# default.	valid range: [4:10]
	(guash-nrow "3")	# default.	valid range: [1:10]

	To delete/rename files without confirmation:

	(guash-confirmor "no")

	If you like emacs-style keybindings, add:
	
	(guash-keybindings "emacs")	# default is GIMP style.

	Furthermore, if you want to operate guash from keyboard (w/o mouse)
	fully:

	(guash-command "all")

	[NEW in 0.99.4]
	If guash crashes after reading a directory which has a lot of image,
	Try:

	(guash-max-images-in-dir 400)	# default.	valid range: [1:2000] 

	With this setting, only the first 400 files in a directory are checked.
	(Thus 400 - (# of dirs + # of non-image files) images are shown in
	the panel.)

	[NEW in 0.99.5]
	For speed up, during a directory scan, guash skips files which have
	one of specific suffixes. You can change the file type by the
	following declaration:

	(guash-inhibit-suffix "core:.ps.gz:.ps:.tar:.tar.gz:.tgz")

	This is the default value. And, as you see, a colon is used as the
	delimitor.
	(Since most postscript files I have are multi-page documents,
	I decided to include "ps:ps.gz" into this list.)

	Note: a period is NOT added before the each pattern automatically now.
	Thus "ps" in the list matches to "*.ps", "*.eps", and further "*ps".
	If you don't want it, use ".ps" instead of "ps". Usually ".eps:.ps"
	would be better.

MAP A SCRIPT ON SELECTED IMAGE FILE:
	The most important feature of guash (or the reason why I decided to
	write guash) is not providing GUI for file operations but mapping a
	script on selected files.

	By typing `!' (or selecting the command from menu), you can do.
	It is done by:

	1. write script file: ~/.gimp/#guash-selection.scm which includes a
            form defining a list of the selected image files.
	2. invoke script_fu_reflesh in order to load the file.
	3. then start script-fu-map-on-guash-selection.
	4. this script maps the procedure given interactively on the list.

	See guash-mapper-sample.scm for samples and
	map-on-guash-selection.scm for its interface.
*	guash-mapper-sample.scm defines the following commands:

	%gm-thumbnail	creates thumbnail files and html fragments
	%gm-to-jpg	converts to JPEG format
	%gm-to-gif	converts to GIF format
	%gm-collect	collects files into a new multi-layered image

* PERFORMANCE:
	Environment:
		PentiumII-300MHz, Memory 256MB, Debian 1.3, XFree86 3.3.? ViRGE
		gtk+-1.0.1 (with private patch for i18n, shared lib),
		gimp-0.99.29, tile-cache-size 32MB
		xv-3.10a
	Test directory with:
		13 BMPs  (640x400),
		50 JPEGs (720x480),
		30 GIFs  (256x256 - 800x600),
		30 TIFF  (256x256 - 1200x1600),
		50 XPMs  (32x32 - 140x70, selected from scwm-icons)

					xv	guash	ratio
	thumbnail generation		64sec	162sec	2.5

	open dir. w/ thumbnails		<1sec	  7sec	50?
	
	Is this acceptable? :-) :-<
	(Note: Openning the dirrectory in 1.0.0 took 14sec.)


IMPLEMENTATION MEMO:
	o guash is a GPLed freeware. The other files in this directory also
	  should be distributed as a part of guash.
*	o Changing directory resets selection. This is not a bug but a spec.
	o I don't know how to use drag-and-drop by button1 and menu by
	  button2/3 on a widget at the same time. Thus I added the ugly
	  "Drag for copy" button. Does anyone know a solution?
	o Redraw widgets after directory scan is strange. Yup, Yup, I know.
	o Display time of the banner is 100 msec. This is (black) magic number.
	  Larger value is more safe.
	o Future features of guash 2.0:
	   - directory scan without updating(using) thumbnails
	   - handling of non-image files
*	   - load thumbnails without drawable/tile (see PERFORMANCE section)
*	  but i don't know when... :-) Furthermore,
*	My account on inetq will be closed at the end of May 1998 !!!
*	I don't know when I come back to the internet.

--
Sat May 16 15:39:36 1998
Shuji Narazaki
      Email: narazaki@inetq.or.jp
      URL:   http://www.inetq.or.jp/~narazaki/TheGIMP/
