NAME

   Win32::GUI::UserGuide::Readme - Perl-Win32 Graphical User Interface
   Extension README

DESCRIPTION

   Win32::GUI is a Win32-platform native graphical user interface toolkit
   for perl. Basically, it's an XS implementation of most of the functions
   found in user32.dll and gdi32.dll, with an object oriented perl
   interface and an event-based dialog model that mimic the functionality
   of visual basic.

AVAILABILITY

   This is the README file for Win32::GUI v1.12 built on 03 Jun 2015.

   Source and ActiveState Perl PPMs are available from
   <http://sourceforge.net/projects/perl-win32-gui/files/>.

   A cygwin distribution (available through cygwin's setup.exe) is
   maintained by Reini Urban ([email protected]).

   If the Win32::GUI version number contains an underscore, then it is an
   alpha, beta or release candidate distribution. If there is no such
   underscore, then it is a stable release.

INSTALLING

 ActiveState ActivePerl PPMs

   It is recommended to uninstall any previous version of Win32::GUI before
   installing a new version. This ensures old documentation is removed
   correctly. From a command prompt run:

     ppm uninstall Win32-GUI

   If you have any packages that are dependent on Win32::GUI you may need
   to add the "-force" option to the command line. See your documentation
   for PPM.

   Unzip the PPM distribution into a local directory. From a command prompt
   in that directory run:

     ppm install ./Win32-GUI.ppd

 Cygwin

   Runtime requirements:

     cygwin
     perl-5.8.6
     w32api

   Use the cygwin setup.exe tool to locate, download and install the
   perl-Win32-GUI binary package.

   Cygwin port questions to the mailinglist <[email protected]>

Building from source

   Unpack the distribution into a local directory, and from a command
   prompt in that directory follow the instructions below.

   These instructions assume that you have already set up your build
   environment, and can build source distributions. The following
   environments are known to work:

 Microsoft Visual C++ V6

   Other versions may work. There are reported issues with VC++ 7 which
   links with a different C runtime to VC++ 6, and so you may have issues
   running an extension built with VC++ 7 with the ActiveState Perls.

     perl Makefle.PL
     nmake
     nmake test
     nmake install

 MinGW and ExtUtils::FakeConfig

     perl -MConfig_m Makefile.PL
     nmake
     nmake test
     nmake install

   Built this way the GUI.dll extension can be very large (~3MB). There is
   a module in the build_tools directory that works with Config_m and
   Extutils::FakeConfig to set the MinGW compiler flags more optimally. If
   you want to try this, then replace the first command with:

     perl -Ibuild_tools -MConfig_mO Makefile.PL

 Strawberry Perl

     perl Makefile.PL
     dmake
     dmake test
     dmake install

 Cygwin

   Build requirements (over and above the runtime requirements above):

     cygwin
     cygutils
     gcc
     make
     gzip

   Build instructions:

   unpack perl-Win32-GUI-X.XX-X-src.tar.bz2. If you use setup to install
   this src package, it will be unpacked under /usr/src automatically.

     cd /usr/src
     ./perl-Win32-GUI-X.XX-X.sh all

   This will create:

     /usr/src/perl-Win32-GUI-X.XX-X.tar.bz2
     /usr/src/perl-Win32-GUI-X.XX-X-src.tar.bz2

   Port Notes:

   The dll's must probably be rebased. If a remap error occurs run
   rebaseall from the rebase package. The packaged version is already
   rebased to my personal settings.

   For a source build from the official source, the standard build process
   should be sufficient:

     Perl Makefile.PL
     make
     make test
     make install

Documentation

 POD documentation

   When building from source the POD documentation is built automatically
   by the make process. It can also be generated by issuing:

     nmake poddocs;

 HTML Documentation

   HTML documentation is included with the PPM distributions, and installed
   into your ActiveState Perl documentation tree by the install process.

   The HTML documentation can also be generated by issuing:

     nmake htmldocs;

Building your own PPM from source

   You will need tar, gzip and zip utilities on your path. Issue the
   following commands.

     perl Makefile.PL (adjust as necessary for your build environment)
     nmake
     nmake test
     nmake ppm

   This procedure will generate a PPM for your current perl environment,
   including the HTML documentation, ready for installation as above.

VERSION

   Documentation for Win32::GUI v1.12 created 03 Jun 2015

   This document is autogenerated by the build process. Edits made here
   will be lost. Edit docs/GUI/UserGuide/Readme.pod instead.

SUPPORT

   Homepage: <http://perl-win32-gui.sourceforge.net/>.

   For further support join the users mailing list from the website at
   <http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users>.
   There is a searchable list archive at
   <http://sourceforge.net/p/perl-win32-gui/mailman/perl-win32-gui-users/>.

COPYRIGHT and LICENCE

   Copyright (c) 1997..2015 Aldo Calpini. All rights reserved.

   This program is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.