[perl #31730] [PATCH] IO::File reads garbage from directory filehandles

From: "Steve Peters via RT" <perlbug-followup@perl.org>
Message-ID: <rt-3.0.11-31730-107010.1.24399823945417@perl.org>

p4raw-id: //depot/perl@23974

diff --git a/ext/IO/lib/IO/File.pm b/ext/IO/lib/IO/File.pm
index f354f76..8c778f7 100644 (file)
--- a/ext/IO/lib/IO/File.pm
+++ b/ext/IO/lib/IO/File.pm
@@ -103,12 +103,20 @@ passed on to the C<binmode> call.
 
 =back
 
+=head1 NOTE
+
+Some operating systems may perform  C<IO::File::new()> or C<IO::File::open()>
+on a directory without errors.  This behavior is not portable and not
+suggested for use.  Using C<opendir()> and C<readdir()> or C<IO::Dir> are
+suggested instead.
+
 =head1 SEE ALSO
 
 L<perlfunc>, 
 L<perlop/"I/O Operators">,
-L<IO::Handle>
-L<IO::Seekable>
+L<IO::Handle>,
+L<IO::Seekable>,
+L<IO::Dir>
 
 =head1 HISTORY