BSF4ooRexx, 4.51                          12 May 2015 (Beta)
=================================================================================

This is a package that creates a bridge between ooRexx and Java. For that
reason Java must be installed on your machine as well, which is easy and
a one click away e.g. from <http://www.java.com>. See box below for an
important information.


*******************************************************************************
* *ATTENTION*  Java's bitness must match the bitness of ooRexx ("rexx -v"):   *
*                                                                             *
*    - if ooRexx is 32-bit, then you must install the 32-bit version of Java, *
*    - if ooRexx is 64-bit, then you must install the 64-bit version of Java  *
*                                                                             *
*******************************************************************************

0) If there is a previous version of BSF4Rexx or BSF4ooRexx installed on your
   system, please deinstall it first!

   Best use the menu "BSF4ooRexx -> Installation -> Uninstall".

           [A fallback, manual deinstallation, would be to locate the path to the
           installation directory "bsf4oorexx", named "path2-bsf4oorexx" in the
           following commands, and then run (e.g. by double-clicking) the
           appropriate uninstall script:
           - "path2-bsf4oorexx\install\uninstallBSF.cmd" (Windows) or
           - "sudo path2-bsf4oorexx/install/uninstallBSF.sh" (Linux)
           ]

1) Unzip the installation archive "BSF4ooRexx_install-*.zip" (this will also unzip
   the OpenOffice/StarOffice-support files)

2) change into the unzipped subdirectory "bsf4oorexx/install/windows" or
   "bsf4oorexx/install/linux" or "bsf4oorexx/install/macosx", depending on
   your operating system and then run as Administrator/superuser

   - the setup program named "install.cmd" (Windows) or "install.sh"
    (Linux, MacOSX), e.g. by double-clicking the installation scripts
    ("install.cmd" or "install.sh")

Good luck and have fun!

Rony G. Flatscher
WU Wien
Vienna (Austria, Europe)


P.S.: Alternative installation instructions

Installation of BSF4ooRexx in a Nutshell
========================================

0) If there is a previous version of BSF4Rexx or BSF4ooRexx installed on your
   system, please deinstall it by executing "bsf4oorexx\install\uninstallBSF.cmd"
   (Windows) or "bsf4oorexx/install/uninstallBSF.sh" (Linux) or best: via the
   "uninstall" menu entry in the BSF4ooRexx installation menu.

1) unzip the installation archive "BSF4ooRexx_install-*.zip" (this will also unzip
   the OpenOffice/StarOffice-support files)

2) change into the subdirectory "bsf4oorexx/install"

   - run the Rexx setup program, e.g.

         rexx setupBSF.rex

         - this will create scripts customized matching your installation and
           operating system:

           - on Windows run

                installBSF_runAsAdministrator.cmd

                -> hint: on newer Windows systems the user "Administartor" may not
                         be active, which causes the installation to abort with an
                         error; in that case edit the generated runas-script
                         "installBSF_runAsAdministrator.cmd" and replace the user
                         "Administrator" with the name of a user that has administrative
                         rights (belongs to the "Administrator" group) on your computer

             on Linux run (and afterwards logoff and logon)

                ./installBSF_sudo.sh


3) done.


P.P.S.: Further information can be found in "readmeBSF4ooRexx_next.txt"