The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Carp::Source::Always - Warns and dies with stack backtraces and source code context

VERSION

version 1.101420

DESCRIPTION

This module is meant as a debugging aid.

  use Carp::Source::Always;

makes every warn() and die() complain loudly, with stack traces and source code context like Carp::Source, in the calling package and elsewhere. It can also be used on the command line:

  perl -MCarp::Source::Always script.pl

You can specify the same options as Carp::Source's source_cluck() takes, separated by commas. For example:

    perl -MCarp::Source::Always=lines,5,color,'yellow on_blue' script.pl

It does not work for one-liners because there is no file from which to load source code.

This module does not play well with other modules which modify with warn, die, $SIG{__WARN__}, or $SIG{__DIE__}.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at http://rt.cpan.org/Public/Dist/Display.html?Name=Carp-Source.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit http://www.perl.com/CPAN/ to find a CPAN site near you, or see http://search.cpan.org/dist/Carp-Source/.

The development version lives at http://github.com/hanekomu/Carp-Source/. Instead of sending patches, please fork this project using the standard git and github infrastructure.

AUTHOR

  Marcel Gruenauer <marcel@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2007 by Marcel Gruenauer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.