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.02 built on 10 Jul 2005.

    Source and ActiveState Perl PPMs are available from
    <http://sourceforge.net/project/showfiles.php?group_id=16572>.

    A cygwin distribution (available through cygwin's setup.exe) is
    maintained by Reini Urban (rurban@x-ray.at).

    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 <cygwin@cygwin.com>

  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:

    1. 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

    2. 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

    3. Cygwin
        Build requirements (over and above the runtime requirements above):

          cygwin
          cygutils
          gcc
          make
          gzip

        Build instructions:

        unpack perl-Win32-GUI-1.0-2-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-1.0-2.sh all

        This will create:

          /usr/src/perl-Win32-GUI-1.0-2.tar.bz2
          /usr/src/perl-Win32-GUI-1.0-2-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

    HTML documentation is included with the PPM distributions, and installed
    into your ActiveState Perl documentation tree by the install process.
    When building from source the POD documentation is built automatically
    by the make process. It can also be generated by issuing:

      nmake poddocs;

    The HTML documentation can be built by issuing:

      nmake htmldocs;

  Building your own PPM from source

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

    You will need tar, gzip and zip utilities on your path. This procedure
    will generate a PPM for you current perl environment, including the HTML
    documentation, ready for installation as above.

VERSION

    Documentation for Win32::GUI v1.02 created 10 Jul 2005

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

SUPPORT

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

    For further support join the users mailing
    list(perl-win32-gui-users@lists.sourceforge.net) from the website at
    <http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users>.
    There is a searchable list archive at
    <http://sourceforge.net/mail/?group_id=16572>.

COPYRIGHT and LICENCE

    Copyright (c) 1997..2005 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.

