From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Sun, 16 Jun 2002 17:06:31 +0000 (+0000)
Subject: Deprecate (or at least discourage) :raw.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=73c63b5048398e3891c05a43e441c5900263864e;p=p5sagit%2Fp5-mst-13.2.git

Deprecate (or at least discourage) :raw.

p4raw-id: //depot/perl@17260
---

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index dfb6b93..7fd8a07 100644
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -233,6 +233,15 @@ source code level, this shouldn't be that drastic a change.
 
 =item *
 
+The PerlIO C<:raw> discipline (as described in Camel III) is deprecated
+because its definition (as either the discipline version of C<binmode(FH)>
+or as the opposite of C<:crlf>) didn't really work: most importantly
+because turning off "clrfness" is not enough to make a stream truly
+binary.  Instead of C<:raw> use one of the following: C<open(..., ':bytes')>,
+C<binmode(FH)>, C<sysopen()> + C<sysread()>.
+
+=item *
+
 The current user-visible implementation of pseudo-hashes (the weird
 use of the first array element) is deprecated starting from Perl 5.8.0
 and will be removed in Perl 5.10.0, and the feature will be