INSTRUCTIONS FOR INSTALLING KUIM
        --------------------------------

1) Your first step is to ftp the files source.tar.Z and data.tar.Z
into the directory where you want to install KUIM.  This can be done
by clicking on the "source" and "data" links in the KUIM source page.
Then you must execute the following to uncompress and untar these files.

   uncompress source.tar.Z
   tar xvf source.tar
   uncompress data.tar.Z
   tar xvf data.tar

2) Before you can recompile the KUIM source tree, you need to
add the following lines to be bottom of your .cshrc or .tchsrc
file in order to add KUIM to your search path.  Both gcc and cc
work on most systems, but we use gcc whenever available.

   setenv CC gcc
   setenv ARCH `uname`
   if ($ARCH == 'OSF1') setenv ARCH `uname -p`
   if ($ARCH == 'IRIX') setenv ARCH `uname -p`
   if ($ARCH == 'Linux') setenv ARCH `uname -m`
   if ($ARCH == 'SunOS') setenv ARCH $OSTYPE
   setenv KUIM /users/jgauch/kuim
   setenv CLASSPATH $KUIM/bin/java/
   setenv LD_LIBRARY_PATH /tools/java/$ARCH/jdk.1.1.1/lib
   set path = ($KUIM/csh $KUIM/bin/$ARCH /tools/java/$ARCH/jdk1.1.1/bin $path)

The settings above work for our DIGITAL, SGI, and SUN workstations 
and our PCs running Linux/WinNT but may need editing to be 
appropriate for your system.  The KUIM variable should be
changed to reflect the location of your kuim directory.  Also 
the Java settings will need to be edited to use your Java directory.

3) Then you need to type "source .cshrc" and "rehash" and then
execute the KUIM shell script "Compile" which will compile
all 100+ programs and put them in the appropriate bin directory.
This will take 10-20 minutes on most machines because the system
contains over 60,000 lines of code.  If you wish to compile only a 
few programs, you can use the "Install program_name" script after
the libIM, libFFT, and libJPEG libraries are compiled.

4) If you have multiple machine types on your network, you need
to rlogin to one of each and run "Compile".  The environment
variable $ARCH will be used to determine what bin directory
to include in your search path when you are running KUIM programs.

	USING KUIM ONCE IT HAS BEEN INSTALLED
	-------------------------------------

1) If you are using KUIM which has already been installed, add the
above to your .cshrc file (edit the KUIM definition as needed).
The next time you login you will have access to KUIM.

2) Please see the COPYRIGHT notice.  "This software is based in part 
on the work of the Independent JPEG Group", in particular the JPEG
image compression support.  Finally, if you find any bugs let me know.  
We will do what we can.  Have fun.

   Prof. John Gauch.  
   Department of Electrical Engineering and Computer Science
   The University of Kansas
   jgauch@tisl.ukans.edu