Change 20489 by [EMAIL PROTECTED] on 2003/08/05 06:21:47
Subject: PerlIO_{read,write} return value doc patch
From: Gisle Aas <[EMAIL PROTECTED]>
Date: 04 Aug 2003 13:25:28 -0700
Message-ID: <[EMAIL PROTECTED]>
Affected files ...
... //depot/perl/pod/perlapio.pod#23 edit
Differences ...
==== //depot/perl/pod/perlapio.pod#23 (text) ====
Index: perl/pod/perlapio.pod
--- perl/pod/perlapio.pod#22~20049~ Mon Jul 7 02:08:19 2003
+++ perl/pod/perlapio.pod Mon Aug 4 23:21:47 2003
@@ -160,9 +160,14 @@
=item B<PerlIO_read(f,buf,count)>, B<PerlIO_write(f,buf,count)>
-These correspond to fread() and fwrite(). Note that arguments are
-different, there is only one "count" and order has "file"
-first. Returns a byte count if successful (which may be zero or
+These correspond functionally to fread() and fwrite() but the
+arguments and return values are different. The PerlIO_read() and
+PerlIO_write() signatures have been modeled on the more sane low level
+read() and write() functions instead: The "file" argument is passed
+first, there is only one "count", and the return value can distinguish
+between error and C<EOF>.
+
+Returns a byte count if successful (which may be zero or
positive), returns negative value and sets C<errno> on error.
Depending on implementation C<errno> may be C<EINTR> if operation was
interrupted by a signal.
End of Patch.
