------------------------------------------------------------------------------

Short info:

Standalone application that is launched using the XULRunner framework.
A little XUL dialog receives an URL, calls JavaScript to create a Java Class Loader and instantiate a custom Java class, which launches an ooRexx script. The script uses the XPCOM environment to load the given URL.

How to start the application: 
	option 1.) double-click on start.bat
	option 2.) go to cmd.exe/shell and invoke: 
				xulrunner.exe path-to-application.ini
------------------------------------------------------------------------------
Prerequisites:

	1.) Java Runtime Environment (tested with Java 1.6.0_18, JRE v.6)
	2.) Javascript Rhino (tested with version 1.7R2)
	3.) Jakarta BSF support (tested with BSF v.2.4.0)
	4.) ooRexx installation (tested with version 4.0)
	5.) BSF4ooRexx support (tested with version 4.0.0, Oct. 2009)
	6.) XULRunner installation (tested with XulRunner v. 1.9.2)
------------------------------------------------------------------------------
Customizing:

In order to use this application you have to change some path names in the following directories:

	1.) /chrome/xulrunner/JavaClassLoader.js (function useClassLoader())
		--> change "myJar" to the path of "javaExtensionUtils.jar"
		    this path should be right if you unzip the app to your Desktop!
		--> change "bsf1" and "bsf2" to the jar files of your BSF directory.
		--> change "xpcom1", "xpcom2" and "xpcom3" to the jar files of your XULRunner/bin directory.

	2.) /chrome/xulrunner/Window.rex
		--> change "grePathName" in the 1st line of code to the directory of javaxpcom.jar, usually the XULRunner/bin directory.

	
If you launch your application using start.bat, start.sh or using the shell command from the xulrunner top level directory, customizing step # 3 will not be necessary. If you want to e.g. launch this application from another program, do this step.
	3.) /chrome/xulrunner/java/JavaBSF.java
		---> change "scriptName" and "log" to the absolute path of your ooRexx script Window.rex and your Error Logger file 					ErrorLog.txt (if necessary)
------------------------------------------------------------------------------
Files: 

	xulrunner/  (Top level directory, entry point of this application)
	|____ application.ini (customizing file)
	|____ start.bat (on Windows: double-click to start app)
	|____ start.sh  (on Linux: double-click to start app)
	|____ README.txt (this Readme document)

	xulrunner/chrome/
	|____ chrome.manifest (config file with relative paths to content files)

	xulrunner/defaults/preferences/
	|____ prefs.js  (JS config file with paths and options of content files, as defined in chrome.manifest)

	xulrunner/chrome/xulrunner/  (The "actual" application content)
	|____ UrlOpener.xul (XUL Dialog that requests an URL)
	|____ JavaClassLoader.js (JS that creates a Java Class Loader and calls the function launchUrl() of our custom Java class)
	|____ javaFirefoxExtensionUtils.jar (contains class Files of the MIT Simile Project and our custom JavaBSF.class)
	|____ Window.rex (ooRexx script that embeds a XPCOM environment)

	xulrunner/chrome/xulrunner/java/
	|____ JavaBSF.java (The custom Java class that calls ooRexx using BSF)
	|____ ErrorLog.txt (Java and ooRexx Exceptions are logged here.)

------------------------------------------------------------------------------
Author: 	Andreas Mitschek
		niosudigs@gmail.com 
Date:		20.03.2010

