wxPerl is a wrapper for the wxWidgets (formerly known as wxWindows) GUI toolkit

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

You need wxWidgets in order to build wxPerl (see http://www.wxwidgets.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 wxWidgets, version 2.5.3 or above

perl Makefile.PL
make
make test
make install

for more detailed instructions see the docs/install.pod file;
in case of problems please consult the FAQ section therein.

TESTED PLATFORMS:

Perl            | OS            | wxWidgets      | Compiler
----------------+---------------+----------------+-------------------
ActivePerl 8xx  | Windows 2000  | wxMSW 2.8.x    | MSVC 6
Strawberry Perl | Windows XP    |                | MSVC 7
5.10.x          | Windows Vista |                | MinGW GCC 3.4
               |               |                | MinGW GCC 4.x
----------------+---------------+----------------+-------------------
5.8.x           | Fedora 9      | wxGTK 2.8.x    | GCC 3.x
5.6.1           | Debian 4.0    | wxGTK 2.9.x    | GCC 4.x
               | FreeBSD       |                |
               | Gentoo        |                |
----------------+---------------+----------------+-------------------
5.8.x           | Mac OS X 10.4 | wxMac 2.5.3    | GCC 3.3
5.10.0          | Mac OS X 10.5 | wxMac 2.8.x    | GCC 4.x
               | Mac OS X 10.6 | wxMac 2.9.x    |
----------------+---------------+----------------+-------------------

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

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 anymore:

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

   while the following code will work as it did before:

   package MyButton;
   use base qw(Wx::Button);

   sub new {
       my $class = shift;
       my $self = $class->SUPER::new;  # always returns hash
       $self->{attribure} = 'value;
       return $self;
   }

2 - Use of $Wx::_foo

   wxPerl used to provide some constants named $Wx::_something
   (for example, $Wx::_msw, $Wx::_platform, $Wx::_wx_version).

   These constants are now deprecated, and will be removed in
   some future version; this information is available via
   functions in the Wx package (i.e. Wx::wxMSW())

   toolkit: wxMSW, wxGTK, wxMOTIF, wxX11, wxMAC, wxUNIVERSAL
   misc:    wxUNICODE, wxVERSION