===========================================================================
It is important that you already have installed patch1 before installing 
patch2.  If you have not installed patch1, we recommend that you re-acquire 
the system from scratch, as instructed in the install document found in 
/pub/khoros/release/install.ftp (/pub/khoros/release/install.ps) 
on pprg.eece.unm.edu. 
===========================================================================


			KHOROS 1.0  PATCH 2

This directory contains the second patch for Khoros 1.0.  Here you will
find two tar files.  These are the system and source tar files, 
"system2.tar" and "source2.tar".

IMPORTANT NOTE:  Because patch 2 to Khoros is so extensive, we have decided
NOT to provide (Megabyte - sized) diffs.  You will NOT need the "patch" program
to install patch2.  Simply get the tar files system2.tar and source2.tar, 
and install them as described below.  You will need approximately 2M of disk 
space for system2.tar, and approximately 5M of disk space for source2.tar.  

			Patch 2 Files
			-------------
1) system2.tar
This tape archive contains two components:  
   "system2.files.Z"-- Which contains all the system files that have changed 
	              between the first and second patches.  
   "fix2.system"   -- A shell script that will untar the "system2.files.Z" file
	              for you.  


2) source2.tar
This tape archive contains two components:  
   "source2.files.Z"-- Which contains all the source files that have changed 
	              between the first and second patches.  
   "fix2.source"   -- A shell script that will untar the "source2.files.Z" file
	              for you.  


3) Changes.patch2
   Please read this file that summarizes changes to the Khoros system 
   as of patch 2.


IMPORTANT NOTE:  You MUST use the "fix2.system" and "fix2.source" shell scripts
to untar "system2.files.Z" and "source2.files.Z" -- do not attempt the untar 
procedure on your own.  The reason for this is that the PatchLevel file in
$KHOROS_HOME/repos was distributed during Patch 1 as READ-ONLY.  Therefore, 
if you attempt to untar either the system files or source files on your own, 
it will fail because of write-permission problems.


			Patch 2 Procedure
			------------------

1) First, retrieve the appropriate files from pprg.eece.unm.edu and place 
   them in a temporary sub-directory.  

2) Untar the system tar file by executing:

	% tar -xvfo system2.tar

3) Run the shell script that will apply the second patch to the Khoros system:

	% fix2.system

   NOTE: you MUST have the system2.tar file in the temporary sub 
         directory in which you are working.


4 A) SITES WITH KHOROS BINARIES ONLY: If you have only Khoros binaries at 
     your site, you must now ftp to pprg.eece.unm.edu and re-obtain the 
     Khoros binaries appropriate for your system (see the Khoros installation 
     guide for more details).  Binaries are available via ftp for SUN4,
     DECMIPS, and SGI architectures.

4 B) SITES WITH KHOROS SOURCE CODE:  If you have Khoros source files that you
     have compiled in order to use the Khoros system, you will need to run 
     the following series of commands. 

     a) apply the second patch to Khoros source code.

        1) Untar the source tar file by executing:
	   % tar -xvfo source2.tar

        2) Run the shell script that will apply the second patch to 
	   the Khoros source:
	   % fix2.source

        NOTE: you MUST have the source2.tar file in the temporary sub 
              directory in which you are working.
        
     b) Re-compile and re-install Khoros source (see the Khoros installation
        manual for more details).  

	% cd $KHOROS_HOME/src
	% make clean
	% installit

	NOTE: If you have developed new applications under the Khoros system, 
              these must also be re-compiled and re-installed.
	      If you are going to contribute your routines to the Khoros
	      system, you will need to create toolbox(es) for them, and install 
	      them in the toolbox(es) that you create, as described at the end 
	      of the Khoros Programmer's Manual, Chapter 1, "Writing Programs".  
Special Note on Documentation:

   Much of the Khoros documentation has been updated with patch 2.
   The updated documentation is included in system.tar.  If you don't have 
   a postscript formatter, or you do not wish to reformat the manual, then 
   get the file: 
   	pub/khoros/hardcopy/hardcopy.ps   
	     and
   	pub/khoros/hardcopy/README
   This file contains all of the Khoros manual formatted for postscript 
   as of Patch 2.  We urge you to update your documentation, especially
   Chapter 1 of the Khoros User's Manual, and Chapters 1, 4, 5, 7, 8, 9,
   and 10 of the Khoros Programmer's Manual.