HOW TO INSTALL AND USE THE EXAMPLES
===================================

Before starting, the following software packages have to be installed and configured, the download pages are provided:

OpenOffice.org version >=3.0 - http://www.openoffice.org
a Java Runtime Environment - http://www.sun.com
ooRexx version >=3.2.0 - http://www.oorexx.org
BSF4REXX - http://wi.wu-wien.ac.at/rgf/bsf4rexx

Installation instructions are provided with the packages, please refer to them. Note that the Java Runtime Environment has to be activated with OpenOffice.org, in version 3.0 it can be found via Extras--Options...--OpenOffice.org--Java; where all available runtime environments of the machine should be listed. Please select one. Note that on some linux systems, e.g. Ubuntu 8.04, the standard OpenOffice.org installation does not cover Java support. You can easily add this support by additionally adding the package, in Ubuntu e.g. with the command

sudo apt-get install openoffice.org-java-common

BSF4REXX provides both installation scripts and a readme, please refer to them to get the initial examples provided with the distribution running.

After a successful installation, the examples can be executed from 

- Command line, e.g. via rexx 01_SelectionTypes.rex to launch the first example.
Note that at this point an instance of OpenOffice.org has to be running and the respective document type has to be opened as described in the paper or below. If the system claims not to know the command "rexx", add the ooRexx binary directory to the path of the system.

- Within OpenOffice.org
To invoke a script from within OpenOffice.org, copy the listings into OpenOffice.org's macro manager, available via Extras--Macros--Organize Macros...--ooRexx...; which should be available in case of a successful installation. The pop-up window reveals the ooRexx macro storage. Press "Create..." to add a new macro and enter a name for it. Then click on "Edit", whereafter a small editor window opens. Press "Clear" to delete the default macro provided, paste the macro listings into the editor window and save the document. The new macro starts after pressing "Run" in the macro storage dialog. Note that the storage is user-specific, each user on the system has its own macro storage. As for the command line option, the respective document type of OpenOffice.org has to be opened as described in the paper or below


OVERVIEW ON REQUIRED DOCUMENT TYPES
===================================

Files mentioned in "additional requirements" section are available in the "supplementary" folder.


Example						Document Type			Additional Requirements
--------------------------------------------------------------------------------------------------------------------------
01_SelectionTypes.rex			|	OpenOffice.org Writer	|	Anything should be selected
02_LineBreaksInParagraph.rex		|	OpenOffice.org Writer	|	Text available. Execute ad2_createText.rex. 
03_RemoveEmptySpaces.rex		|	OpenOffice.org Writer	|	Text available. Execute ad2_createText.rex.
04_ReplaceFormatting.rex		|	OpenOffice.org Writer	|	Text available, some bold formatting.
05_ReplaceSelected.rex			|	OpenOffice.org Writer	|	Text available, partly selected.
06_CreateFields.rex			|	OpenOffice.org Writer	|	
07_DisplayFields.rex			|	OpenOffice.org Writer	|
08_CreateMasterFields.rex		|	OpenOffice.org Writer	|	
09_DisplayMasterFields.rex		|	OpenOffice.org Writer	|	Better with 08_CreateMasterFields.rex executed before.
10_FieldExampleTableNumbering.rex	|	OpenOffice.org Writer	|	
11_FieldExampleFormLetter.rex		|	OpenOffice.org Writer	|	GUI: 11b_FieldExampleFormLetter.rex
12_InsertFormula.rex			|	OpenOffice.org Writer	|
13_SortRange.rex			|	OpenOffice.org Calc	|	Filled cells. Execute ad13_createData.rex. 
14_ConditionalValidatedFormatting.rex	|	OpenOffice.org Calc	|	Filled cells and styles. Execute ad13_createData.rex and ad14_createStyles.rex. 
15_QueryCells.rex			|	OpenOffice.org Calc	|	Filled cells. Execute ad13_createData.rex. 
16_CellsSameFormatting.rex		|	OpenOffice.org Calc	|	Filled cells. Execute ad13_createData.rex. 
17_AutomaticFills.rex			|	OpenOffice.org Calc	|
18_ArrayFormulas.rex			|	OpenOffice.org Calc	|
19_MultipleOperations.rex		|	OpenOffice.org Calc	|
20_Outlines.rex				|	OpenOffice.org Calc	|	Better with filled cells. Execute ad13_createData.rex
21_Detective.rex			|	OpenOffice.org Calc	|	Formula cells. Execute ad21_createFormulas.rex	
22_ConvertLinkedGraphics.rex		|	OpenOffice.org Writer	|	GUI: 22b_ConvertLinkedGraphics.rex. Easily modifiabe for other modules.
23_GraphicSize.rex			|	OpenOffice.org Draw	|	GUI: 23b_GraphicSize.rex. Easily modifiabe for other modules.
24_ExportGraphicsSize.rex		|	OpenOffice.org 		|	GUI: 24b_ExportGraphicsSize.rex. Writer, Calc, Impress, Draw.
25_CombineAndExport.rex			|	OpenOffice.org Draw	|	GUI: 25b_CombineAndExport.rex.



