SM0 She11

Full Path (server): /usr/share/perl5

📄 AnyDBM_File.pm [E] [D]
📁 App Open [D]
📁 Archive Open [D]
📁 Attribute Open [D]
📄 AutoLoader.pm [E] [D]
📄 AutoSplit.pm [E] [D]
📁 B Open [D]
📄 Benchmark.pm [E] [D]
📄 CORE.pod [E] [D]
📁 Class Open [D]
📁 Compress Open [D]
📁 Config Open [D]
📄 DB.pm [E] [D]
📁 DBM_Filter Open [D]
📄 DBM_Filter.pm [E] [D]
📁 Devel Open [D]
📄 DirHandle.pm [E] [D]
📄 Dumpvalue.pm [E] [D]
📁 Encode Open [D]
📄 English.pm [E] [D]
📁 ExtUtils Open [D]
📁 File Open [D]
📄 FileCache.pm [E] [D]
📄 FileHandle.pm [E] [D]
📁 Filter Open [D]
📄 FindBin.pm [E] [D]
📁 Getopt Open [D]
📁 HTTP Open [D]
📁 I18N Open [D]
📁 IO Open [D]
📁 IPC Open [D]
📁 JSON Open [D]
📁 LWP Open [D]
📄 LWP.pm [E] [D]
📁 Locale Open [D]
📁 Log Open [D]
📁 Math Open [D]
📁 Memoize Open [D]
📄 Memoize.pm [E] [D]
📁 Module Open [D]
📄 NEXT.pm [E] [D]
📁 Net Open [D]
📁 Package Open [D]
📁 Perl Open [D]
📁 PerlIO Open [D]
📄 PerlIO.pm [E] [D]
📁 Pod Open [D]
📄 Safe.pm [E] [D]
📁 Search Open [D]
📄 SelectSaver.pm [E] [D]
📄 SelfLoader.pm [E] [D]
📄 Symbol.pm [E] [D]
📁 Term Open [D]
📁 Test Open [D]
📄 Test.pm [E] [D]
📁 Text Open [D]
📁 Thread Open [D]
📄 Thread.pm [E] [D]
📁 Tie Open [D]
📁 Time Open [D]
📄 UNIVERSAL.pm [E] [D]
📁 URI Open [D]
📄 URI.pm [E] [D]
📁 Unicode Open [D]
📁 User Open [D]
📁 Version Open [D]
📄 XSLoader.pm [E] [D]
📄 _charnames.pm [E] [D]
📄 autouse.pm [E] [D]
📄 base.pm [E] [D]
📄 bigint.pm [E] [D]
📄 bignum.pm [E] [D]
📄 bigrat.pm [E] [D]
📄 blib.pm [E] [D]
📄 bytes.pm [E] [D]
📄 bytes_heavy.pl [E] [D]
📄 charnames.pm [E] [D]
📄 deprecate.pm [E] [D]
📄 diagnostics.pm [E] [D]
📄 dumpvar.pl [E] [D]
📁 encoding Open [D]
📄 feature.pm [E] [D]
📄 fields.pm [E] [D]
📄 filetest.pm [E] [D]
📄 if.pm [E] [D]
📄 integer.pm [E] [D]
📄 less.pm [E] [D]
📄 locale.pm [E] [D]
📄 lwpcook.pod [E] [D]
📄 lwptut.pod [E] [D]
📄 open.pm [E] [D]
📁 overload Open [D]
📄 overload.pm [E] [D]
📄 overloading.pm [E] [D]
📄 perl5db.pl [E] [D]
📄 perlfaq.pm [E] [D]
📁 pod Open [D]
📄 sigtrap.pm [E] [D]
📄 sort.pm [E] [D]
📄 strict.pm [E] [D]
📄 subs.pm [E] [D]
📁 unicore Open [D]
📄 utf8.pm [E] [D]
📄 utf8_heavy.pl [E] [D]
📄 vars.pm [E] [D]
📁 vendor_perl Open [D]
📄 vmsish.pm [E] [D]
📁 warnings Open [D]
📄 warnings.pm [E] [D]

Editing: deprecate.pm

package deprecate;
use strict;
use warnings;
our $VERSION = 0.02;

# our %Config can ignore %Config::Config, e.g. for testing
our %Config;
unless (%Config) { require Config; *Config = \%Config::Config; }

# This isn't a public API. It's internal to code maintained by the perl-porters
# If you would like it to be a public API, please send a patch with
# documentation and tests. Until then, it may change without warning.
sub __loaded_from_core {
    my ($package, $file, $expect_leaf) = @_;

foreach my $pair ([qw(sitearchexp archlibexp)],
		      [qw(sitelibexp privlibexp)]) {
	my ($site, $priv) = @Config{@$pair};
	if ($^O eq 'VMS') {
	    for my $d ($site, $priv) { $d = VMS::Filespec::unixify($d) };
	}
	# Just in case anyone managed to configure with trailing /s
	s!/*$!!g foreach $site, $priv;

next if $site eq $priv;
	if (uc("$priv/$expect_leaf") eq uc($file)) {
	    return 1;
	}
    }
    return 0;
}

sub import {
    my ($package, $file) = caller;

my $expect_leaf = "$package.pm";
    $expect_leaf =~ s!::!/!g;

if (__loaded_from_core($package, $file, $expect_leaf)) {
	my $call_depth=1;
	my @caller;
	while (@caller = caller $call_depth++) {
	    last if $caller[7]			# use/require
		and $caller[6] eq $expect_leaf;	# the package file
	}
	unless (@caller) {
	    require Carp;
	    Carp::cluck(<<"EOM");
Can't find use/require $expect_leaf in caller stack
EOM
	    return;
	}

# This is fragile, because it
	# is directly poking in the internals of warnings.pm
	my ($call_file, $call_line, $callers_bitmask) = @caller[1,2,9];

if (defined $callers_bitmask
	    && (vec($callers_bitmask, $warnings::Offsets{deprecated}, 1)
		|| vec($callers_bitmask, $warnings::Offsets{all}, 1))) {
	    warn <<"EOM";
$package will be removed from the Perl core distribution in the next major release. Please install it from CPAN. It is being used at $call_file, line $call_line.
EOM
	}
    }
}

__END__

=head1 NAME

deprecate - Perl pragma for deprecating the core version of a module

=head1 SYNOPSIS

use deprecate;	# always deprecate the module in which this occurs

use if $] > 5.010, 'deprecate';	# conditionally deprecate the module

=head1 DESCRIPTION

This module is used using C<use deprecate;> (or something that calls
C<< deprecate->import() >>, for example C<use if COND, deprecate;>).

If the module that includes C<use deprecate> is located in a core library
directory, a deprecation warning is issued, encouraging the user to use
the version on CPAN.  If that module is located in a site library, it is
the CPAN version, and no warning is issued.

=head2 EXPORT

None by default.  The only method is C<import>, called by C<use deprecate;>.

=head1 SEE ALSO

First example to C<use deprecate;> was L<Switch>.

=head1 AUTHOR

Original version by Nicholas Clark

=head1 COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.10.0 or,
at your option, any later version of Perl 5 you may have available.

=cut