This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
overload.pl -> regen/overload.pl
[perl5.git] / lib / bytes.pm
index 31294cb..6dad41a 100644 (file)
@@ -33,17 +33,17 @@ __END__
 
 bytes - Perl pragma to force byte semantics rather than character semantics
 
-=head1 DEPRECATED
+=head1 NOTICE
 
 This pragma reflects early attempts to incorporate Unicode into perl and
-has since been superceded. It breaks encapulation (i.e. it exposes the
-innards of how perl happens to be currently storing a string), and use of
-this module for anything other than debugging purposes is strongly
-discouraged. If you feel that the functions here within might be useful
-for your application, this possibly indicates a mismatch beteen your
-mental model of Perl Unicode and the current reality. In that case, you
-wish to peruse some of the perl Unicode documentation: L<perluniintro>,
-L<perlunitut>, L<perlunifaq> and L<perlunicode>.
+has since been superseded. It breaks encapsulation (i.e. it exposes the
+innards of how the perl executable currently happens to store a string),
+and use of this module for anything other than debugging purposes is
+strongly discouraged. If you feel that the functions here within might be
+useful for your application, this possibly indicates a mismatch between
+your mental model of Perl Unicode and the current reality. In that case,
+you may wish to read some of the perl Unicode documentation:
+L<perluniintro>, L<perlunitut>, L<perlunifaq> and L<perlunicode>.
 
 =head1 SYNOPSIS