summaryrefslogtreecommitdiff
path: root/lib/I18N
diff options
context:
space:
mode:
Diffstat (limited to 'lib/I18N')
-rw-r--r--lib/I18N/Collate.pm39
1 files changed, 37 insertions, 2 deletions
diff --git a/lib/I18N/Collate.pm b/lib/I18N/Collate.pm
index 0d8314e12e..5d1e14157e 100644
--- a/lib/I18N/Collate.pm
+++ b/lib/I18N/Collate.pm
@@ -1,3 +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;
=head1 NAME
@@ -87,7 +92,7 @@ ISO Latin (8859) 1 (-1) which is the Western European character set.
# variant of French (fr), ISO Latin (8859) 1 (-1)
# which is the Western European character set.
#
-# Updated: 19960104 1946 GMT
+# Updated: 19961005
#
# ---
@@ -104,7 +109,37 @@ fallback 1
cmp collate_cmp
);
-sub new { my $new = $_[1]; bless \$new }
+sub new {
+ my $new = $_[1];
+
+ if ($^W && $] >= 5.003_06) {
+ unless ($please_use_I18N_Collate_even_if_deprecated) {
+ 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
+
+ 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.
+
+ All scalar data is now collated according to the current locale setting.
+ Also, Perl does automatically the setlocale(LC_COLLATE, "") for you.
+
+ To convert: forget I18N::Collate completely and use scalar data in
+ a completely normal way.
+
+***
+___EOD___
+ $please_use_I18N_Collate_even_if_deprecated++;
+ }
+ }
+
+ bless \$new;
+}
sub setlocale {
my ($category, $locale) = @_[0,1];