From a515200d681686a605e69620572e93eba2acd0a4 Mon Sep 17 00:00:00 2001 From: David Mitchell Date: Mon, 22 Feb 2010 15:25:16 +0000 Subject: [PATCH] deprecate bytes.pm --- lib/bytes.pm | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) 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, +L, L and L. + =head1 SYNOPSIS use bytes; -- 2.7.4