From: Rafael Garcia-Suarez <rgarciasuarez@gmail.com>
Date: Thu, 16 Nov 2006 11:55:07 +0000 (+0000)
Subject: Clarifications to close() docs, pointed out by Peter Dintelmann
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=e0f13c2688ac92b15301e7928294186416e6d2f4;p=p5sagit%2Fp5-mst-13.2.git

Clarifications to close() docs, pointed out by Peter Dintelmann

p4raw-id: //depot/perl@29294
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 2f2bbe4..6703c6d 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -870,10 +870,11 @@ X<close>
 
 =item close
 
-Closes the file or pipe associated with the file handle, returning
-true only if IO buffers are successfully flushed and closes the system
-file descriptor.  Closes the currently selected filehandle if the
-argument is omitted.
+Closes the file or pipe associated with the file handle, flushes the IO
+buffers, and closes the system file descriptor.  Returns true if those
+operations have succeeded and if no error was reported by any PerlIO
+layer.  Closes the currently selected filehandle if the argument is
+omitted.
 
 You don't have to close FILEHANDLE if you are immediately going to do
 another C<open> on it, because C<open> will close it for you.  (See