| Server IP : 79.136.114.73 / Your IP : 18.224.32.173 Web Server : Apache/2.4.7 (Ubuntu) PHP/5.5.9-1ubuntu4.29 OpenSSL/1.0.1f System : Linux b8009 3.13.0-170-generic #220-Ubuntu SMP Thu May 9 12:40:49 UTC 2019 x86_64 User : www-data ( 33) PHP Version : 5.5.9-1ubuntu4.29 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority, MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/share/perl/5.18/ |
Upload File : |
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; }
# Debian-specific change: recommend the separate Debian packages of
# deprecated modules where available
our %DEBIAN_PACKAGES = (
'Archive::Extract' => 'libarchive-extract-perl',
'B::Lint' => 'libb-lint-perl',
'B::Lint::Debug' => 'libb-lint-perl',
'CPANPLUS::Dist::Build' => 'libcpanplus-dist-build-perl',
'CPANPLUS::Dist::Build::Constants' => 'libcpanplus-dist-build-perl',
'CPANPLUS' => 'libcpanplus-perl',
'CPANPLUS::Backend' => 'libcpanplus-perl',
'CPANPLUS::Backend::RV' => 'libcpanplus-perl',
'CPANPLUS::Config' => 'libcpanplus-perl',
'CPANPLUS::Config::HomeEnv' => 'libcpanplus-perl',
'CPANPLUS::Configure' => 'libcpanplus-perl',
'CPANPLUS::Configure::Setup' => 'libcpanplus-perl',
'CPANPLUS::Dist' => 'libcpanplus-perl',
'CPANPLUS::Dist::Autobundle' => 'libcpanplus-perl',
'CPANPLUS::Dist::Base' => 'libcpanplus-perl',
'CPANPLUS::Dist::MM' => 'libcpanplus-perl',
'CPANPLUS::Dist::Sample' => 'libcpanplus-perl',
'CPANPLUS::Error' => 'libcpanplus-perl',
'CPANPLUS::Internals' => 'libcpanplus-perl',
'CPANPLUS::Internals::Constants' => 'libcpanplus-perl',
'CPANPLUS::Internals::Constants::Report' => 'libcpanplus-perl',
'CPANPLUS::Internals::Extract' => 'libcpanplus-perl',
'CPANPLUS::Internals::Fetch' => 'libcpanplus-perl',
'CPANPLUS::Internals::Report' => 'libcpanplus-perl',
'CPANPLUS::Internals::Search' => 'libcpanplus-perl',
'CPANPLUS::Internals::Source' => 'libcpanplus-perl',
'CPANPLUS::Internals::Source::Memory' => 'libcpanplus-perl',
'CPANPLUS::Internals::Source::SQLite' => 'libcpanplus-perl',
'CPANPLUS::Internals::Source::SQLite::Tie' => 'libcpanplus-perl',
'CPANPLUS::Internals::Utils' => 'libcpanplus-perl',
'CPANPLUS::Internals::Utils::Autoflush' => 'libcpanplus-perl',
'CPANPLUS::Module' => 'libcpanplus-perl',
'CPANPLUS::Module::Author' => 'libcpanplus-perl',
'CPANPLUS::Module::Author::Fake' => 'libcpanplus-perl',
'CPANPLUS::Module::Checksums' => 'libcpanplus-perl',
'CPANPLUS::Module::Fake' => 'libcpanplus-perl',
'CPANPLUS::Module::Signature' => 'libcpanplus-perl',
'CPANPLUS::Selfupdate' => 'libcpanplus-perl',
'CPANPLUS::Shell' => 'libcpanplus-perl',
'CPANPLUS::Shell::Classic' => 'libcpanplus-perl',
'CPANPLUS::Shell::Default' => 'libcpanplus-perl',
'CPANPLUS::Shell::Default::Plugins::CustomSource' => 'libcpanplus-perl',
'CPANPLUS::Shell::Default::Plugins::Remote' => 'libcpanplus-perl',
'CPANPLUS::Shell::Default::Plugins::Source' => 'libcpanplus-perl',
'File::CheckTree' => 'libfile-checktree-perl',
'Log::Message::Simple' => 'liblog-message-simple-perl',
'Log::Message' => 'liblog-message-perl',
'Log::Message::Config' => 'liblog-message-perl',
'Log::Message::Handlers' => 'liblog-message-perl',
'Log::Message::Item' => 'liblog-message-perl',
'Devel::InnerPackage' => 'libmodule-pluggable-perl',
'Module::Pluggable' => 'libmodule-pluggable-perl',
'Module::Pluggable::Object' => 'libmodule-pluggable-perl',
'Object::Accessor' => 'libobject-accessor-perl',
'Pod::LaTeX' => 'libpod-latex-perl',
'Term::UI' => 'libterm-ui-perl',
'Term::UI::History' => 'libterm-ui-perl',
'Text::Soundex' => 'libtext-soundex-perl',
);
# 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))) {
if (my $deb = $DEBIAN_PACKAGES{$package}) {
warn <<"EOM";
$package will be removed from the Perl core distribution in the next major release. Please install the separate $deb package. It is being used at $call_file, line $call_line.
EOM
} else {
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
}
}
}
}
1;
__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
Copyright (C) 2009, 2011
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