These directories contain some (but not necessarily all) of the HCS/HRPC
software.  This file gives some hints on how to go about installing the
software on your system.  And I do mean hints:  There is a reasonable
expectation (i.e., "it works for us") that things will go off without a
hitch; however, there is \no guarantee/ that major hacking of your own will
not be required.

Preliminaries:
--------------

1) The tape is written in tar format.  The hierarchy is ./HRPC.
2) There is anywhere from 1.5 to 4 MB of source code on the
   tape.  The minimum figure is for the HRPC/LWP code itself.
   This will expand to about 2MB after everything is compiled.
3) Please do not redistribute this code without consulting the
   Dept. of Comp. Sci., University of Washington.  We like to know
   who is working with this software.

Installation Instructions:
--------------------------

You will need write access to the following "public" directories:
	/usr/include
	/usr/local
	/usr/local/lib
	/usr/new/lib

After extracting all files, do the following:

1) Make a symbolic link from /usr/include/HRPC -> ./HRPC.  If you
   wish, you can later create a directory /usr/include/HRPC
   and copy all the .h files plus the subdirectories HRPC/CIncludes,
   HRPC/LispIncludes, HRPC/Interfaces.

2) cd HRPC/StubGen
   make install

   This will leave the stub generator (hrpcstubs) in /usr/local.

3) cd HRPC/Interfaces
   make hrpcfiles

   This runs the stub generator over some .cr files, generates more
   standard interface include files and adds OTW routines for some
   well-known data types to the HRPC library.  You can safely ignore
   the "Warning" messages from the stub generator.

4) cd HRPC/HRpcRTS
   make install

   This will leave the run-time library in /usr/local/lib/libHRPC.a
   N.B.: If you wish to use autoactivation, you must use a special
   versions of the Unix daemons that server as binding agents for the
   SUN RPC and Xerox Courier protocols.  These are contained in
   HRPC/Binding/Activation.

5) cd HRPC/LispIncludes
   make

   You will probably want to change some path names in runTimeDefs.l.

6) Create a directory called /usr/new/lib/HRPC.  This will eventually
   contain the fakeNS and (possibly) actPrefs files.  The uses of
   these files are explained in detail in the HRPC User's Guide.  Troff
   source for the UG is in HRPC/Doc.  You should probably read this
   before you go any further.

As mentioned, there is a reasonable expectation that items 1-6 will go off
without a hitch, but no gurantees.  The directory HRPC/TestCases/ contains
some simple test programs.

------------------------

Some distribution tapes contain the following additional directories.

HRPC/NameServers:
	The HNS system, including a special version of the Berkeley
	nameserver (BIND).

HRPC/THERE:
	The THERE remote execution system. Have fun.

No effort has been made to make a "product" out of the following items.
There should be enough here that, if you want to spend the time, you can
actually get all of it to compile.  The problems are almost exclusively
organizational or related to OS dependencies, rather than being code that is
known to be buggy.
