README.txt 3.05 KB
Newer Older
1 2
wxPerl is a wrapper for the wxWidgets (formerly known as wxWindows) GUI toolkit

3
Copyright (c) 2000-2010 Mattia Barbon.
4 5 6 7 8 9 10 11 12 13
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:

14
Build and install wxWidgets, version 2.5.3 or above
15 16 17 18 19 20 21 22 23 24 25 26 27

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
----------------+---------------+----------------+-------------------
28 29 30 31
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
32
----------------+---------------+----------------+-------------------
33
5.8.x           | Fedora 9      | wxGTK 2.8.x    | GCC 3.x
34
5.6.1           | Debian 4.0    | wxGTK 2.9.x    | GCC 4.x
35
                | FreeBSD       |                |
36 37
                | Gentoo        |                |
----------------+---------------+----------------+-------------------  
38 39 40
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    |
41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
----------------+---------------+----------------+-------------------

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