perl_Reaction version 0.05
==========================

This is an experimental (but quite functional) wrapper for the OS4.0 Reaction
GUI
system. It enables you to write perl script with a GUI. It is a very "thin"
wrapper
The Objects reated are simply integer equivalents of the C pointers to the
BOOPSI
objects and other structures. With the excepetion of the arexx.class they are
not properly
blessed perl objects. Therefore you must clean up after yourself as you would in
C program. Calling DisposeObject() as needed, Freeing DrawInfo structures etc.

The following modules will be installed.

Reaction

Provides a selection of intuition and exec functions to support GUI building. As
well
as some additional "helper" function for obtaining and accessing various sytem
functions
navigating lists etc.

Reaction::Classes::Window
The RA_OpenWindow RA_Handleinput etc. functions provide the same functionality
as
their C macro equivalents.

Reaction::Classes::Arexx

Now implemented using a "traditional" perl object do perldoc
Reaction::Classes::ARexx
for more info

Reaction::Classes::Requester
Reaction::Classes::PopupMenu

Reaction::Gadgets::Button
Reaction::Gadgets::CheckBox
Reaction::Gadgets::Chooser
Reaction::Gadgets::ClickTab
Reaction::Gadgets::ColorWheel
Reaction::Gadgets::DateBrowser
Reaction::Gadgets::FuelGauge
Reaction::Gadgets::GetFile
Reaction::Gadgets::GetFont
Reaction::Gadgets::GetScreenMode
Reaction::Gadgets::Integer
Reaction::Gadgets::Layout
Reaction::Gadgets::ListBrowser
Reaction::Gadgets::Palette
Reaction::Gadgets::RadioButton
Reaction::Gadgets::Scroller
Reaction::Gadgets::Slider
Reaction::Gadgets::Space
Reaction::Gadgets::String
Reaction::Gadgets::TextEditor
Reaction::Gadgets::Virtual

Reaction::Images::Bevel
Reaction::Images::BitMap
Reaction::Images::Drawlist
Reaction::Images::Filler
Reaction::Images::Glyph
Reaction::Images::Label
Reaction::Images::Penmap

Pod Documentation is thin at the moment, typically only functions that vary in
calling
from their underlying C equivalent are documented.

INSTALLATION: BINARY

Copy the contents of the SDK/ directory into your SDK assign.
Or if you have reconfigured perl the contents of SDK/Local/clib2/lib/perl5 to
your
perl5 directory. NOTE: If you have the SDK it is better to install from source
(see below).


INSTALLATION: SOURCE


To install this module type the following:

   First generate the .ph files for the SDK includes:
   (assuming perl is allready installed)

   cd  SDK:Include/include_h
   sh
   h2ph -r .
   exit

   (this will recursively create the perl header files (.ph) making C Macros
such as
    Tag names available to the perl script.)

   Now cd to the directory where you unpacked this archive (the same as this
readme
   and Makefile.PL are found)

   sh
   perl Makefile.PL LINKTYPE=dynamic
   make
   make install

   optionaly before make install perform a simple test by typing
   perl -I blib/lib -I blib/arch test_win.pl
   a simple Reaction GUI will open which should respond to your input witchout
crashing.


DEPENDENCIES

Reaction libraries and classes. SDK plus tools like make an advantage, even for
non
developers (users) as perl expects to have access to make, sh, gcc, etc.

HISTORY

0.05
Fixed a bug with the Reaction::Classes::ARexx module, where the module would
crash if the port
were passedan uknown command.
Fixed duplicate definition of version.


0.04
Add workarround for the fact that .ph are only "required" once. So using them in
a module
prevents them being used at script level.

Omitted .ph files from binary directory.

0.03
Add support for the arexx class using a blessed perl object. Construction /
Disposal of
the underlying Reaction class is handled internal.

Add __examples/arexx.pl and __examples/test.rexx as a simple demo of the above.


0.02
Add more typemaps to allow some of the "helper" functions to be called with
ordinary perl arguments.

Fixed bug in ptrtostr()



0.01
Initial Release

COPYRIGHT AND LICENCE

Put the correct copyright and licence information here.

Copyright (C) 2006 by Andy Broad <andy()broad.ology.org.uk>

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.5 or,
at your option, any later version of Perl 5 you may have available.