# --------------------------------------------------------------- #
# -- Copyright (c) 1994, 1995 Computer Sciences Department,    -- #
# -- University of Wisconsin-Madison, subject to the terms     -- #
# -- and conditions given in the file COPYRIGHT.  All Rights   -- #
# -- Reserved.                                                 -- #
# --------------------------------------------------------------- #

SHORE (Scalable Heterogeneous Object REpository) is a persistent
object system under development at the University of Wisconsin.
This ftp directory contains the first general release, version 1.0,
of the Shore software.

This release includes improved documentation, more complete
implementations of many SDL features, many bug fixes, and ports to
Solaris, HP-UX, Linux.

There are three parts to the release: documentation, binaries (with
and without debugging support) and sources.  These are available
as the following files gzip compressed tar files:

    shore.1.0.doc.tar.gz
    shore.1.0.solaris.2.5.sparc.debug.tar.gz 
	(or shore.1.0.solaris.2.5.pentium.debug.tar.gz)
    shore.1.0.solaris.2.5.sparc.nodebug.tar.gz
	(or shore.1.0.solaris.2.5.pentium.nodebug.tar.gz)
    shore.1.0.src.tar.gz

    and of course, README (this file)

To use the software, you will at least need to get the documentation
release and one of the binary releases.  The debugging binaries contain
debugging symbols and auditing code, and therefore are 2-4 times
slower and over twice as large as the non-debugging version.

Grab the documentation and whatever other releases you want,
using FTP.   Put them in any directory.

For all the installation instructions, we use two
variables, so that you can "cut and paste" the instructions. 

	set TARDIR=directory-that-holds-tar-files
	set SHROOT=directory-in-which-to-install-shore

If you use the Bourne shell (/bin/sh) or one of the shells
derived from it, such as ksh, omit the word "set".

To install the software, untar the documentation release:

    # make a directory to hold the installation
    mkdir $SHROOT
    cd $SHROOT
    gunzip -c $TARDIR/shore.1.0.doc.tar.gz | tar xvf -

To finish installing the software, read the document 
titled: The Shore Release.  The HTML version of
this document is called release.html.  You can read
it with a World-Wide-Web (WWW) browser such as Mosaic,
Netscape or Lynx at the URL:
    file://localhost/PATH_TO/docs.html/release/release.html
Of course, "PATH_TO" should be replaced with the path to the
directory where Shore is installed.

The Shore Release document contains hyper-link pointers to
all of the release documentation (including the installation
manual).

Postscript versions of the documents are available in docs.ps/.

If you have questions, comments or bug reports, please mail
them to shore_support@cs.wisc.edu.  For instructions on how to
report problems, see PATH_TO/docs.html/bugreport/bugreport.html.

Information on Shore-related publications, mailing lists
and project status is available on the Shore project homepage at:
    http://www.cs.wisc.edu/shore/
Also, online versions of the documentation are available.