BSF4ooRexx Files

BSF4ooRexx, 4.52                          16 March 2016 (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)
           ]

Linux and Windows users:
	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")

MacOSX users:
	1) download the 64-Bit dmg-installation package (e.g.
           "ooRexx420_WithBSF4ooRexx452.20160315-x86_64-MacOSX-beta.pkg.dmg")
        2) Place your mouse over the single package in the dmg file and *right*-click, 
	   choose "Open With -> Installer.app (default)" in order to have that package 
	   be installed on your system
	3) Go through the screens; after you entered your password, there may be a warning 
	   by MacOSX 10.11 (El Capitan), that the package would be incompatible (it is 
	   not!) and that bad things may therefore happen (no bad things happen). 
	   To continue, press "Install Anyway"
	4) Confirm any other popup windows that may appear during installation

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"