From: David Mitchell <davem@iabyn.com>
Date: Mon, 22 Feb 2010 15:25:16 +0000 (+0000)
Subject: deprecate bytes.pm
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=a515200d681686a605e69620572e93eba2acd0a4;p=p5sagit%2Fp5-mst-13.2.git

deprecate bytes.pm
---

diff --git a/lib/bytes.pm b/lib/bytes.pm
index b7fabbf..31294cb 100644
--- a/lib/bytes.pm
+++ b/lib/bytes.pm
@@ -1,6 +1,6 @@
 package bytes;
 
-our $VERSION = '1.03';
+our $VERSION = '1.04';
 
 $bytes::hint_bits = 0x00000008;
 
@@ -33,6 +33,18 @@ __END__
 
 bytes - Perl pragma to force byte semantics rather than character semantics
 
+=head1 DEPRECATED
+
+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>.
+
 =head1 SYNOPSIS
 
     use bytes;