Here are instructions on how to run Copycat.  There are two modes for running 
the program: with or without graphics.  

1. If you want to run Copycat with graphics, copy the file 
lisp-init/"lisp-init.lisp.windows" to your top-level directory, naming it
"lisp-init.lisp":

		cp lisp-init/lisp-init.lisp.windows ~/lisp-init.lisp

This is the initialization file that Sun Common Lisp will use to set up
various parameters as well as the window system for running Copycat.
If you want to run Copycat without graphics, copy the file 
lisp-init/"lisp-init.lisp.no-windows":

		cp lisp-init/lisp-init.lisp.no-windows ~/lisp-init.lisp	  

In these instructions, I'll assume that you're running Copycat with graphics,
unless otherwise specified.  

2. If you haven't yet set up Lisp for running Copycat, then follow the 
instructions in the file "how-to-set-up-copycat", which will 
bring you to this point.

3. At the ">" prompt, type:

		(init-ccat 'abc 'abd 'ijk)

to run Copycat on the problem "abc -> abd, ijk -> ?", or a similar instruction
for whatever problem you want to run.  Note that the current version of
Copycat can deal only with problems in which exactly one letter changes
from the initial string (here "abc") to the modified string (here "abd").
More that one letter can be changed from the target-string (here "ijk") to the 
answer-string.  Thus, Copycat can get "abc -> abd, iijjkk -> iijjll", or
"abc -> abx, ccccc -> xxxxx", but it can't deal with the problem 
"abc -> abcd, ijk -> ?", or "abc -> ccc, ijk -> ?".

If you want to run Copycat without graphics, type:

		(init-ccat 'abc 'abd 'ijk :no-graphics t)

4. A menu will appear at the top of the screen with the following options,
all of which are toggles:

    "Set demo graphics off":  Demo graphics is already selected by default:
    leaving this as is will set up the graphics in a way appropriate for 
    giving demos --- no other options need to be set.  
    The coderack is not displayed.  To disable demo graphics (and thus set
    the other options) select this option.
   
    "Set verbose on":  Selecting this will cause the program to produce
    a verbose output (in the Lisp editor window) of what it is doing, and
    will cause it to execute a "break" statement after every codelet run.
    
    "Set slightly verbose on":  Selecting this will cause the program
    to print out (in the Lisp editor window) the name of each codelet
    that is being run.
    
    "Display descriptions":  Selecting this will cause the descriptions
    of each object (in the graphics window) to be displayed.

    "Don't display coderack":  Selecting this will suppress display of the
    coderack.
    
    "Don't display slipnet":  Selecting this will suppress display of the 
    slipnet.
    
    "Don't display temperature":  Selecting this will suppress display of the 
    temperature.
    
    "Slow graphics rate":  Selecting this will slow down the rate at which
    the graphics are displayed.
    
    "Okay":  Selecting this will indicate to the program that you are finished
    setting up the parameters, and will cause the program to proceed.
    
If you select items from this menu, it will continue to appear until you select
"Okay".  The default settings are probably the best for a beginner viewing the
program in action, though you will probably want to experiment with different
settings.

5. I assume you have selected "Okay".  The letters in the problem and the
other graphical displays you selected will now appear in the graphics window, 
after a 1 or 2 minute wait.  The temperature (if selected) appears
as a thermometer at the left of the letter-strings, at its maximum of 100 
degrees (0 is the minimum).  The coderack (if displayed) appears as a bar
graph, with the height of each bar indicating the total relative urgency of 
all the codelets of that type on the coderack.  The slipnet (if displayed) 
appears as an array of squares, with a black box in a square representing
that node's activation level (also from 0 to 100).  A similar menu
will appear at the top of the screen, and you can change your selections
at this point if you wish. If you are happy with your selections, select
"Begin run" from the bottom of the menu.  The program will then begin its run.

6.  When the run is finished, go to step 3 if you want to run another problem.