summaryrefslogtreecommitdiff
path: root/pod
diff options
context:
space:
mode:
authorRafael Garcia-Suarez <rgarciasuarez@gmail.com>2006-11-16 11:55:07 +0000
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2006-11-16 11:55:07 +0000
commite0f13c2688ac92b15301e7928294186416e6d2f4 (patch)
tree246263b446a76c0dbbc233579e2a98c60a216a8b /pod
parentadc09a0e5b2b0588d0a62db3176ffdfc7657b8ac (diff)
downloadperl-e0f13c2688ac92b15301e7928294186416e6d2f4.tar.gz
Clarifications to close() docs, pointed out by Peter Dintelmann
p4raw-id: //depot/perl@29294
Diffstat (limited to 'pod')
-rw-r--r--pod/perlfunc.pod9
1 files changed, 5 insertions, 4 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 2f2bbe4988..6703c6d6f6 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