Instructions for installing and using ACP3, version 0.4
-------------------------------------------------------

Updated: Tue Jan 27 21:33:25 1998 by Jeff Dalton


ACP3 is distributed as a gzipped tar file.  The current version
is available from 

   http://www.aiai.ed.ac.uk/~arpi/ACP3/0.4/

There you will find links to a README file, and INSTALL file, and
a tar file.  The INSTALL file is the same as the instructions you
are now reading.  The name of the tar file, when you get it,
should be

   acp3-0.4-27Jan98.tar.gz

ACP3 requires JDK 1.1.2 or later, and it's assumed that the
corresponding "java" command is in the PATH of anyone using ACP3.
The system has been tested only on Suns running SunOS 5.5.1
(Solaris).


To install ACP3:

 1. Make a new, empty directory to contain the system.

 2. Get a copy of the file acp3-0.4-27Jan98.tar.gz and place it
    in the directory created in step 1.

 3. Unpack the release tar file there, e.g. as follows:

      zcat acp3-0.4-27Jan98.tar.g | tar xpf -


The directory you created above must be your current directory when
you run ACP3.  When you are in that directory, the script bin/acp3
will start ACP3.

The bin/acp3-viewer script runs a version that does not do any KQML
monitoring.

To test the installation:

 1. Make sure you are in the right directory.

 2. Type: bin/acp3-viewer

    When ACP3 starts up, two new windows will appear, and some
    debugging output will be printed as the system runs.

    Some window managers may not automatically place the windows
    at their intended locations, in which case they may need
    to be placed manually.  Here is the suggested layout:

    +--------------------------------+  +------------------+
    | ACP3 Main Frame                |  | ACP3 Information |
    |                                |  |                  |
    |                                |  |                  |
    |                                |  |                  |
    |                                |  |                  |
    |                                |  |                  |
    |                                |  +------------------+
    |                                |
    |                                |
    |                                |
    |                                |
    +--------------------------------+

 3. Step through the demonstration by clicking on the numbered
    buttons in the Main Frame window.  The buttons in the information
    window can be used at any time.


As mentioned above, the bin/acp3-viewer script runs a version that
does not do any KQML monitoring.  The following versions are available:

  bin/acp3

     The "default" version.  At present, it is equivalent to bin/acp3-viewer

  bin/acp3-viewer

     The interactive graphical interface set up to be used on its
     own.

  bin/acp3-with-watcher

     The interface plus the KQML monitoring code, for use in the
     TIE 97-1.  To use this, you may need to edit the line that
     sets the ANS_HOST, or you can set an ANS_HOST environment
     variable.  For example:

       env ANS_HOST=gairsay.aiai bin/acp3-with-watcher

  bin/acp3-watcher-only

     The KQML monitoring code without the graphical interface.
     Instead, it simply prints information about the "significant"
     KQML messages it receives.  To use this, you may need to edit
     the line that sets the ANS_HOST, or you can set an ANS_HOST
     environment variable as for bin/acp3-with-watcher.

Further information about using the KQML monitor can be found in
the file README-KQML