From: Jarkko Hietaniemi <jhi@iki.fi>
Date: Thu, 18 Jul 2002 18:20:57 +0000 (+0000)
Subject: File::stat bug + workarounds, based on Yves Orton's patch.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=5c4d99470a2052457ff93a178c3cf9fd15239160;p=p5sagit%2Fp5-mst-13.2.git

File::stat bug + workarounds, based on Yves Orton's patch.

p4raw-id: //depot/perl@17627
---

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