RE: [PATCH] Implement ${^WIN32_SLOPPY_STAT}

From: "Jan Dubois" <jand@activestate.com>
Message-ID: <013901c66edd$fb8ae750$d045a8c0@candy>

p4raw-id: //depot/perl@28083

diff --git a/pod/perlvar.pod b/pod/perlvar.pod
index e8a38cb..ac75f0c 100644 (file)
--- a/pod/perlvar.pod
+++ b/pod/perlvar.pod
@@ -1198,6 +1198,19 @@ related to the B<-w> switch.)  See also L<warnings>.
 The current set of warning checks enabled by the C<use warnings> pragma.
 See the documentation of C<warnings> for more details.
 
+=item ${^WIN32_SLOPPY_STAT}
+
+If this variable is set to a true value, then stat() on Windows will
+not try to open the file. This means that the link count cannot be
+determined and file attributes may be out of date if additional
+hardlinks to the file exist. On the other hand, not opening the file
+is considerably faster, especially for files on network drives.
+
+This variable could be set in the F<sitecustomize.pl> file to
+configure the local Perl installation to use "sloppy" stat() by
+default.  See L<perlrun> for more information about site
+customization.
+
 =item $EXECUTABLE_NAME
 
 =item $^X