X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FFile%2Fstat.pm;h=132cbee27ada7bb6691b1dd631997b455033db44;hb=68c65ec0adda9d2b3fc21f30f68be0ef10de5ad8;hp=af75befe85e7c2f02533d054eeead23152cd1506;hpb=83716b1ec25b41f24c18a3bf323e7910d4cadf90;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/lib/File/stat.pm b/lib/File/stat.pm
index af75bef..132cbee 100644
--- a/lib/File/stat.pm
+++ b/lib/File/stat.pm
@@ -115,6 +115,20 @@ function functions with their full qualified names.
 On the other hand, the built-ins are still available
 via the C<CORE::> pseudo-package.
 
+=head1 BUGS
+
+As of Perl 5.8.0 after using this module you cannot use the implicit
+C<$_> or the special filehandle C<_> with stat() or lstat(), trying
+to do so leads into strange errors.  The workaround is for C<$_> to
+be explicit
+
+    my $stat_obj = stat $_;
+
+and for C<_> to explicitly populate the object using the unexported
+and undocumented populate() function with CORE::stat():
+
+    my $stat_obj = File::stat::populate(CORE::stat(_));
+
 =head1 NOTE
 
 While this class is currently implemented using the Class::Struct