Soar 7.1 UNIX Installation Instructions (Proposed)
Christopher R. Waterson
waterson@eecs.umich.edu
4/4/97

(UNDER CONSTRUCTION)

Installation
============

1. Installing Tcl & Tk
======================

You should install Tcl & Tk first. If possible, compile at least Tk
(and preferrably Tcl as well) with the "--with-shared" option
set. This may require some monkey business in the makefile; e.g., if
you use gcc, you may still need to use the vendor-supplied linker.

Install the Tcl & Tk package somewhere "reasonable" on your system;
e.g., /usr/lib or /usr/local/lib.



2. Building Soar
================

You'll need to keep the source around for Tcl at least. Soar needs to
have "tcl.h" to compile, and the current makefiles assume that it'll
be in "../../tcl7.6/generic" (relative to soar-7.1/generic and
soar-7.1/kernel, that is).

I haven't figured out autoconf yet, so you'll have to take the
makefiles as is and perhaps hack them for your system. I've tested
them on SunOS, IRIX, and Linux, and the seem to work. The only one
that needs a little tweaking is the "generic" makefile: there's a note
where you may need to comment/uncomment things.



3. Installing the Soar Package
==============================

1. Start a Tcl shell and type "set tcl_pkgPath" to determine the path
that Tcl will use to find packages; for example, "/usr/local/lib" on
Linux.

2. Create a subdirectory in this directory called "soar"

3. Copy the Soar extension shared library to this directory.

4. Copy all the files from the "soar-7.1/library" directory to this
directory. (Do NOT create a subdirectory "library"! For example, if
you're installing to /usr/local/lib, there should be a file
/usr/local/lib/soar/soar.tcl.)

5. Change yor working directory to the new "soar" subdirectory, start
a Tcl shell (using tclsh or wish), and type the following commands:

	% pkg_mkIndex . libsoar7.1.so

This will create a package index script for Soar, "pkgIndex.tcl".

6. Now you should be able to type "package require Soar" to load the
Soar extension into any Tcl interpreter.