Update of /cvsroot/perl-win32-gui/Win32-GUI/docs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv21242/docs
Modified Files: GUI.pod Log Message: Doc updates and add Win32::GUI::ReleaseNotes Index: GUI.pod =================================================================== RCS file: /cvsroot/perl-win32-gui/Win32-GUI/docs/GUI.pod,v retrieving revision 1.5 retrieving revision 1.6 diff -C2 -d -r1.5 -r1.6 *** GUI.pod 14 Jun 2006 22:26:31 -0000 1.5 --- GUI.pod 16 Jul 2006 11:09:33 -0000 1.6 *************** *** 5,10 **** --- 5,23 ---- Win32::GUI - Perl Win32 Graphical User Interface Extension + =head1 SYNOPSIS + + use Win32::GUI(); + =head1 Table of Contents + Due to the volume of Win32::GUI documentation it is split into a number + of different sections. The documentation is sparse in some areas, and + incomplete in others. Patches are welcome. The documentation does not + try to be a tutorial for Windows GUI programming, although the tutorial + should give enough information for a beginner to get started. For + advanced features knowledge of the Win32 API is assumed, and further + information can be found from Microsoft's online resources + (L<http://msdn.microsoft.com/>). + =head2 User Guide *************** *** 13,24 **** --- 26,55 ---- =item * L<README|Win32::GUI::UserGuide::Readme> + What Win32::GUI is, and how to get it installed. + + =item * L<Release Notes|Win32::GUI::ReleaseNotes> + + Release notes. Essential reading for old hands who want + to know what has changed between versions. + =item * L<Introduction|Win32::GUI::UserGuide::Introduction> + A short welcome. + =item * L<General Concepts|Win32::GUI::UserGuide::Concepts> + An introduction to the basic Windows GUI concepts and how they + relate to Win32::GUI + =item * L<Tutorial|Win32::GUI::Tutorial> + A Tutorial. Essential reading for beginners: Creating your first + Win32::GUI window and all the basics that you will need. + =item * L<Frequently Asked Questions|Win32::GUI::UserGuide::FAQ> + A (currently somewhat out of date) set of Frequently asked questions + and answers. + =back *************** *** 27,38 **** =over ! =item * L<Packages|Win32::GUI::Reference::Packages> =item * L<Common Events|Win32::GUI::Reference::Events> =item * L<Common Methods|Win32::GUI::Reference::Methods> =item * L<Options|Win32::GUI::Reference::Options> =back --- 58,78 ---- =over ! =item * L<Core Packages|Win32::GUI::Reference::Packages> ! ! Per package documentation for the core Win32::GUI packages. =item * L<Common Events|Win32::GUI::Reference::Events> + All the events that are common to every window. + =item * L<Common Methods|Win32::GUI::Reference::Methods> + All the methods in the Win32::GUI package (and inherited by + the other packages). + =item * L<Options|Win32::GUI::Reference::Options> + Options common to most package constructors. + =back *************** *** 41,48 **** --- 81,120 ---- =over + =item * L<Win32::GUI::AxWindow|Win32::GUI::AxWindow> + + Host AxticeX controls in Win32::GUI windows + =item * L<Win32::GUI::BitmapInline|Win32::GUI::BitmapInline> + Load bitmaps from within your script, rather than a seperate + file. + + =item * L<Win32::GUI::Constants|Win32::GUI::Constants> + + Export any of over 1700 Win32 API constants for use with + Win32::GUI functions and methods. + + =item * L<Win32::GUI::DIBitmap|Win32::GUI::DIBitmap> + + Support for creating bitmaps from other graphics file formats + and more image manipulation. Can interact with the perl GD + package if more complex image manipulation is required. + + =item * L<Win32::GUI::DropFiles|Win32::GUI::DropFiles> + + Accept files dragged from the Windows shell to your application. + + =item * L<Win32::GUI::Grid|Win32::GUI::Grid> + + Tabular data entry and display. + =item * L<Win32::GUI::GridLayout|Win32::GUI::GridLayout> + A simple layout manager. + + =item * L<Win32::GUI::Scintilla|Win32::GUI::Scintilla> + + An advanced source code editor control. + =back *************** *** 54,59 **** installtion root (by default for ActiveState perl this is at F<C:/Perl/site/lib/Win32/GUI/demos>). There is ! a launcher application installed as well. Type C<win32-gui-demos> at a command prompt. __W32G_POSTAMBLE__ --- 126,168 ---- installtion root (by default for ActiveState perl this is at F<C:/Perl/site/lib/Win32/GUI/demos>). There is ! a viewer/launcher application installed as well. Type C<win32-gui-demos> at a command prompt. + =head1 EXPORTS + + Release of Win32::GUI up to and including v1.03 export a large list of + constants into the callers namespace by default. This behaviour is + changed in releases from v1.04 and onwards. + + From v1.04 the support for constants is provided by + L<Win32::GUI::Constants|Win32::GUI::Constants>, and the prefered + way of getting constants exported into your namespace should be: + + use Win32::GUI(); # Empty export list to prevent default exports + use Win32::GUI::Constants qw( ... ) # explicitly list wanted constants + + although, for backwards compatibility the following are also supported: + + =over + + =item C<use Win32::GUI;> + + Will continue to export the same list of constants as earlier versions, + but will generate a warning (under the C<use warnings;> pragma or with + the C<-w> command line option to perl). In the future (v1.05 and later) + this syntax will stop exporting anything. v1.05 will generate a warning + that nothing is being exported. v1.06 will silently export nothing. + + =item C<use Win32::GUI qw( ... );> + + Will exported the requested list of constants. The full syntax + allowed by L<Win32::GUI::Constants|Win32::GUI::Constants> may be + used. + + =back + + Please see the L<v1.04 Release Notes|Win32::GUI::ReleaseNotes::RN_1_04> + for further information on backwards compatability and making old + scripts work. + __W32G_POSTAMBLE__