Update of /cvsroot/perl-win32-gui/Win32-GUI/Win32-GUI-ReleaseNotes
In directory
sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv32668/Win32-GUI-ReleaseNotes
Added Files:
RN_1_06.pod
Log Message:
Bug Fixes
--- NEW FILE: RN_1_06.pod ---
=head1 NAME
Win32::GUI::ReleaseNotes::RN_1_06 - release notes for v1.06 of Win32::GUI
=head1 Release Date
TBD
=head1 Summary of Changes
This is a summary of changes between V1.05 and V1.06
See the CHANGELOG file in the distribution for the
full detail.
This release is a XXX release addressing the issues
below.
=head2 New Features
There are no new features in this release.
=head2 Bug Fixes
=over
=item Baloon Tooltip info and warning icons swapped
Fix inverted info and warning icon for balloon
tooltips
=item Textfield::GetLine() truncates lines
Textfield::GetLine() has been re-written to stop it
truncating lines, and to correctly return empty
lines.
=item Error During Global Destruction
It was common to get an error like:
(in cleanup) Can't call method "DELETE" on an undefined value at C:/Perl
/site/lib/Win32/GUI.pm line 3451 during global destruction.
This is now, hopefully, fixed. Please report if you still see errors
like this.
=back
=head1 Deprecated feature status
This section documents features that have been deprecated
in this release, or in recent releases, and feature that
will be deprecated in up-coming releases.
=head2 Win32::GUI::Constants
The introduction of Win32::GUI::Constants in v1.04 means
that we now have access to a very large number of constants,
so the current behaviour of Win32::GUI to export all
constants to the calling namespace by default is no longer
appropriate. So, a bare
use Win32::GUI;
now generates a warning that the old default behaviour will
be deprecated - although the export behaviour of
Win32::GUI v1.03 is maintained except for this
warning.
To eliminate this warning and correct your script, do one
of the following:
=over
=item If you don't need any constants, use the empty list:
use Win32::GUI();
=item If you need some constants, name them explicitly:
use Win32::GUI qw(ES_WANTRETURN CW_USEDEFAULT); # Two constants exported
use Win32::GUI qw(/^MB_/); # Export all constants starting with MB_
=back
See the L<Win32::GUI::Constants|Win32::GUI::Constants> documentation
for the full allowable syntax.
You are advised to fix your scripts now, as a future version will stop
exporting any constants by default.
Although not advised, you can suppress the warnings by turning deprecated
warnings off:
no warnings 'deprecated';
Additionally accessing constants from within the Win32::GUI namespace
is deprecated. I.e.
-addstyle => Win32::GUI::WS_BORDER,
will generate a warning with this release, and will stop working with
a future release. Use one of the following methods instead:
=over
=item use the Win32::GUI::Constants namespace instead
-addstyle => Win32::GUI::Constants::WS_BORDER(),
=item use any other namespace you fancy
use Win32::GUI qw(-exportpkg => A::B -autoload);
...
-addstyle => A::B::WS_BORDER(),
=item maintain compatibility of existing scripts
use Win32::GUI::Constants qw(-exportpkg => Win32::GUI
:compatibility_win32_gui);
...
-addstyle => Win32::GUI::WS_BORDER,
=back
=head2 Win32::GUI::NotifyIcon
It is no longer necessary to use the '-id' option to any of the
Win32::GUI::NotifyIcon methods. The ID is now entirely handled
internally. You will receive deprecated warnings if you use it.
In particular, removing Icons from the system tray should be done
using
$NI->Remove();
and not by the (now deprecated)
$NI->Delete(-id => 1);
Use of the C<-id> option will generate a warning.
=head1 Contributors to this release
=over
=item Robert May
=item Brian Millham
=back
=cut
