Short:        make perl scripts with GUIs
Author:       Andy Broad
Uploader:     Andy Broad (andy broad ology org uk)
Type:         dev/lang
Version:      0.02
Requires:     perl 5.8.5(.04) , SDK for optimal usage and to build source distribution.
Architecture: ppc-amigaos
URL:          http://www.broad.ology.org.uk/amiga/

perl_Reaction version 0.02
=====================

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. 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
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.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.