deprecate(3pm) [osx man page]
deprecate(3pm) Perl Programmers Reference Guide deprecate(3pm) NAME
deprecate - Perl pragma for deprecating the core version of a module SYNOPSIS
use deprecate; # always deprecate the module in which this occurs use if $] > 5.010, 'deprecate'; # conditionally deprecate the module DESCRIPTION
This module is used using "use deprecate;" (or something that calls "deprecate->import()", for example "use if COND, deprecate;"). If the module that includes "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. EXPORT None by default. The only method is "import", called by "use deprecate;". SEE ALSO
First example to "use deprecate;" was Switch. AUTHOR
Original version by Nicholas Clark 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. perl v5.16.2 2012-10-11 deprecate(3pm)
Check Out this Related Man Page
Carp::Always(3pm) User Contributed Perl Documentation Carp::Always(3pm) NAME
Carp::Always - Warns and dies noisily with stack backtraces SYNOPSIS
use Carp::Always; makes every "warn()" and "die()" complains loudly in the calling package and elsewhere. More often used on the command line: perl -MCarp::Always script.pl DESCRIPTION
This module is meant as a debugging aid. It can be used to make a script complain loudly with stack backtraces when warn()ing or die()ing. Here are how stack backtraces produced by this module looks: # it works for explicit die's and warn's $ perl -MCarp::Always -e 'sub f { die "arghh" }; sub g { f }; g' arghh at -e line 1 main::f() called at -e line 1 main::g() called at -e line 1 # it works for interpreter-thrown failures $ perl -MCarp::Always -w -e 'sub f { $a = shift; @a = @$a };' -e 'sub g { f(undef) }; g' Use of uninitialized value in array dereference at -e line 1 main::f('undef') called at -e line 2 main::g() called at -e line 2 In the implementation, the "Carp" module does the heavy work, through "longmess()". The actual implementation sets the signal hooks $SIG{__WARN__} and $SIG{__DIE__} to emit the stack backtraces. Oh, by the way, "carp" and "croak" when requiring/using the "Carp" module are also made verbose, behaving like "cluck" and "confess", respectively. EXPORT Nothing at all is exported. ACKNOWLEDGMENTS
This module was born as a reaction to a release of Acme::JavaTrace by Sebastien Aperghis-Tramoni. Sebastien also has a newer module called Devel::SimpleTrace with the same code and fewer flame comments on docs. The pruning of the uselessly long docs of this module were prodded by Michael Schwern. Schwern and others told me "the module name stinked" - it was called "Carp::Indeed". After thinking long and not getting nowhere, I went with nuffin's suggestion and now it is called "Carp::Always". "Carp::Indeed" which is now deprecate lives in its own distribution (which won't go anywhere but will stay there as a redirection to this module). SEE ALSO
o Carp o Acme::JavaTrace and Devel::SimpleTrace o Carp::Always::Color o Carp::Source::Always Please report bugs via CPAN RT http://rt.cpan.org/NoAuth/Bugs.html?Dist=Carp-Always. BUGS
Every (un)deserving module has its own pet bugs. o This module does not play well with other modules which fusses around with "warn", "die", $SIG{'__WARN__'}, $SIG{'__DIE__'}. o Test scripts are good. I should write more of these. o I don't know if this module name is still a bug as it was at the time of "Carp::Indeed". AUTHOR
Adriano Ferreira, <ferreira@cpan.org> COPYRIGHT AND LICENSE
Copyright (C) 2005-2012 by Adriano R. Ferreira This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.14.2 2012-04-18 Carp::Always(3pm)