
TclProp 1.1 and TkVP 1.0 release

	Project GIMME
	University of Minnesota
	http://www.cs.umn.edu/research/GIMME/
	ftp://www.cs.umn.edu/users/konstan/TclProp-1.1.tar.gz

TclProp defines a set of functions for declarative programming using data
propagation.  TclProp formulas declare relationships among global variables
that are enforced by the TclProp system.  TclProp also includes a trigger
interface and a mechanism for creating variables that are tied to widget
attributes or other states accessible through procedure calls.  TclProp is
implemented entirely in Tcl (including the Tk after command when making 
variables that poll state) and has been tested in Tcl 7.3 and 7.4.  

TkVP is a video poker application built using TclProp.  It is a traditional,
casino-style game, except for the lack of real money :-(.  Besides being an
entertaining game, TkVP is designed as an introduction to using TclProp and
declarative programming in general.  

TclProp and TkVP are copyright (c) 1995 by Project GIMME at the University of 
Minnesota.  TclProp was written by Sunanda Iyengar and TkVP was written by
Susan Herbst, both under the direction of Prof. Joseph A. Konstan in the
Department of Computer Science at the University of Minnesota.  A paper on
TclProp, using TkVP as an example, appears in the Proceedings of the Tcl/Tk
Workshop 1995 (Usenix Association).

Permission to use, copy, modify, and distribute this code and its documentation 
for non-commercial and commercial purposes without fee is hereby granted 
provided that this copyright notice and permission notice appears in all 
copies and that the names of the individuals and institutions holding this 
copyright are not used in advertising or publicity pertaining to this software 
without specific, written prior permission.  The copyright holders make no
representations about the suitability of this software and documentation for 
any purpose.  It is provided ``as is'' without express or implied warranty.  

The card images included in this distribution are subject to a separate
copyright which is specified in the file cards/copyright.h.  

MAILING LISTS

Mailing lists have been set up for the discussion of TclProp and TkVP.  The
TclProp mailing list is tclprop@cs.umn.edu (subscription requests to 
tclprop-request@cs.umn.edu).  The TkVP mailing list is tkvp@cs.umn.edu
(subscription requests to tkvp@cs.umn.edu).  Please send any bug reports or
feature requests there.  Also, please let us know if you make an interesting
use of TclProp.

FILES:

	README		This file.

	tclProp.tcl	The source file for all TclProp routines.

	tkvp       	This file sources all of the necessary files
			to set up and execute the Video Poker game.

	screen.tcl	Sets up the Video Poker display.

	manager.tcl	Sets up the TclProp formulas, triggers, and variables.

	support.tcl	Various procedures used during the execution
			of the game (i.e. procedures to determine 
			winnings, to deal cards, to shuffle the deck,
			to get the rank and/or suit of a card, etc).

	doc/*		Manual pages for TclProp functions and TkVP and
 		        a Postscript copy of the paper "TclProp:  A Data 
			Propagation Formula Manager for Tcl and Tk" by 
			Sunanda Iyengar and Joseph A. Konstan (from the 
			Usenix Tcl/Tk Workshop 1995).  Note:  the major
			change between the paper and TclProp 1.1, besides
			some performance improvements, is the change to the
			prefix TP_ for TclProp commands.

	cards/*		Joseph L. Traub's freely available card bitmaps.

INSTALLATION NOTES:

	As written, the only installation needed is to edit the first few 
	lines of tkvp to point to your own wish (3.6 or 4) and to indicate
	the directory in which TclProp and TkVP are installed (defaults to .).
