NAME

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

SYNOPSIS

  use Carp::Source::Always;

makes every warn() and die() complains loudly, with source code context like Carp::Source, in the calling package and elsewhere. More often used on the command line:

  perl -MCarp::Source::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 and source code context when warn()ing or die()ing.

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 fusses around with warn, die, $SIG{'__WARN__'}, $SIG{'__DIE__'}.

TAGS

If you talk about this module in blogs, on del.icio.us or anywhere else, please use the carpsource tag.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to bug-carp-source@rt.cpan.org, or through the web interface at http://rt.cpan.org.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

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://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.

AUTHOR

Marcel Grünauer, <marcel@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2007 by Marcel Grünauer

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