From: Steve Peters <steve@fisharerojo.org>
Date: Tue, 1 Feb 2005 16:24:11 +0000 (+0000)
Subject: [perl #31730] [PATCH] IO::File reads garbage from directory filehandles
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=fd172bcd67687fb9a94b92c46d2c582cce40a2c1;p=p5sagit%2Fp5-mst-13.2.git

[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
--- 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