CYG23-544-stat

[p5sagit/p5-mst-13.2.git] / lib / stat.pl

diff --git a/lib/stat.pl b/lib/stat.pl
index 8cf0bde..a84b0ac 100644 (file)
--- a/lib/stat.pl
+++ b/lib/stat.pl
@@ -1,9 +1,15 @@
-;# $Header: stat.pl,v 3.0 89/10/18 15:19:53 lwall Locked $
-
+;# This legacy library is deprecated and will be removed in a future
+;# release of perl.
+;#
 ;# Usage:
+;#     require 'stat.pl';
 ;#     @ary = stat(foo);
 ;#     $st_dev = @ary[$ST_DEV];
 ;#
+
+warn( "The 'stat.pl' legacy library is deprecated and will be"
+      . " removed in the next major release of perl." );
+
 $ST_DEV =      0 + $[;
 $ST_INO =      1 + $[;
 $ST_MODE =     2 + $[;
@@ -19,6 +25,7 @@ $ST_BLKSIZE = 11 + $[;
 $ST_BLOCKS =   12 + $[;
 
 ;# Usage:
+;#     require 'stat.pl';
 ;#     do Stat('foo');         # sets st_* as a side effect
 ;#
 sub Stat {