This is the root directory for software comprising the automated
telephone data collection system based on the Linkon project.
There are three important pieces to this system:

 - a GUI-oriented application builder (generates a script)
 - a driver program that runs data collection (reads this script)
 - a collection of C++ classes that provide a high-level interface
	to the Linkon system (used by the driver program).

INSTALLATION:

The first step in installing the software is to decide where to place
the distribution on your file system. Place the file linkon.tar in the
parent directory of where you wish the system to reside. For example,
if you wish to have a directory /usr/local/isip/linkon, you would
untar from /usr/local/isip, the linkon directory will be made
automatically.  The following commands would be necessary for this
example:
 
 mkdir /usr/local/isip;		
 mv linkon.tar /usr/local/isip;
 cd /usr/local/isip;
 
Next, untar the distribution.

 tar -xBf linkon.tar

This will create the directory ./linkon, placing all software
within. In order to load the environment needed to either install or
run the software:

 cd linkon
 . ./LK_SETENV.sh

You now have environmental variables: 
  LINKON=/usr/local/isip/linkon   base directory of the system
  ISIP_BINARY=??		  what platform you are using
  ISIP_CPLUS_COMPILER=gcc	  compiler
  PATH				  updated path

Next, build the software by executing the script

 ./Make.sh

This will build all relevant software and install it as necessary. The
software, as all of ISIP's public domain code, is written to be
compiled with GNU gcc and GNU make; Make sure that GNU make is highest
in your PATH. Also, the 'ar' command must be in your path. It can be
found typically in /usr/ccs/bin/ar.

In order to run the application builder GUI, type

 lk_appbuilder &

This is an X windows application, so your DISPLAY variable must be set.

Don't forget that you must setup your environment with:

 cd your_path/linkon
 . ./LK_SETENV.sh

before running the software each session.

Report any problems to admin@isip.msstate.edu.

A NOTE ABOUT TCL/TK:

While the software written is fairly independently, it does require a
few packages to be installed (and visible) on your system. TCL and Tk
are necessary to run the application builder. The GUI was written
using TCL version 7.5 and Tk version 4.1 or greater. In the interest
of making our software easier to install and maintain, no third party
extensions to TCL/Tk are used, the standard distribution will
suffice. TCL/Tk can be easily found on a variety of anonymous ftp
sites, including ftp://www.smli.com/pub/tcl. The tk executable "wish"
must be in your path for the application builder to run.

DIRECTORIES:

An overview of the directory structure is as follows:

bin/			binaries
class/			class source code
doc/			documentation
include/		C++ include files
lib/			run-time libraries

local/			local copies of stuff on the ISIP system
local/isip/		ISIP's standard files (makefiles, headers, etc)
local/linkon/		Linkon-specific files
local/sphere/		NIST sphere file formatting functions

proc/			keeps track of what is running on the board
util/			source code for utilities found in bin/