; -*- Text -*-

To build Explain:

1. You must set the location of the CORALROOT variable in you
environment. This is used in 2 places: Makefile and Explain-imake.

2. Before you build Explain, you must have a working version of Croal
and the Coral translator. You must make sure that the locations of
"coral" and "magic" are in your $PATH variable.

3. You must also have a working version InterViews installed. Explain
has only been tested under version 3.0.1. Make sure that the location
of the InterViews programs are your $PATH variable. Specifically, you
need to have "ibmkmf" available to you.

4. Type "make make". This will make "Explain-make" which is the site
specific makefile for your installation of interviews.

5. Now type "make". This will attempt to build Explain. Ignore all of
the warnings from the compiler. Note: Explain has only been tested
under AT&T C++ version 2.

In order to run Explain, you have to have "magic" in your search paths,
because when Coral modules are loaded, magic rewriting is done by
calling "magic" in a sub-shell via the system() subroutine.

Bill Roth
12/20/92

