From e0f13c2688ac92b15301e7928294186416e6d2f4 Mon Sep 17 00:00:00 2001 From: Rafael Garcia-Suarez Date: Thu, 16 Nov 2006 11:55:07 +0000 Subject: [PATCH] Clarifications to close() docs, pointed out by Peter Dintelmann p4raw-id: //depot/perl@29294 --- pod/perlfunc.pod | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) 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 =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 on it, because C will close it for you. (See -- 2.7.4