Menu
▾
▴
[Perl-win32-gui-cvscommit] Win32-GUI Readme, 1.8, 1.9 Readme.html, 1.9, 1.10
|
From: Robert M. <rob...@us...> - 2006-11-05 20:37:48
|
Update of /cvsroot/perl-win32-gui/Win32-GUI In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24840 Modified Files: Readme Readme.html Log Message: 1.05 Release Index: Readme.html =================================================================== RCS file: /cvsroot/perl-win32-gui/Win32-GUI/Readme.html,v retrieving revision 1.9 retrieving revision 1.10 diff -C2 -d -r1.9 -r1.10 *** Readme.html 5 Nov 2006 20:04:49 -0000 1.9 --- Readme.html 5 Nov 2006 20:37:46 -0000 1.10 *************** *** 1,223 **** ! <!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> ! </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> ! </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.05 ! built on 05 Nov 2006.</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:ru...@x-...">ru...@x-...</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:cy...@cy...">cy...@cy...</a>></p> ! <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> ! </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> ! </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> ! </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> ! </p> ! <hr /> ! <h1><a name="documentation">Documentation</a></h1> ! <p> ! </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> ! </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> ! </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 your 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.05 created 05 Nov 2006</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://perl-win32-gui.sourceforge.net/">http://perl-win32-gui.sourceforge.net/</a>.</p> ! <p>For further support join the users mailing list(<code>per...@li...</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..2006 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.05 ! built on 05 Nov 2006.</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:ru...@x-...">ru...@x-...</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:cy...@cy...">cy...@cy...</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 your 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.05 created 05 Nov 2006</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>per...@li...</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..2006 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: Readme =================================================================== RCS file: /cvsroot/perl-win32-gui/Win32-GUI/Readme,v retrieving revision 1.8 retrieving revision 1.9 diff -C2 -d -r1.8 -r1.9 *** Readme 5 Nov 2006 20:04:49 -0000 1.8 --- Readme 5 Nov 2006 20:37:46 -0000 1.9 *************** *** 17,21 **** 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 --- 17,21 ---- 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 *************** *** 169,179 **** SUPPORT ! Homepage: <http://perl-win32-gui.sourceforge.net/>. For further support join the users mailing list("per...@li...") 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("per...@li...") 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 |