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.

IMPORTANT CHANGES FROM THE PREVIOUS REGISTERED VERSION:
	(for 0.99.5)
	o Guash uses gtk+-0.99.4 or upper
	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 value of CFLAGS in
	Makefile (the default is for linux), then do `make'.

	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.

	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 is a sample image file for icon for guash.

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):

	(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
	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. It defines some procedures. For
	example, to create thumbnail files and html fragments, links to
	selected images.

IMPLEMENTATION MEMO:
	o guash is a GPLed freeware. The other files in this directory also
	  should be distributed as a part of guash.
	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 in guash 2.0:
	   - directory scan without updating(using) thumbnails
	   - handling of non-image files
	   - but i don't know when... :-)
	o Unregistered, under-development version will be placed on my web
	  page (see the URL below).

--
Fri May  1 00:00:14 1998
Shuji Narazaki
      Email: narazaki@inetq.or.jp
      URL:   http://www.inetq.or.jp/~narazaki/TheGIMP/
