wxPerl is a wrapper built around the wxWindows GUI toolkit

Copyright (c) 2000-2003 Mattia Barbon.
This package is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

You need wxWindows in order to build wxPerl (see http://www.wxwindows.org/).
You can use GTK, Win32, Mac OS X and Motif as windowing toolkits for wxPerl.

Please read the DEPRECATIONS section at the bottom!

INSTALLATION:

Build and install wxWindows

perl Makefile.PL
make
make test
make install

for more detailed instructions see the docs/install.txt file

TESTED PLATFORMS:

Perl            | OS            | wxWindows      | Compiler
----------------+---------------+----------------+-------------------
ActivePerl 6xx  | Windows 2000  |                | MSVC 5
           8xx  |               | wxMSW 2.4.0    | MSVC 6
5.6.1           |               |                | MinGW GCC
5.8.0           |               |                |
----------------+---------------+----------------+-------------------
5.005_03 [1]    | Debian 3.0    |                | GCC 2.95.2
5.8.0           | RedHat 8.0    | wxGTK 2.4.0    | GCC 3.2
5.6.1           |               | wxMotif 2.4.0  |
----------------+---------------+----------------+-------------------  
5.8.0           | Mac OS X 10.2 | wxMac 2.4.0    | GCC 3.1
----------------+---------------+----------------+-------------------

wxPerl has also been reported to work on FreeBSD and IRIX.

[1] 5.005_03 crashes at "perl Makefile.PL" time (at least under Linux)
    workarounds: "perl -d Makefile.PL" and then type "r", or run it under
    valgrind (no, it's not a joke...)

DEPRECATIONS

The following features have been deprecated and may disappear in the future

1 - class->new always returning an hash reference
    until now calling ->new( ... ) returned an hash reference for most
    classes derived from Wx::Window, hence the following code
    worked:

    my $button = Wx::Button->new( ... );
    $button->{attribute} = 'value';

    At some point in the future this will be changed so that only
    _user-defined_ classes derived from Wx::Window
    (or from any class derived from Wx::Window)
    will yield an hash reference, hence the following code will not work:

    my $button = Wx::Button->new( ... );
    my $window = Wx::Window->new( ... );
    $button->{a} = 'b';
    $window->{c} = 'd';

    while the following code will work as it did before:

    my $button = MyButton->new( ... ); # MyButton ISA Wx::Button
    my $window = MyWindow->new( ... ); # MyWindow ISA Wx::Window
    $button->{a} = 'b';
    $window->{c} = 'd';
