                           Rexx/Curses

                             Contents
                             --------
              1. Installation of Rexx/Curses on Unix
              2. Installation of Rexx/Curses on OS/2 and Windows NT/95/98
              3. Testing the installation


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

Because Rexx/Curses can be configured to run with different Curses 
libraries and with different Rexx interpreters, there are quite a few 
options available when configuring.  To see these options, run:

If you are interested in building different versions of Rexx/Curses on 
the one platform; like the X11 version and a text mode version, then 
you can do something like this.

To build a text-mode version of Rexx/Curses with "standard" curses:

mkdir curses
cd curses
../configure
make

To build the X11 version of Rexx/Curses with PDCurses (aka XCurses):

**** Rexx/Curses requires the file; xcurses.h.  This file is actually the curses.h
**** that is distributed with PDCurses.  Either make a copy of this file
**** called xcurses.h or make a symbolic link to it.

mkdir xcurses
cd xcurses
../configure --with-xcurses --with-cursesincdir=somewhere --with-curseslibdir=somewhere
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.

To install Rexx/Curses, run "make install"

If the platform you are installing Rexx/Curses 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/Curses 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/Curses executables and DLLs (or shared libraries)
installed, run the demo program; hanoi.cmd.  It will prompt you for a
number; start with 3!

First run hanoi.cmd with the supplied Rexx/Curses executable:

Unix>  ./rxcurses hanoi.cmd
DOS>   rxcurses hanoi.cmd
OS/2>  rxcurses hanoi.cmd
Win32> rxcurses hanoi.cmd

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

Unix>  regina hanoi.cmd
DOS>   regina hanoi.cmd
OS/2>  regina hanoi.cmd
Win32> regina hanoi.cmd


