view release on metacpan or  search on metacpan

README.txt  view on Meta::CPAN

=head1 NAME

README.txt - build and installation instructions

=head1 DESCRIPTION

Alien::wxWidgets allows wxPerl to easily find information about
your wxWidgets installation. It can store this information for multiple
wxWidgets versions or configurations (debug, Unicode, etc.). It can also
build and install a private copy of wxWidgets as part of the build process.

=head1 Installing wxWidgets

If you do not know how to do it, please answer 'yes' to the question 'Do you
want to build wxWidgets?'; Alien::wxWidgets will build and install a
copy of wxWidgets for you.

=head1 Installing Alien::wxWidgets

Please note that the steps below can be repeated multiple times in order
install multiple configurations (differing for the wxWidgets version,
compiler, compiler version, debug/unicode settings).

=head2 Unices and Mac OS X

Important: If you are going to use the system wxWidgets or your own build of 
wxWidgets then either your required wx-config must be the first wx-config in 
the PATH or the WX_CONFIG environment variable must be set to the full path 
to wx-config. The environment WX_CONFIG variable can also be used to specify 
a different wx-config.

    perl Build.PL
    perl Build
    perl Build test
    perl Build install

=head3 Requirements for building on Unices

If you are going to ask Alien::wxWidgets to build wxWidgets you will need to
install development prerequisites. The following is the list for Ubuntu but
you can adapt for your own distribution where the package names may vary.

gcc
g++
libgtk2.0-dev
libgstreamer0.10-dev
libgstreamer-plugins-base0.10-dev
libglu1-mesa-dev
libexpat1-dev
libtiff4-dev
libpng12-dev
libjpeg-dev
libcairo2-dev
freeglut3-dev
libxmu-dev
libwebkitgtk-dev*

To build the wxWebView componenent you need libwebkitgtk version 1.3.1 or
greater. For Linux distributions currently this means a fairly recent
release. For example, Ubuntu ge 11.10

If you do not have a recent enough libwebkitgtk installed then configure
will simply not build the library. This is harmless.

=head2 Windows

If you are going to build your own wxWidgets then
    <add your compiler to the path>
    <build wxWidgets>
    set WXDIR=C:\Path\to\wxWidgets

Then whether you have built your own wxWidgets or not:

    perl Build.PL
    perl Build
    perl Build test
    perl Build install

Important: If you do not allow Alien to build wxWidgets, the command line 
options to Build.PL must match the build settings used to build wxWidgets.