This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Deprecate (or at least discourage) :raw.
authorJarkko Hietaniemi <jhi@iki.fi>
Sun, 16 Jun 2002 17:06:31 +0000 (17:06 +0000)
committerJarkko Hietaniemi <jhi@iki.fi>
Sun, 16 Jun 2002 17:06:31 +0000 (17:06 +0000)
p4raw-id: //depot/perl@17260

pod/perldelta.pod

index dfb6b93..7fd8a07 100644 (file)
@@ -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