summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2001-08-23 00:29:06 +0100
committerNick Ing-Simmons <nik@tiuk.ti.com>2001-08-25 14:52:33 +0000
commite940ddbba91304b2a80fdaa904f5b12c22b13e0a (patch)
tree85c91ca3396fe501cdf9e4b4a81c05766f2a48ff /pod
parentc5cf9ec268be725ef943af3a8c93c6ce5c5492de (diff)
downloadperl-e940ddbba91304b2a80fdaa904f5b12c22b13e0a.tar.gz
(was Re: PerlIO regerssion tests?)
Message-Id: <20010822232906.Z82818@plum.flirble.org> p4raw-id: //depot/perl@11747
Diffstat (limited to 'pod')
-rw-r--r--pod/perlfunc.pod5
1 files changed, 2 insertions, 3 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index b4c37112c7..951fadab52 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -450,13 +450,12 @@ on systems where the run-time libraries distinguish between binary and
text files. If FILEHANDLE is an expression, the value is taken as the
name of the filehandle. DISCIPLINE can be either of C<":raw"> for
binary mode or C<":crlf"> for "text" mode. If the DISCIPLINE is
-omitted, it defaults to C<":raw">.
+omitted, it defaults to C<":raw">. Returns true on success, C<undef> on
+failure.
binmode() should be called after open() but before any I/O is done on
the filehandle.
-On many systems binmode() currently has no effect, but in future, it
-will be extended to support user-defined input and output disciplines.
On some systems binmode() is necessary when you're not working with a
text file. For the sake of portability it is a good idea to always use
it when appropriate, and to never use it when it isn't appropriate.