This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #31730] [PATCH] IO::File reads garbage from directory filehandles
authorSteve Peters <steve@fisharerojo.org>
Tue, 1 Feb 2005 16:24:11 +0000 (16:24 +0000)
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>
Thu, 17 Feb 2005 14:57:06 +0000 (14:57 +0000)
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

ext/IO/lib/IO/File.pm

index f354f76..8c778f7 100644 (file)
@@ -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