// $Revision: 1.11 $

Copyright (C) 1994, 1995 Taligent, Inc. All rights reserved.

1.0.0 RELEASE NOTES FOR THE CONCURRENT ACTORS PROGRAM

Concurrent Actors is provided with the CommonPoint(TM) application system 
version 1.0.0 for AIX(R).  This program combines exemplary code to support 
learning from example.
 
Before getting into the code, be sure to review the "Concurrent
Actors" chapter of the Documented Samples book. This
documentation orients you to the program architecture and point
you to specific task solutions.


SETTING UP THE PROGRAM

In order to run ConcurrentActors (without building it first), 
use the TaligentSamples.install script. See
$TaligentRoot/TaligentSamples/README.TaligentSamples for instructions. 
This will install a number of sample binaries and ancillary files 
into your system.


RUNNING THE PROGRAM

To bring up a ConcurrentActors document, first start CommonPoint if it is not
already running.

        cd $TaligentBinaries
        CommonPoint

To run the program, enter (all on one line):

        RunDocument -c 
           "TGUIModelViewStationeryFor<TSimulationModel,TSimulationView>"
           ConcurrentActors -o ConcurrentActorsStore

Once the program comes up, click in the Concurrent Actors window to start
the simulation.  Response is very slow.  Don't worry about your ship being
run over by an asteroid; it's set to be indestructible.  Once the
program is going, use the following keystrokes to play.

Turn counterclockwise:    j
Turn clockwise:           l
Move the ship forward:    k
Fire bullets:             space bar

To open an existing Concurrent Actors document, enter:

        RunDocument -o ConcurrentActorsStore

To delete an existing document, enter:

        RunDocument -d ConcurrentActorsStore


You may also use the ConcurrentActorsApp script to run the program.  This
script is just a wrapper for the RunDocument commands above. 

        ConcurrentActorsApp ConcurrentActorsStore

If the document named ConcurrentActorsStore exists, the script will
open it.  Otherwise, the script will create a new document called
ConcurrentActorsStore.


If Concurrent Actors or the CommonPoint(TM) application system crashed
previously, delete the document using the RunDocument -d command
above.


BUILDING THE PROGRAM

1.  Build the Concurrent Actors binary.  This will copy the appropriate
    binaries, scripts and export files to the correct directories.

        cd $TaligentRoot/TaligentSamples/Supported/Apps/ConcurrentActors
        Makeit

2.  Start CommonPoint

        cd $TaligentBinaries
        CommonPoint
        
3.  Build the ConcurrentActors archives.

        cd $TaligentRoot/TaligentSamples/Supported/Apps/ConcurrentActors
        Makeit Archives

        
        
KNOWN PROBLEMS

Embedded more than one component into ConcurrentActors will eventually crash 
the program.