Integrate perlio:

[p5sagit/p5-mst-13.2.git] / pod / perlrun.pod

diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index 564d111..2531838 100644 (file)
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -166,7 +166,7 @@ common) and how to protect whitespace and these characters to run
 one-liners (see B<-e> below).
 
 On some systems, you may have to change single-quotes to double ones,
-which you must I<not> do on Unix or Plan9 systems.  You might also
+which you must I<not> do on Unix or Plan 9 systems.  You might also
 have to change a single % to a %%.
 
 For example:
@@ -876,7 +876,7 @@ variable are summarised below. For more details see L<PerlIO>.
 =item :bytes
 
 Turns I<off> the C<:utf8> flag for the layer below.
-Unlikey to be useful in global PERLIO environment variable.
+Unlikely to be useful in global PERLIO environment variable.
 
 =item :crlf
 
@@ -909,19 +909,21 @@ C<:perlio> will insert a C<:unix> layer below itself to do low level IO.
 
 =item :raw
 
+B<Note that the explicit use of the C<:raw> layer is deprecated.>
+
 Arranges for all accesses go straight to the lowest level layer provided
 by the configration. That is it strips off any layers above that layer.
 (The intent - unless layers are then pushed on top again -
 is to make perl's C<read> behave like C<sysread>.)
 
-Not really useful in PERLIO environment variable, instead just use C<:unix>
-layer explicitly.
+Not really useful in PERLIO environment variable, instead just use
+C<:unix> layer explicitly.
 
-In perl5.6 and some books the C<:raw> layer (also called a discipline) is
-documented as the inverse of the C<:crlf> layer. That is not really the case.
-If you want UNIX line endings on a platform that normaly does CRLF translation
-the appropriate thing to do is to add C<:perlio> to PERLIO environment
-variable.
+In Perl 5.6 and some books the C<:raw> layer (also called a discipline)
+is documented as the inverse of the C<:crlf> layer. That is not really
+the case.  If you want UNIX line endings on a platform that normally
+does CRLF translation the appropriate thing to do is to add C<:perlio>
+to PERLIO environment variable.
 
 =item :stdio
 
@@ -963,7 +965,7 @@ implementation.
 
 On Win32 the default in this release is "unix crlf". Win32's "stdio"
 has a number of bugs/mis-features for perl IO which are somewhat
-C compiler verndor/version dependant. Using our own C<crlf> layer as
+C compiler vendor/version dependent. Using our own C<crlf> layer as
 the buffer avoids those issues and makes things more uniform.
 The C<crlf> layer provides CRLF to/from "\n" conversion as well as
 buffering.