add files and tweaks needed for MPE/iX port (via PM)
[p5sagit/p5-mst-13.2.git] / lib / I18N / Collate.pm
index 343cb02..580ca39 100644 (file)
@@ -1,14 +1,26 @@
-#-----------------------------------------------------------------------#
-# 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
 
 I18N::Collate - compare 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.
+
+  See the perllocale manual page for further information.
+
+  ***
+
 =head1 SYNOPSIS
 
     use I18N::Collate;
@@ -47,10 +59,10 @@ European character set.
 
 # I18N::Collate.pm
 #
-# Author:      Jarkko Hietaniemi <Jarkko.Hietaniemi@hut.fi>
+# Author:      Jarkko Hietaniemi <F<jhi@iki.fi>>
 #              Helsinki University of Technology, Finland
 #
-# Acks:                Guy Decoux <decoux@moulon.inra.fr> understood
+# Acks:                Guy Decoux <F<decoux@moulon.inra.fr>> understood
 #              overloading magic much deeper than I and told
 #              how to cut the size of this code by more than half.
 #              (my first version did overload all of lt gt eq le ge cmp)
@@ -116,16 +128,18 @@ sub new {
       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___