--- /home/steve/perl-current/ext/IO/lib/IO/File.pm	Tue Nov  9 12:19:23 2004
+++ ./File.pm	Tue Feb  1 10:20:13 2005
@@ -103,12 +103,20 @@
 
 =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::Dir>
 
 =head1 HISTORY