=========================================================================== It is important that you already have installed patch1, patch2, patch3, and patch4 before installing patch5. If you have not installed these patches, 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 5 This directory contains the fifth patch for Khoros 1.0. Here you will find two tar files. These are the system and source tar files, "system5.tar" and "source5.tar". IMPORTANT NOTE: Because patch 5 to Khoros is so extensive, we have decided NOT to provide (Megabyte - sized) diffs. You will NOT need the "patch" program to install patch5. Simply get the tar files system5.tar and source5.tar, and install them as described below. Patch 5 Files ------------- 1) system5.tar This tape archive contains two components: "system5.files.Z"-- Which contains all the system files that have changed since the fourth patch. "fix5.system" -- A shell script that will untar the "system5.files.Z" file for you. 2) source5.tar This tape archive contains two components: "source5.files.Z"-- Which contains all the source files that have changed since the fourth patch. "fix5.source" -- A shell script that will untar the "source5.files.Z" file for you. 3) Changes.patch5 Please read this file that summarizes changes to the Khoros system as of patch 5. IMPORTANT NOTE: You MUST use the "fix5.system" and "fix5.source" shell scripts to untar "system5.files.Z" and "source5.files.Z" -- do not attempt the untar procedure on your own. If you attempt to untar either the system files or source files on your own, it may fail because of write-permission problems. Patch 5 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 system5.tar 3) Run the shell script that will apply the third patch to the Khoros system: % fix5.system NOTE: you MUST have the system5.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 fifth patch to Khoros source code. 1) Untar the source tar file by executing: % tar -xvfo source5.tar 2) Run the shell script that will apply the fifth patch to the Khoros source: % fix5.source NOTE: you MUST have the source5.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 allclean % 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", and in Chapter 11, "Kraftsman". Special Notes: Imake: We have made changes to the Imake system. Here is a brief list of changes: 1. If you are compiling on a SUN4 under 4.1.1 and have installed the loader (ld) program patch, or you are compiling on a SUN4 under 4.1.2 you must compile Khoros statically. Make sure you set HasSharedLibraries to NO in the sun.cf file. 2. If you are compiling on a Cray you no longer need pcpp. The standard cpp will now work. 3. We have added the capability for shared libraries for other architectures. However, the rules must still be configured. We have made an attempt to configure the imake library rules for the SGI and HP. We hope someone who is familar with shared libs on these machines will finish the ports and send us the diffs. You will need to modify the file $KHOROS_HOME/repos/config/imake_conf/Lib/{hpLib.rule, sgiLib.rules} depending on the architecture. Also make sure you set the symbol HasSharedLibraries to YES in the hp.cf or sgi.cf file. Documentation: Much of the Khoros documentation has been updated with patch 5. 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.tar and pub/khoros/hardcopy/README This file contains all of the Khoros manual formatted for postscript as of Patch 5. We urge you to update your documentation, we are continuously improving the documentation.