Document that File::Find doesn't follow symlinks

Subject: following symlinks with File::Find

The behaviour of File::Find with respect to symbolic links is inconsistent
between Perl 5.002/5.003 and 5.004_02.  Since 5.004_02's behaviour (don't
follow symlinks) is more consistent with `find' itself, this is probably
more of a documentation bug -- i.e., the File::Find man page should
mention that 1) it doesn't follow symlinks, and 2) previous versions
did, so watch out!

p5p-msgid: 199708191853.OAA07111@bottom.bic.mni.mcgill.ca

diff --git a/lib/File/Find.pm b/lib/File/Find.pm
index 1d565f2..033cfe5 100644 (file)
--- a/lib/File/Find.pm
+++ b/lib/File/Find.pm
@@ -65,6 +65,10 @@ that don't resolve:
        -l && !-e && print "bogus link: $File::Find::name\n";
     } 
 
+=head1 BUGS
+
+There is no way to make find or finddepth follow symlinks.
+
 =cut
 
 @ISA = qw(Exporter);