====================================================================
Portable Zip Archive ("Stick") Version for Open Object Rexx (ooRexx)
====================================================================

ooRexx (open object Rexx) is an easy-to-learn, dynamically typed, caseless, and
powerful programming language. ooRexx implements the message paradigm that
makes it easy to interact with any type of system.

ooRexx is an open-source project governed by the non-profit, international
special interest group named "Rexx Language Association" (RexxLA).

This version of ooRexx allows you to install several versions of ooRexx on the
same computer in parallel, and choose which version is used on a program-by-
program basis.  It also allows you to install one or more versions in a
removable drive (e.g., in an external USB stick, hence the name "portable")
and carry it along, using it on different machines.

Links:

   ooRexx Project:  https://sourceforge.net/projects/oorexx/
   RexxLA Homepage: http://www.rexxla.org


-------------------------------------
Creating the Portable Scripts (Setup)
-------------------------------------

After unzipping the portable zip archive and changing into the created
subdirectory run

       setupoorexx.cmd   (Windows)
       ./setupoorexx.sh  (Unix)

which will run "setupoorexx.rex" using the Rexx interpreter from its "bin"
subdirectory (i.e., "bin/rexx setupoorexx.rex").

This will create two shell scripts:

      Windows:                    Unix:
      --------                    -----
      rxenv.cmd                   rxenv.sh
      setenv2rxenv.cmd            setenv2rxenv.sh

If the location of the script's home directory has changed simply rerun the
"setupoorexx.cmd" (Windows)/"setupoorexx.sh" (Unix) script to recreate the
two shell scripts picking up the new location.


----------------------------------------------------------------------------
Purpose and usage of "rxenv.cmd" (Windows)/"rxenv.sh" (Unix):
temporarily change PATH to find the portable version of rexx.exe/rexx first
----------------------------------------------------------------------------

   This script will temporarily set up the environment. It expects 'rexx'
   followed by the name of a Rexx program and optionally followed by any
   arguments for the Rexx program, e.g.

       rxenv rexx testoorexx.rex        (Windows)
       ./rxenv.sh rexx testoorexx.rex   (Unix)

   In case "ooRexx packages with oorexxshell" is installed (a subdirectory
   'packages' exists) then oorexxshell can be run as well:

       rxenv oorexxshell                (Windows)
       ./rxenv.sh oorexxshell           (Unix)

   Upon return from the process the shell's environment is unchanged.


----------------------------------------------------------------------------
Purpose and usage of "setenv2rxenv.cmd" (Windows)/"setenv2rxenv.sh" (Unix):
allow to change the environment permanently in a shell to find the portable
version of rexx.exe/rexx first
----------------------------------------------------------------------------

   This script will permanently set up the environment in the current terminal
   shell:

       setenv2rxenv                     (Windows)
       source ./setenv2rxenv.sh         (Unix)

   After executing the script the environment was changed such that the
   portable version of rexx.exe/rexx will be found first for the duration of
   the terminal session. To use it use "rexx" to run Rexx programs, e.g.:

       rexx testoorexx.rex

   In case "ooRexx packages with oorexxshell" is installed (a subdirectory
   'packages' exists) then oorexxshell can be run as well:

       oorexxshell                      (both Windows and Unix)

   To locate the Rexx directory being used by the generated scripts inspect
   the environment variables REXX_HOME, OOREXX_HOME and PATH, e.g.

       echo %REXX_HOME%                 (Windows)
       echo %OOREXX_HOME%               (Windows)
       echo %PATH%                      (Windows)

       echo $REXX_HOME                  (Unix, usually not set)
       echo $OOREXX_HOME                (Unix)
       echo $PATH                       (Unix)


--------------
as of 20240604