Update of /cvsroot/perl-win32-gui/Win32-GUI
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv1048
Modified Files:
CHANGELOG GUI.pm GUI.rc MANIFEST Makefile.PL Readme
Readme.html TODO
Log Message:
Tests and 1.03 release candidate
Index: GUI.rc
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/GUI.rc,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** GUI.rc 5 Oct 2005 22:20:48 -0000 1.5
--- GUI.rc 21 Nov 2005 22:33:33 -0000 1.6
***************
*** 8,13 ****
1 VERSIONINFO
! FILEVERSION 1,02,02,00
! PRODUCTVERSION 1,02,02,00
FILEOS VOS__WINDOWS32
FILETYPE VFT_DLL
--- 8,13 ----
1 VERSIONINFO
! FILEVERSION 1,03,00,00
! PRODUCTVERSION 1,03,00,00
FILEOS VOS__WINDOWS32
FILETYPE VFT_DLL
***************
*** 17,24 ****
BLOCK "040904E4"
{
! VALUE "Comments" , "Win32::GUI Perl module v1.02_02"
VALUE "CompanyName" , "Open Source"
VALUE "FileDescription" , "perl-win32-gui Perl
extension"
! VALUE "FileVersion" , "1.02_02"
VALUE "InternalName" , "GUI.dll"
VALUE "LegalCopyright" , "Copyright © Aldo Caplini
1997..2005"
--- 17,24 ----
BLOCK "040904E4"
{
! VALUE "Comments" , "Win32::GUI Perl module v1.03"
VALUE "CompanyName" , "Open Source"
VALUE "FileDescription" , "perl-win32-gui Perl
extension"
! VALUE "FileVersion" , "1.03"
VALUE "InternalName" , "GUI.dll"
VALUE "LegalCopyright" , "Copyright © Aldo Caplini
1997..2005"
***************
*** 26,30 ****
VALUE "OriginalFilename" , "GUI.dll"
VALUE "ProductName" , "Win32::GUI"
! VALUE "ProductVersion" , "1.02_02"
}
}
--- 26,30 ----
VALUE "OriginalFilename" , "GUI.dll"
VALUE "ProductName" , "Win32::GUI"
! VALUE "ProductVersion" , "1.03"
}
}
Index: Makefile.PL
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/Makefile.PL,v
retrieving revision 1.14
retrieving revision 1.15
diff -C2 -d -r1.14 -r1.15
*** Makefile.PL 13 Nov 2005 18:57:52 -0000 1.14
--- Makefile.PL 21 Nov 2005 22:33:33 -0000 1.15
***************
*** 2,5 ****
--- 2,6 ----
use warnings;
+ use File::Spec();
use ExtUtils::MakeMaker;
use Config;
***************
*** 7,13 ****
$main::USERESOURCE = 1;
$main::BUILDENV = '';
# parse our command line options, removing them from @ARGV so that
! # MakeMaker doesn't warm that they are unrecoginised.
my @tmp;
foreach (@ARGV) {
--- 8,15 ----
$main::USERESOURCE = 1;
$main::BUILDENV = '';
+ $main::BUILDENV_SETONCMDLINE = 0;
# parse our command line options, removing them from @ARGV so that
! # MakeMaker doesn't warn that they are unrecoginised.
my @tmp;
foreach (@ARGV) {
***************
*** 20,23 ****
--- 22,26 ----
elsif(/BUILDENV=(.*)/) {
$main::BUILDENV = $1;
+ $main::BUILDENV_SETONCMDLINE = 1;
}
else {
***************
*** 63,67 ****
__NOBUILDENV
! print "$_\t($allowed{$_})\n" for (keys %allowed);
exit(1);
--- 66,70 ----
__NOBUILDENV
! print "$_\t($allowed{$_})\n" for (keys %allowed);
exit(1);
***************
*** 83,86 ****
--- 86,125 ----
print "\n\nBUILDENV=$main::BUILDENV Used build environment is:
$allowed{$main::BUILDENV}\n\n";
+ # If we got this far, then we have a buildenv and compiler that
+ # we want to try to use. Check that we can find the compiler,
+ # and exit with a nice error message if we can't. This stops
+ # us from failing CPAN Smoke tests on boxes that don't have
+ # compilers.
+ if($main::BUILDENV_SETONCMDLINE == 0) {
+ my @path = File::Spec->path();
+ unshift @path, ('', '.');
+
+ my $found = 0;
+ foreach my $prog ( map { ( $_, "$_.exe" ) } ($Config{cc}) ) {
+ foreach my $path ( @path ) {
+ if( -f File::Spec->catfile( $path, $prog ) ) {
+ $found=1, last;
+ }
+ }
+ }
+
+ if(!$found) {
+ print STDERR <<__NOCOMPILER;
+
+ Makefile.PL was unable to find compiler '$Config{cc}' on your path.
+ To force a build call this script with the additional parameter 'BUILDENV':
+
+ perl Makefile.PL BUILDENV=xxxx
+
+ where xxxx is one of:
+ __NOCOMPILER
+
+ print "$_\t($allowed{$_})\n" for (keys %allowed);
+
+
+ exit(1);
+ }
+ }
+
if($main::USERESOURCE == -1) {
$main::USERESOURCE = 0;
***************
*** 187,203 ****
BINARY_LOCATION => 'Win32-GUI.tar.gz',
macro => {
!
BUILD_TOOLS => './build_tools',
!
INST_DEMO => '$(INST_LIBDIR)/GUI/demos',
!
PPMDISTVNAME => '$(DISTVNAME)-PPM-' .
substr($Config{version},0,3),
!
},
clean => {
!
FILES => 'comctrl32.def cygwin.o libcyg.a GUI.res',
!
},
realclean => {
!
FILES => '$(PPMDISTVNAME) Readme.old Readme.html.old',
!
},
depend => {
!
distdir => 'readmedocs',
!
},
);
--- 226,242 ----
BINARY_LOCATION => 'Win32-GUI.tar.gz',
macro => {
! BUILD_TOOLS => './build_tools',
! INST_DEMO => '$(INST_LIBDIR)/GUI/demos',
! PPMDISTVNAME => '$(DISTVNAME)-PPM-' .
substr($Config{version},0,3),
! },
clean => {
! FILES => 'comctrl32.def cygwin.o libcyg.a GUI.res',
! },
realclean => {
! FILES => '$(PPMDISTVNAME) Readme.old
Readme.html.old',
! },
depend => {
! distdir => 'readmedocs',
! },
);
***************
*** 208,216 ****
}
- if ($main::BUILDENV eq "mingw") {
- #$MakefileArgs{'LIBS'} = [':nosearch -lcomctl32'];
- #$MakefileArgs{'DEFINE'} = '-D__MINGW__'; # should really use __MINGW32__,
as that's defined by the compiler
- }
-
WriteMakefile( %MakefileArgs );
--- 247,250 ----
Index: GUI.pm
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/GUI.pm,v
retrieving revision 1.34
retrieving revision 1.35
diff -C2 -d -r1.34 -r1.35
*** GUI.pm 13 Nov 2005 18:57:52 -0000 1.34
--- GUI.pm 21 Nov 2005 22:33:33 -0000 1.35
***************
*** 25,29 ****
# STATIC OBJECT PROPERTIES
#
! $VERSION = "1.02_03"; # For MakeMaker
$XS_VERSION = $VERSION; # For dynaloader
$VERSION = eval $VERSION; # For Perl (see perldoc perlmodstyle)
--- 25,29 ----
# STATIC OBJECT PROPERTIES
#
! $VERSION = "1.03"; # For MakeMaker
$XS_VERSION = $VERSION; # For dynaloader
$VERSION = eval $VERSION; # For Perl (see perldoc perlmodstyle)
Index: CHANGELOG
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/CHANGELOG,v
retrieving revision 1.66
retrieving revision 1.67
diff -C2 -d -r1.66 -r1.67
*** CHANGELOG 13 Nov 2005 18:57:52 -0000 1.66
--- CHANGELOG 21 Nov 2005 22:33:33 -0000 1.67
***************
*** 6,9 ****
--- 6,19 ----
Win32-GUI ChangeLog
===================
+ + [Robert May] : 21 Nov 2003 - 1.03 release candidate
+ - t\05_Timer_*.t change interval test to use milli-seconds using
+ Win32::GetTickCount() rather than time().
+ -t\01_basic.t add tests for Test::More availability and correct OS.
+ -t\98_Pod.t new test of POD syntax
+ - various minor documentation edits to correct POD syntax
+ -Makefile.PL added test for presence of compiler to stop us failing CPAN
+ Smoke tests in test environments with no compilers.
+ - Up version to 1.03
+
+ [Robert May] : 13 Nov 2005 - Bug fixes and preparing for 1.03 release
- Makefile.PL added code to remove Test::More dependence from PPD
Index: MANIFEST
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/MANIFEST,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** MANIFEST 13 Nov 2005 18:57:52 -0000 1.10
--- MANIFEST 21 Nov 2005 22:33:33 -0000 1.11
***************
*** 124,127 ****
--- 124,128 ----
t/50_Font_GetMetrics.t
t/50_Richedit_GetCharFormat.t
+ t/98_Pod.t
TabStrip.xs
Textfield.xs
Index: Readme
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/Readme,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Readme 10 Jul 2005 11:24:29 -0000 1.3
--- Readme 21 Nov 2005 22:33:33 -0000 1.4
***************
*** 14,21 ****
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
--- 14,21 ----
AVAILABILITY
! This is the README file for Win32::GUI v1.03 built on 21 Nov 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
***************
*** 58,62 ****
Cygwin port questions to the mailinglist <[EMAIL PROTECTED]>
! Building from source
Unpack the distribution into a local directory, and from a command
--- 58,62 ----
Cygwin port questions to the mailinglist <[EMAIL PROTECTED]>
! Building from source
Unpack the distribution into a local directory, and from a command
***************
*** 67,135 ****
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:
--- 67,136 ----
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
! 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:
***************
*** 137,145 ****
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)
--- 138,154 ----
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)
***************
*** 148,158 ****
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
--- 157,166 ----
nmake ppm
! 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.03 created 21 Nov 2005
This document is autogenerated by the build process. Edits made here
***************
*** 161,171 ****
SUPPORT
! Homepage: <http://sourceforge.net/projects/perl-win32-gui/>.
For further support join the users mailing
! list([EMAIL PROTECTED]) 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
--- 169,179 ----
SUPPORT
! Homepage: http://perl-win32-gui.sourceforge.net/.
For further support join the users mailing
! list("[EMAIL PROTECTED]") 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
Index: Readme.html
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/Readme.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Readme.html 10 Jul 2005 11:24:29 -0000 1.3
--- Readme.html 21 Nov 2005 22:33:33 -0000 1.4
***************
*** 1,200 ****
! <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";>
! <html xmlns="http://www.w3.org/1999/xhtml";>
! <head>
! <title>Win32::GUI::UserGuide::Readme - Perl-Win32 Graphical User Interface
Extension README</title>
! <link rev="made" href="mailto:"; />
! </head>
! <body style="background-color: white">
! <p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
! <ul>
! <li><a href="#name">NAME</a></li>
! <li><a href="#description">DESCRIPTION</a></li>
! <li><a href="#availability">AVAILABILITY</a></li>
! <li><a href="#installing">INSTALLING</a></li>
! <ul>
! <li><a href="#activestate_activeperl_ppms">ActiveState
ActivePerl PPMs</a></li>
! <li><a href="#cygwin">Cygwin</a></li>
! <li><a href="#building_from_source">Building from
source</a></li>
! <li><a href="#documentation">Documentation</a></li>
! <li><a href="#building_your_own_ppm_from_source">Building your
own PPM from source</a></li>
! </ul>
! <li><a href="#version">VERSION</a></li>
! <li><a href="#support">SUPPORT</a></li>
! <li><a href="#copyright_and_licence">COPYRIGHT and LICENCE</a></li>
! </ul>
<!-- INDEX END -->
! <hr />
! <p>
! </p>
! <h1><a name="name">NAME</a></h1>
! <p>Win32::GUI::UserGuide::Readme - Perl-Win32 Graphical User Interface
Extension README</p>
! <p>
! </p>
! <hr />
! <h1><a name="description">DESCRIPTION</a></h1>
! <p>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.</p>
! <p>
! </p>
! <hr />
! <h1><a name="availability">AVAILABILITY</a></h1>
! <p>This is the README file for Win32::GUI v1.02
! built on 10 Jul 2005.</p>
! <p>Source and ActiveState Perl PPMs are available from
! <a
href="http://sourceforge.net/project/showfiles.php?group_id=16572";>http://sourceforge.net/project/showfiles.php</a>.</p>
! <p>A cygwin distribution (available through cygwin's setup.exe) is maintained
! by Reini Urban (<a href="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</a>)</p>
! <p>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.</p>
! <p>
! </p>
! <hr />
! <h1><a name="installing">INSTALLING</a></h1>
! <p>
! </p>
! <h2><a name="activestate_activeperl_ppms">ActiveState ActivePerl PPMs</a></h2>
! <p>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:</p>
! <pre>
! ppm uninstall Win32-GUI</pre>
! <p>If you have any packages that are dependent on Win32::GUI you may need to
add
! the <code>-force</code> option to the command line. See your documentation
for PPM.</p>
! <p>Unzip the PPM distribution into a local directory. From a command
! prompt in that directory run:</p>
! <pre>
! ppm install ./Win32-GUI.ppd</pre>
! <p>
! </p>
! <h2><a name="cygwin">Cygwin</a></h2>
! <p>Runtime requirements:</p>
! <pre>
cygwin
perl-5.8.6
! w32api</pre>
! <p>Use the cygwin setup.exe tool to locate, download and install
! the perl-Win32-GUI binary package.</p>
! <p>Cygwin port questions to the mailinglist <<a href="mailto:[EMAIL
PROTECTED]">[EMAIL PROTECTED]</a>></p>
! <p>
! </p>
! <h2><a name="building_from_source">Building from source</a></h2>
! <p>Unpack the distribution into a local directory, and from a command
! prompt in that directory follow the instructions below.</p>
! <p>These instructions assume that you have already set up your build
environment, and can build source distributions. The following
! environments are known to work:</p>
! <ol>
! <li><strong><a name="item_microsoft_visual_c_2b_2b_v6">Microsoft Visual C++
V6</a></strong><br />
! </li>
! 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.
! <pre>
perl Makefle.PL
nmake
nmake test
! nmake install</pre>
! <p></p>
! <li><strong><a name="item_mingw_and_extutils_3a_3afakeconfig">MinGW and
ExtUtils::FakeConfig</a></strong><br />
! </li>
! <pre>
perl -MConfig_m Makefile.PL
nmake
nmake test
! nmake install</pre>
! <p>Built this way the GUI.dll extension can be very large (~3MB). There is a
! module in the <em>build_tools</em> directory that works with
<strong>Config_m</strong> and
! <a href="/ExtUtils/FakeConfig.html">Extutils::FakeConfig</a> to set the MinGW
compiler
flags more optimally. If you want to try this, then replace the first
! command with:</p>
! <pre>
! perl -Ibuild_tools -MConfig_mO Makefile.PL</pre>
! <li><strong><a name="item_cygwin">Cygwin</a></strong><br />
! </li>
! Build requirements (over and above the runtime requirements above):
! <pre>
cygwin
cygutils
gcc
make
! gzip</pre>
! <p>Build instructions:</p>
! <p>unpack <em>perl-Win32-GUI-1.0-2-src.tar.bz2</em>. If you use setup to
install
! this src package, it will be unpacked under <em>/usr/src</em>
automatically.</p>
! <pre>
cd /usr/src
! ./perl-Win32-GUI-1.0-2.sh all</pre>
! <p>This will create:</p>
! <pre>
! /usr/src/perl-Win32-GUI-1.0-2.tar.bz2
! /usr/src/perl-Win32-GUI-1.0-2-src.tar.bz2</pre>
! <p>Port Notes:</p>
! <p>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.</p>
! <p>For a source build from the official source, the standard build process
! should be sufficient:</p>
! <pre>
Perl Makefile.PL
make
make test
! make install</pre>
! <p></p></ol>
! <p>
! </p>
! <h2><a name="documentation">Documentation</a></h2>
! <p>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:</p>
! <pre>
! nmake poddocs;</pre>
! <p>The HTML documentation can be built by issuing:</p>
! <pre>
! nmake htmldocs;</pre>
! <p>
! </p>
! <h2><a name="building_your_own_ppm_from_source">Building your own PPM from
source</a></h2>
! <pre>
perl Makefile.PL (adjust as necessary for your build environment)
nmake
nmake test
! nmake ppm</pre>
! <p>You will need <strong>tar</strong>, <strong>gzip</strong> and
<strong>zip</strong> utilities on your path. This procedure
! will generate a PPM for you current perl environment, including the HTML
! documentation, ready for installation as above.</p>
! <p>
! </p>
! <hr />
! <h1><a name="version">VERSION</a></h1>
! <p>Documentation for Win32::GUI v1.02 created 10 Jul 2005</p>
! <p>This document is autogenerated by the build process. Edits made here will
be lost.
! Edit <em>docs/GUI/UserGuide/Readme.pod</em> instead.</p>
! <p>
! </p>
! <hr />
! <h1><a name="support">SUPPORT</a></h1>
! <p>Homepage: <a
href="http://sourceforge.net/projects/perl-win32-gui/";>http://sourceforge.net/projects/perl-win32-gui/</a>.</p>
! <p>For further support join the users mailing <code>list([EMAIL
PROTECTED])</code> from the website
! at <a
href="http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users";>http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users</a>.
There is a searchable list archive at <a
href="http://sourceforge.net/mail/?group_id=16572";>http://sourceforge.net/mail/</a>.</p>
! <p>
! </p>
! <hr />
! <h1><a name="copyright_and_licence">COPYRIGHT and LICENCE</a></h1>
! <p>Copyright (c) 1997..2005 Aldo Calpini. All rights reserved.</p>
! <p>This program is free software; you can redistribute it and/or
! modify it under the same terms as Perl itself.</p>
! </body>
! </html>
--- 1,205 ----
! <HTML>
! <HEAD>
! <TITLE>Win32::GUI::UserGuide::Readme - Perl-Win32 Graphical User Interface
Extension README</TITLE>
! <LINK REV="made" HREF="mailto:";>
! </HEAD>
! <BODY>
! <A NAME="__index__"></A>
<!-- INDEX BEGIN -->
! <UL>
! <LI><A HREF="#name">NAME</A></LI>
! <LI><A HREF="#description">DESCRIPTION</A></LI>
! <LI><A HREF="#availability">AVAILABILITY</A></LI>
! <LI><A HREF="#installing">INSTALLING</A></LI>
! <UL>
! <LI><A HREF="#activestate activeperl ppms">ActiveState
ActivePerl PPMs</A></LI>
! <LI><A HREF="#cygwin">Cygwin</A></LI>
! </UL>
! <LI><A HREF="#building from source">Building from source</A></LI>
! <UL>
!
! <LI><A HREF="#microsoft visual c++ v6">Microsoft Visual C++
V6</A></LI>
! <LI><A HREF="#mingw and extutils::fakeconfig">MinGW and
ExtUtils::FakeConfig</A></LI>
! <LI><A HREF="#cygwin">Cygwin</A></LI>
! </UL>
!
! <LI><A HREF="#documentation">Documentation</A></LI>
! <UL>
!
! <LI><A HREF="#pod documentation">POD documentation</A></LI>
! <LI><A HREF="#html documentation">HTML Documentation</A></LI>
! </UL>
!
! <LI><A HREF="#building your own ppm from source">Building your own PPM
from source</A></LI>
! <LI><A HREF="#version">VERSION</A></LI>
! <LI><A HREF="#support">SUPPORT</A></LI>
! <LI><A HREF="#copyright and licence">COPYRIGHT and LICENCE</A></LI>
! </UL>
<!-- INDEX END -->
! <HR>
! <P>
! <H1><A NAME="name">NAME</A></H1>
! <P>Win32::GUI::UserGuide::Readme - Perl-Win32 Graphical User Interface
Extension README</P>
! <P>
! <HR>
! <H1><A NAME="description">DESCRIPTION</A></H1>
! <P>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.</P>
! <P>
! <HR>
! <H1><A NAME="availability">AVAILABILITY</A></H1>
! <P>This is the README file for Win32::GUI v1.03
! built on 21 Nov 2005.</P>
! <P>Source and ActiveState Perl PPMs are available from
! <A
HREF="http://sourceforge.net/project/showfiles.php?group_id=16572";>http://sourceforge.net/project/showfiles.php</A>.</P>
! <P>A cygwin distribution (available through cygwin's setup.exe) is maintained
! by Reini Urban (<A HREF="mailto:[EMAIL PROTECTED]">[EMAIL PROTECTED]</A>)</P>
! <P>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.</P>
! <P>
! <HR>
! <H1><A NAME="installing">INSTALLING</A></H1>
! <P>
! <H2><A NAME="activestate activeperl ppms">ActiveState ActivePerl PPMs</A></H2>
! <P>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:</P>
! <PRE>
! ppm uninstall Win32-GUI</PRE>
! <P>If you have any packages that are dependent on Win32::GUI you may need to
add
! the <CODE>-force</CODE> option to the command line. See your documentation
for PPM.</P>
! <P>Unzip the PPM distribution into a local directory. From a command
! prompt in that directory run:</P>
! <PRE>
! ppm install ./Win32-GUI.ppd</PRE>
! <P>
! <H2><A NAME="cygwin">Cygwin</A></H2>
! <P>Runtime requirements:</P>
! <PRE>
cygwin
perl-5.8.6
! w32api</PRE>
! <P>Use the cygwin setup.exe tool to locate, download and install
! the perl-Win32-GUI binary package.</P>
! <P>Cygwin port questions to the mailinglist <<A HREF="mailto:[EMAIL
PROTECTED]">[EMAIL PROTECTED]</A>></P>
! <P>
! <HR>
! <H1><A NAME="building from source">Building from source</A></H1>
! <P>Unpack the distribution into a local directory, and from a command
! prompt in that directory follow the instructions below.</P>
! <P>These instructions assume that you have already set up your build
environment, and can build source distributions. The following
! environments are known to work:</P>
! <P>
! <H2><A NAME="microsoft visual c++ v6">Microsoft Visual C++ V6</A></H2>
! <P>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.</P>
! <PRE>
perl Makefle.PL
nmake
nmake test
! nmake install</PRE>
! <P>
! <H2><A NAME="mingw and extutils::fakeconfig">MinGW and
ExtUtils::FakeConfig</A></H2>
! <PRE>
perl -MConfig_m Makefile.PL
nmake
nmake test
! nmake install</PRE>
! <P>Built this way the GUI.dll extension can be very large (~3MB). There is a
! module in the <EM>build_tools</EM> directory that works with
<STRONG>Config_m</STRONG> and
! <A HREF="/ExtUtils/FakeConfig.html">Extutils::FakeConfig</A> to set the MinGW
compiler
flags more optimally. If you want to try this, then replace the first
! command with:</P>
! <PRE>
! perl -Ibuild_tools -MConfig_mO Makefile.PL</PRE>
! <P>
! <H2><A NAME="cygwin">Cygwin</A></H2>
! <P>Build requirements (over and above the runtime requirements above):</P>
! <PRE>
cygwin
cygutils
gcc
make
! gzip</PRE>
! <P>Build instructions:</P>
! <P>unpack <EM>perl-Win32-GUI-X.XX-X-src.tar.bz2</EM>. If you use setup to
install
! this src package, it will be unpacked under <EM>/usr/src</EM>
automatically.</P>
! <PRE>
cd /usr/src
! ./perl-Win32-GUI-X.XX-X.sh all</PRE>
! <P>This will create:</P>
! <PRE>
! /usr/src/perl-Win32-GUI-X.XX-X.tar.bz2
! /usr/src/perl-Win32-GUI-X.XX-X-src.tar.bz2</PRE>
! <P>Port Notes:</P>
! <P>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.</P>
! <P>For a source build from the official source, the standard build process
! should be sufficient:</P>
! <PRE>
Perl Makefile.PL
make
make test
! make install</PRE>
! <P>
! <HR>
! <H1><A NAME="documentation">Documentation</A></H1>
! <P>
! <H2><A NAME="pod documentation">POD documentation</A></H2>
! <P>When building from source the POD documentation is built automatically
! by the make process. It can also be generated by issuing:</P>
! <PRE>
! nmake poddocs;</PRE>
! <P>
! <H2><A NAME="html documentation">HTML Documentation</A></H2>
! <P>HTML documentation is included with the PPM distributions, and installed
! into your ActiveState Perl documentation tree by the install process.</P>
! <P>The HTML documentation can also be generated by issuing:</P>
! <PRE>
! nmake htmldocs;</PRE>
! <P>
! <HR>
! <H1><A NAME="building your own ppm from source">Building your own PPM from
source</A></H1>
! <P>You will need <STRONG>tar</STRONG>, <STRONG>gzip</STRONG> and
<STRONG>zip</STRONG> utilities on your path. Issue
! the following commands.</P>
! <PRE>
perl Makefile.PL (adjust as necessary for your build environment)
nmake
nmake test
! nmake ppm</PRE>
! <P>This procedure will generate a PPM for you current perl environment,
! including the HTML documentation, ready for installation as above.</P>
! <P>
! <HR>
! <H1><A NAME="version">VERSION</A></H1>
! <P>Documentation for Win32::GUI v1.03 created 21 Nov 2005</P>
! <P>This document is autogenerated by the build process. Edits made here will
be lost.
! Edit <EM>docs/GUI/UserGuide/Readme.pod</EM> instead.</P>
! <P>
! <HR>
! <H1><A NAME="support">SUPPORT</A></H1>
! <P>Homepage: <A
HREF="http://perl-win32-gui.sourceforge.net/";>http://perl-win32-gui.sourceforge.net/</A>.</P>
! <P>For further support join the users mailing list(<CODE>[EMAIL
PROTECTED]</CODE>) from the website
! at <A
HREF="http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users";>http://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users</A>.
There is a searchable list archive at <A
HREF="http://sourceforge.net/mail/?group_id=16572";>http://sourceforge.net/mail/</A>.</P>
! <P>
! <HR>
! <H1><A NAME="copyright and licence">COPYRIGHT and LICENCE</A></H1>
! <P>Copyright (c) 1997..2005 Aldo Calpini. All rights reserved.</P>
! <P>This program is free software; you can redistribute it and/or
! modify it under the same terms as Perl itself.</P>
! </BODY>
! </HTML>
Index: TODO
===================================================================
RCS file: /cvsroot/perl-win32-gui/Win32-GUI/TODO,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** TODO 13 Nov 2005 18:57:52 -0000 1.13
--- TODO 21 Nov 2005 22:33:33 -0000 1.14
***************
*** 40,44 ****
to turn off Win32::GUI warnings. (see -DW32G_NEWWARN)
! - Makefile.PL. Add code to fail at Makefile.PL stage if the chosen compiler
! is not available, and we autodetected from $Config{cc}. This will prevent
us getting
! FAILS from the CPAN Smoke test machines that have no compiler.
--- 40,45 ----
to turn off Win32::GUI warnings. (see -DW32G_NEWWARN)
! - Get everything to run under strictures and warnings.
!
! - Start to split into smaller, more manageable pieces - hopefully this might
make it
! easier to add tests. Look at moving code out of XS and into Perl?
