[perl #35847] File::Find not performing as documented

From: "jms@mathras.comcast.net (via RT)" <perlbug-followup@perl.org>
Message-ID: <rt-3.0.11-35847-113088.7.09182163210095@perl.org>

p4raw-id: //depot/perl@26076

diff --git a/lib/File/Find.pm b/lib/File/Find.pm
index b481fd8..e41c241 100644 (file)
--- a/lib/File/Find.pm
+++ b/lib/File/Find.pm
@@ -120,8 +120,11 @@ If either I<follow> or I<follow_fast> is in effect:
 
 =item *
 
-It is guaranteed that an I<lstat> has been called before the user's
-C<wanted()> function is called. This enables fast file checks involving S< _>.
+Previous versions of File::Find were guaranteed to call an I<lstat>
+before the user's C<wanted()> function was called, but this is no
+longer the case.  Since this depends on C<$File::Find::dont_use_nlink>, $^O,
+and other factors, fast file checks involving C<_> are not recommended
+unless C<wanted()> calls I<lstat> first.
 
 =item *