                             Rexx/Gd

                             Contents
                             --------
              1. Installation of Rexx/Gd on Unix
              2. Installation of Rexx/Gd on OS/2 and Windows NT/9x/2k
              3. Testing the installation

Please read ALL of these notes before building Rexx/Gd!


1. Installation of Rexx/Gd on Unix
==================================
To install Rexx/Gd, unpack the archive (you have probably already done
that), run the configure script supplying the necessary command line 
parameters.

Because Rexx/Gd can be configured to run with different Rexx interpreters, 
you must specify the Rexx interpreter you plan on using.
To see the options available, run:

configure --help

If you are interested in building different versions of Rexx/Gd on 
the one platform; like a Regina version and a REXX/imc version
you can do something like this.

To build a version of Rexx/Gd with Regina:

mkdir regina
cd regina
../configure --with-regina
make

To build version of Rexx/Gd with REXX/imc:

mkdir rexximc
cd rexximc
../configure --with-rexximc
make

The configure script looks in some common places for all the libraries (both
curses and REXX).  These are defined in the configure script. Some of the
common directories are $HOME/include, /usr/local/include for header files
and $HOME/lib and /usr/local/lib for libraries.  There are several others;
see configure for the full list.

Once you have Rexx/Gd compiled, it can then be installed.  By default, the
Rexx/Gd executable will be installed into /usr/local/bin, while the 
dynamically loadable external function package will be installed into 
/usr/local/lib.  The base path "/usr/local" can be changed by adding the 
--prefix=path (where path is the base path) to the configure command.
eg. to install Rexx/Gd into /opt/bin and /opt/lib, 
configure --prefix=/opt ...


To install Rexx/Gd, run "make install"

If the platform you are installing Rexx/Gd on does not support dynamically
loadable libraries, you may get some errors during the "make install";
these can be ignored.

Where the platform does support dynamically loadable libraries, you may
need to tell your operating system where these shared libraries are. The
method of doing this varies between operating systems, but generally
involves adding the installed directory to an environment variable such
as LD_LIBRARY_PATH, LIBPATH, etc.


2. Installation of Rexx/Gd on OS/2 and Windows NT/9x/2k
=======================================================
Unpack the archive. You've probably already done this.
Copy all executables and DLLs into a directory already in the system
PATH, or to a new directory, but remember to include this directory
in the PATH. On Windows 95/98, you will need to reboot before the
new PATH is effective.

3. Testing the installation
===========================
Once you have the Rexx/Gd executables and DLLs (or shared libraries)
installed, run the demo program; testtk.rexx.

First run testtk.rexx with the supplied Rexx/Gd executable:

Unix>  ./rexxgd testtk.rexx
DOS>   rexxgd testtk.rexx
OS/2>  rexxgd testtk.rexx
Win32> rexxgd testtk.rexx

Next run testtk.rexx directly with your Rexx interpreter: (using regina
as the example)

Unix>  regina testtk.rexx
DOS>   regina testtk.rexx
OS/2>  regina testtk.rexx
Win32> regina testtk.rexx


