summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTony Cook <tony@develop-help.com>2012-03-18 10:26:22 +1100
committerTony Cook <tony@develop-help.com>2012-03-23 22:45:47 +1100
commit7476a79c8db21237e6b6bcf579243fdfc880f8b9 (patch)
tree1d392ffe16b8f954bc06be45ad1e93829ee8a2df
parent15d94df60eb08a44107e2aaf4c9e5e8b26e084b6 (diff)
downloadperl-7476a79c8db21237e6b6bcf579243fdfc880f8b9.tar.gz
[rt #79960] document how broken $/ = \N is for unicode streams
It's kind of late in the release process to change how $/ = \N works for unicode streams, briefly document how broken it is and let the user know it may change.
-rw-r--r--pod/perlvar.pod7
1 files changed, 7 insertions, 0 deletions
diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index 72968f1b80..ea1f601a80 100644
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -1348,6 +1348,13 @@ want to read in record mode is probably unusable in line mode.)
Non-VMS systems do normal I/O, so it's safe to mix record and
non-record reads of a file.
+If you perform a record read on a FILE with an encoding layer such as
+C<:encoding(latin1)> or C<:utf8>, you may get an invalid string as a
+result, may leave the FILE positioned between characters in the stream
+and may not be reading the number of bytes from the underlying file
+that you specified. This behaviour may change without warning in a
+future version of perl.
+
See also L<perlport/"Newlines">. Also see L</$.>.
Mnemonic: / delimits line boundaries when quoting poetry.