#
# README
#
#   Demers, November 1, 1988 4:30:09 pm PST
#   Weiser, December 1, 1989	
#   Boehm, September 17, 1991
#

See below for installation instructions.

Some terms:

CONFIG:  A config is a build of the system with a particular set of switches.
At one time there were many kinds of configs, like Threads, PseudoThreads,
StandAlone, and SoftCard.  Currently there are only two: Threads and
OptThreads.  (OptThreads will duplicate the SOSP performance numbers when
run on an appropriate machine.)

It is easy to add new configs: the makefile explains, and gives examples of,
how.

This subtree contains the following

INCLUDE:

    header files

BIN:

    A subdirectory for each config, containing executable files associated
    with that config.

LIB:

    A subdirectory for each config, containing libraries associated with the
    config.
    
    In particular, for each config there is a library named "xr.a" which
    contains the components of the runtime itself.  The object file XRRoot.o
    has undefined external symbols that cause the entire runtime to be loaded.

SRC:

    A single directory containing all sources.  (Pointing dbx at this directory
    can be useful.)

MAN: 

    Manual entries.

INSTALLATION INSTRUCTIONS:

0. Don't be afraid to read the makefile ... it's pretty heavily commented.

1. In fact, the first thing you need to do is edit the makefile.  It starts
out with a couple of variables:

    XR_HOME = ...
    INSTALL_BIN = ... (e.g. /usr/local/bin)
    INSTALL_MAN = ... (e.g. /usr/local/manl)

These should be changed to reflect local conventions at your site.

The definition of IFLAGS in makefile.common mentions the group cedarruntime,
which probably doesn't exist on your system.  Change it to the group
you would like to be the owner of object files.

2. Then execute

    make install1

This will recompile every config, then rename the DIST subdirectory to the
actual PCR version and create a symbolic link to it named INSTALLED.

3. Once step 2 has completed, execute

    su bin
    ...
    make install2

(replace "bin" above by whatever user owns your INSTALL_BIN directory; in some
installations that's root (shudder)).

By default, if you didn't change INSTALL_BIN and INSTALL_MAN, then
make install2 will make directories called testbin and testman in XR_HOME
which you can try out.
