Gecko [ paroquia-rio-de-mouro.pt ]

Name	Size	Permission	Date
App	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Archive	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Attribute	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
B	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
CPAN	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Carp	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Class	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Compress	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Config	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
DBM_Filter	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Devel	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Digest	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Encode	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Exporter	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
ExtUtils	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
File	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Filter	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Getopt	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
HTTP	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
I18N	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
IO	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
IPC	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
JSON	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Locale	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Math	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Memoize	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Module	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Net	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Params	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Parse	[ DIR ]	drwxr-xr-x	2016-11-15 15:18
Perl	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
PerlIO	[ DIR ]	drwxr-xr-x	2016-11-15 15:18
Pod	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Search	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
TAP	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Term	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Test	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Text	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Thread	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Tie	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Time	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
Unicode	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
User	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
autodie	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
encoding	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
overload	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
pod	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
unicore	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
version	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
warnings	[ DIR ]	drwxr-xr-x	2020-10-27 07:29
AnyDBM_File.pm	2.56 KB	-rw-r--r--	2020-10-19 12:57
AutoLoader.pm	5.36 KB	-rw-r--r--	2020-10-19 12:57
AutoSplit.pm	19.18 KB	-rw-r--r--	2020-10-19 12:57
Benchmark.pm	29.64 KB	-rw-r--r--	2020-10-19 12:57
CORE.pod	3.19 KB	-rw-r--r--	2020-10-19 12:57
CPAN.pm	136.68 KB	-rw-r--r--	2020-10-19 12:57
Carp.pm	19.6 KB	-rw-r--r--	2020-10-19 12:57
DB.pm	18.48 KB	-rw-r--r--	2020-10-19 12:57
DBM_Filter.pm	14.05 KB	-rw-r--r--	2020-10-19 12:57
Digest.pm	10.35 KB	-rw-r--r--	2020-10-19 12:57
DirHandle.pm	1.52 KB	-rw-r--r--	2020-10-19 12:57
Dumpvalue.pm	16.5 KB	-rw-r--r--	2020-10-19 12:57
English.pm	4.64 KB	-rw-r--r--	2020-10-19 12:57
Env.pm	5.39 KB	-rw-r--r--	2020-10-19 12:57
Exporter.pm	2.31 KB	-rw-r--r--	2020-10-19 12:57
Fatal.pm	59.2 KB	-rw-r--r--	2020-10-19 12:57
FileCache.pm	5.44 KB	-rw-r--r--	2020-10-19 12:57
FileHandle.pm	2.06 KB	-rw-r--r--	2020-10-19 12:57
FindBin.pm	4.45 KB	-rw-r--r--	2020-10-19 12:57
Memoize.pm	35.28 KB	-rw-r--r--	2020-10-19 12:57
NEXT.pm	18.05 KB	-rw-r--r--	2020-10-19 12:57
PerlIO.pm	10.21 KB	-rw-r--r--	2020-10-19 12:57
Safe.pm	24.4 KB	-rw-r--r--	2020-10-19 12:57
SelectSaver.pm	344 B	-rw-r--r--	2020-10-19 12:57
SelfLoader.pm	17.41 KB	-rw-r--r--	2020-10-19 12:57
Symbol.pm	2.05 KB	-rw-r--r--	2020-10-19 12:57
Test.pm	28.12 KB	-rw-r--r--	2020-10-19 12:57
Thread.pm	8.09 KB	-rw-r--r--	2020-10-19 12:57
UNIVERSAL.pm	6.44 KB	-rw-r--r--	2020-10-19 12:57
XSLoader.pm	3.95 KB	-rw-r--r--	2020-10-19 12:57
_charnames.pm	32.7 KB	-rw-r--r--	2020-10-19 12:57
autodie.pm	12.58 KB	-rw-r--r--	2020-10-19 12:57
autouse.pm	4.14 KB	-rw-r--r--	2020-10-19 12:57
base.pm	5.21 KB	-rw-r--r--	2020-10-19 12:57
bigint.pm	18.9 KB	-rw-r--r--	2020-10-19 12:57
bignum.pm	18.34 KB	-rw-r--r--	2020-10-19 12:57
bigrat.pm	14.23 KB	-rw-r--r--	2020-10-19 12:57
blib.pm	2.04 KB	-rw-r--r--	2020-10-19 12:57
bytes.pm	447 B	-rw-r--r--	2020-10-19 12:57
bytes_heavy.pl	758 B	-rw-r--r--	2020-10-19 12:57
charnames.pm	20.5 KB	-rw-r--r--	2020-10-19 12:57
constant.pm	5.6 KB	-rw-r--r--	2020-10-19 12:57
deprecate.pm	3.43 KB	-rw-r--r--	2020-10-19 12:57
diagnostics.pm	18.26 KB	-rw-r--r--	2020-10-19 12:57
dumpvar.pl	15.19 KB	-rw-r--r--	2020-10-19 12:57
experimental.pm	5.39 KB	-rw-r--r--	2020-10-19 12:57
feature.pm	4.08 KB	-rw-r--r--	2020-10-19 12:57
fields.pm	4.87 KB	-rw-r--r--	2020-10-19 12:57
filetest.pm	3.91 KB	-rw-r--r--	2020-10-19 12:57
if.pm	2.98 KB	-rw-r--r--	2020-10-19 12:57
integer.pm	172 B	-rw-r--r--	2020-10-19 12:57
less.pm	3.13 KB	-rw-r--r--	2020-10-19 12:57
locale.pm	2.81 KB	-rw-r--r--	2020-10-19 12:57
meta_notation.pm	2.17 KB	-rw-r--r--	2020-10-19 12:57
ok.pm	968 B	-rw-r--r--	2020-10-19 12:57
open.pm	7.83 KB	-rw-r--r--	2020-10-19 12:57
overload.pm	4.36 KB	-rw-r--r--	2020-10-19 12:57
overloading.pm	964 B	-rw-r--r--	2020-10-19 12:57
parent.pm	607 B	-rw-r--r--	2020-10-19 12:57
perl5db.pl	308.3 KB	-rw-r--r--	2020-10-19 12:57
perlfaq.pm	78 B	-rw-r--r--	2020-10-19 12:57
sigtrap.pm	7.43 KB	-rw-r--r--	2020-10-19 12:57
sort.pm	5.94 KB	-rw-r--r--	2020-10-19 12:57
strict.pm	1.48 KB	-rw-r--r--	2020-10-19 12:57
subs.pm	848 B	-rw-r--r--	2020-10-19 12:57
utf8.pm	342 B	-rw-r--r--	2020-10-19 12:57
utf8_heavy.pl	31.25 KB	-rw-r--r--	2020-10-19 12:57
vars.pm	1.12 KB	-rw-r--r--	2020-10-19 12:57
version.pm	1.58 KB	-rw-r--r--	2020-10-19 12:57
version.pod	9.62 KB	-rw-r--r--	2020-10-19 12:57
vmsish.pm	4.21 KB	-rw-r--r--	2020-10-19 12:57
warnings.pm	21.49 KB	-rw-r--r--	2020-10-19 12:57

Rename

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

# 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 = (
    # None for the perl 5.22 cycle
);

# 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
		}
	}
    }
}

__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