The following was tested with S4 (June 1999 version), Splus5.1 and 
Splus6 (beta 2) with Oracle 8.0.4 Enterprise server.

I followed the green book (Chambers' "Programming with Data") as close
as possible, but be aware that Splus 5 and 6 implementations
do differ.  See the makefile for more details.

Oracle Requirements:
--------------------

  You only need the client part of the Oracle distribution.  I've
  done most testing on the machine where the Oracle server runs
  and connecting to multiple servers.

  IMPORTANT:  Make sure you have the Oracle ProC/C++ properly configure
  (e.g., $ORACLE_HOME/proc/admin/pcscfg.cfg in Oracle8), otherwise you
  may run into problems either during pre-compilation and/or linking.

  Shell variables:
    ORACLE_HOME  should be set and exported (sh/ksh) to the Oracle directory.
    SHOME  should be pointing to the Splus home directory, say, 

	  export SHOME=$(Splus5 SHOME)  # ksh
	  setenv SHOME `Splus5 SHOME`   # tcsh

    PATH must include the directory where Oracle's pre-compiler "proc"
    resides, e.g., 
          PATH=$PATH:$ORACLE_HOME/bin

Installation steps:
-------------------

1. untar the S-Oracle_0.3.0.tar.gz into a pristine directory, say

   mkdir Oracle
   cd Oracle
   gtar -xvzf SOracle_0.3.0.tar.gz

2. Create a chapter 
  
   Splus5 CHAPTER
   
3. Create all the S functions by "booting" the CHAPTER

   make boot

4. Compile the C code.  Note that you have to have the Oracle pre-compiler
   "proc" in your $PATH.  Also, you must have initialized SHOME:

   make S.so

   This will generate plenty of warning messages (the ProC/C++ oracle
   pre-compiler generates errors because it can handle MathSoft's cpp
   macro POUND in one of Splus header files.  See the makefile and the 
   "proc.log" error files for more details.

5. Depending on how Oracle was setup, you may need to include 
   $ORACLE_HOME/lib in your $LD_LIBRARY_PATH prior to invoking
   or attaching the Oracle chapter.

That's it.

