Upgrade to CPAN-1.88_62
[p5sagit/p5-mst-13.2.git] / lib / I18N / Collate.pm
index 6961dc2..132b425 100644 (file)
@@ -1,10 +1,8 @@
-#-----------------------------------------------------------------------#
-# NOTE! This module is deprecated (obsolete) after the Perl release     #
-# 5.003_06 as the functionality has been integrated into the Perl core. #
-#-----------------------------------------------------------------------#
-
 package I18N::Collate;
 
+use strict;
+our $VERSION = '1.00';
+
 =head1 NAME
 
 I18N::Collate - compare 8-bit scalar data according to the current locale
@@ -18,6 +16,23 @@ I18N::Collate - compare 8-bit scalar data according to the current locale
 
 =head1 DESCRIPTION
 
+  ***
+
+  WARNING: starting from the Perl version 5.003_06
+  the I18N::Collate interface for comparing 8-bit scalar data
+  according to the current locale
+
+       HAS BEEN DEPRECATED
+
+  That is, please do not use it anymore for any new applications
+  and please migrate the old applications away from it because its
+  functionality was integrated into the Perl core language in the
+  release 5.003_06.
+
+  See the perllocale manual page for further information.
+
+  ***
+
 This module provides you with objects that will collate 
 according to your national character set, provided that the 
 POSIX setlocale() function is supported on your system.
@@ -96,36 +111,42 @@ European character set.
 # ---
 
 use POSIX qw(strxfrm LC_COLLATE);
+use warnings::register;
 
 require Exporter;
 
-@ISA = qw(Exporter);
-@EXPORT = qw(collate_xfrm setlocale LC_COLLATE);
-@EXPORT_OK = qw();
+our @ISA = qw(Exporter);
+our @EXPORT = qw(collate_xfrm setlocale LC_COLLATE);
+our @EXPORT_OK = qw();
 
 use overload qw(
 fallback       1
 cmp            collate_cmp
 );
 
+our($LOCALE, $C);
+
+our $please_use_I18N_Collate_even_if_deprecated = 0;
 sub new {
   my $new = $_[1];
 
-  if ($^W && $] >= 5.003_06) {
+  if (warnings::enabled() && $] >= 5.003_06) {
     unless ($please_use_I18N_Collate_even_if_deprecated) {
-      warn <<___EOD___;
+      warnings::warn <<___EOD___;
 ***
 
-  WARNING: starting from the Perl version 5.003_06 the I18N::Collate
-  interface for comparing 8-bit scalar data according to the current locale
+  WARNING: starting from the Perl version 5.003_06
+  the I18N::Collate interface for comparing 8-bit scalar data
+  according to the current locale
 
        HAS BEEN DEPRECATED
 
-  (that is, please do not use it anymore for any new applications and please
-  migrate the old applications away from it) because its functionality was
-  integrated into the Perl core language in the release 5.003_06.
+  That is, please do not use it anymore for any new applications
+  and please migrate the old applications away from it because its
+  functionality was integrated into the Perl core language in the
+  release 5.003_06.
 
-  See pod/perllocale.pod for further information.
+  See the perllocale manual page for further information.
 
 ***
 ___EOD___