README file for "CirclePack, Version 4.x" and related files. (1/98)

****************************************************************
Programs by and available from Ken Stephenson, 
Dept. of Math., University of Tennessee, Knoxville, TN 37996-1300
Phone (423) 974-4330, e-mail kens@math.utk.edu
http://www.math.utk.edu/~kens
****************************************************************

	Copyright (C) 1993-98. Notice: The program "CirclePack" 
	is copyrighted by Ken Stephenson, 1992 -- 1998.
	They may be distributed under the terms and conditions of 
	the "GNU General Public License".


The program "CirclePack" is a C program written for the creation,
display, manipulation, and storage of circle packings using the 
X-Windows GUI. For more details, see the help file: "cp_help.info" 
included with this package. 

The author gratefully acknowledges the support of the National
Science Foundation and of the Tennessee Science Alliance during the 
period in which these programs were developed.

====================

Installation: 
(Help from a qualified systems administrator is recommended.) 

1. Move to the parent directory where the program will reside.

2. Load the tarred and compressed file downloaded over the web.
For the "linux" operating system, this will be "CP-linux.tar.gz",
for Solaris it will be "CP-solaris.tar.gz", and for SunOS it
will be "CP-SunOS.tar.gz".

3. Give the command "zcat <name>.tar | tar xvf -". This will
create the subdirectory "circle" and further subdirectory 
"packings" and will put all files in place.

4. The executable is "CirclePack"; when possible it is statically
compiled (and hence large), but should need no special libraries. 
There may be problems with colors and the user may have to close 
other color programs (e.g., netscape).

5. The source code and possible makefile are included for those
who want to recompile. This requires various XView files.

6. The "packings" subdirectory contains sample data sets.

7. The easiest way to try the program is to use one of the 
demonstration "scripts", which have extension ".cmd". Simply 
type 

	CirclePack demo.cmd

When the windows open, look for the "Script Window" and 
execute strings of prepared commands by pressing the button
labeled "Execute next cmd".

8. Press the "Help file" button to get a file describing the commands.
======================
