Front page | perl.perl5.porters |
Postings from February 2010
On Sun, Jan 03, 2010 at 11:27:22PM +0000, Dave Mitchell wrote:
> I think these days there's a general consensus that, for normal day-to-day
> tasks, the user has no need for bytes.pm, and indeed, that most naive use
> of it is likely to be harmful.
>
> Given that, should we add a warning to bytes.pm's pod to the effect that
> you shouldn't be using this for new code unless you really know what you're
> doing, and that a desire to do so probably indicates a design flaw in your
> code or your understanding of perl's Unicode implementation?
Following the discussion, I've committed the following:
commit a515200d681686a605e69620572e93eba2acd0a4
Author: David Mitchell <davem@iabyn.com>
AuthorDate: Mon Feb 22 15:25:16 2010 +0000
Commit: David Mitchell <davem@iabyn.com>
CommitDate: Mon Feb 22 15:25:16 2010 +0000
deprecate bytes.pm
Affected files ...
M lib/bytes.pm
Differences ...
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;
--
Please note that ash-trays are provided for the use of smokers,
whereas the floor is provided for the use of all patrons.
-- Bill Royston
Thread Previous
|
Thread Next