This is the top-level ReadMe file for tclIPC V1.00.

1 September, 1992

tclIPC is a library that implements a "send" command for TCL similar to
the "send" command in Tk.  However, it doesn't require Tk.  TCL programs
can connect to other TCL programs and execute commands in their 
interpreters and use the results locally.  The communication model is
peer-to-peer; different than most client-server libraries that are around.

The purpose of this file is to describe the structure of the tclIPC
distribution.

The tclIPC distribution consists of the source and some additional directories
containing some test applications and a required application called the
PortManager.

The source for the library is contained in this directory.  When compiled
the result is libtclIPC.a

The tclpm directory contains the source for the TCL-based PortManager
application, which is required to monitor and store information on
application connections.

The multi directory is a demo application that uses multiple receiver/
interpreters in one process.

Each of the GUI demo directories implements a similar test application
that allows multiple connections to other tclIPC clients.

The xview directory shows how to use the library in an XView program.

The olit directory shows how to use the library in an Xt-based program.

The tk directory shows how to use the library from Tk.

The docs directory contains documentation for users of the library.  It's
a Postscript file ready to be printed.  Man pages are also included
for the C library functions.

Acknowledgements
----------------------------------------------------
Much of this library is based on work done by George Drapeau as part
of the MAEstro Project.  MAEstro is a distributed multimedia environment
built to focus on student authorship of multimedia documents.  The
source is on sioux.stanford.edu.  

----------------------------------------------------
Getting Started

To use tclIPC, read the file "INSTALL" in the
documentation directory.  It contains instructions for installing and
testing the distribution.

----------------------------------------------------
Reporting Errors, Suggestions for Improvements

If you find an error in any of the tclIPC code or would like
to discuss the code or improvements, please send mail to:

	gillies@noao.edu


	Kim Gillies
        National Optical Astronomy Observatories
        950 North Cherry
        Tucson, Arizona   85719
        602-325-9246
