Clarifications to close() docs, pointed out by Peter Dintelmann
Rafael Garcia-Suarez [Thu, 16 Nov 2006 11:55:07 +0000 (11:55 +0000)]
p4raw-id: //depot/perl@29294

pod/perlfunc.pod

index 2f2bbe4..6703c6d 100644 (file)
@@ -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