charnames.pm: Clarify comments

[perl5.git] / lib / stat.pl

diff --git a/lib/stat.pl b/lib/stat.pl
index 1895c58..feda273 100644 (file)
--- a/lib/stat.pl
+++ b/lib/stat.pl
@@ -1,27 +1,35 @@
-;# $Header: stat.pl,v 2.0 88/06/05 00:16:29 root Exp $
+warn "Legacy library @{[(caller(0))[6]]} will be removed from the Perl core distribution in the next major release. Please install it from the CPAN distribution Perl4::CoreLibs. It is being used at @{[(caller)[1]]}, line @{[(caller)[2]]}.\n";
 
+;# 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];
 ;#
-$ST_DEV =      0 + $[;
-$ST_INO =      1 + $[;
-$ST_MODE =     2 + $[;
-$ST_NLINK =    3 + $[;
-$ST_UID =      4 + $[;
-$ST_GID =      5 + $[;
-$ST_RDEV =     6 + $[;
-$ST_SIZE =     7 + $[;
-$ST_ATIME =    8 + $[;
-$ST_MTIME =    9 + $[;
-$ST_CTIME =    10 + $[;
-$ST_BLKSIZE =  11 + $[;
-$ST_BLOCKS =   12 + $[;
+
+$ST_DEV =      0;
+$ST_INO =      1;
+$ST_MODE =     2;
+$ST_NLINK =    3;
+$ST_UID =      4;
+$ST_GID =      5;
+$ST_RDEV =     6;
+$ST_SIZE =     7;
+$ST_ATIME =    8;
+$ST_MTIME =    9;
+$ST_CTIME =    10;
+$ST_BLKSIZE =  11;
+$ST_BLOCKS =   12;
 
 ;# Usage:
+;#     require 'stat.pl';
 ;#     do Stat('foo');         # sets st_* as a side effect
 ;#
 sub Stat {
     ($st_dev,$st_ino,$st_mode,$st_nlink,$st_uid,$st_gid,$st_rdev,$st_size,
        $st_atime,$st_mtime,$st_ctime,$st_blksize,$st_blocks) = stat(shift(@_));
 }
+
+1;