NAME

CGI::Carp::Fatals - fatalsToBrowser on steroids

SYNOPSIS

        use CGI::Carp::Fatals;

        use CGI::Carp::Fatals qw(fatalsRemix);
        fatalsRemix();

        use CGI::Carp::Fatals qw(fatalsRemix);
        fatalsRemix('INFO_GENERAL');

        use CGI::Carp::Fatals qw(set_message);
        set_message("It's not a bug, it's a feature!");
        

DESCRIPTION

This module extends CGI::Carp by adding perlinfo information (from HTML::Perlinfo) to fatal errors handled by CGI::Carp's fatalsToBrowser.

USAGE/FUNCTIONS

Using CGI::Carp::Fatals enables fatalsToBrowser from CGI::Carp. This is a feature.

If you wish to enhance ("juice") those error messages, you can import a function called 'fatalsRemix'. It will append perlinfo data to the error reports. This function accepts the same options as the perlinfo function from HTML::Perlinfo.

By default, fatalsRemix uses the INFO_VARIABLES option which shows you all predefined variables from EGPCS (Environment, GET, POST, Cookie, Server). Please see the HTML::Perlinfo docs for further options and details.

        use CGI::Carp::Fatals qw(fatalsRemix);
        fatalsRemix(); # defaults to INFO_VARIABLES
        fatalsRemix('INFO_GENERAL'); # now includes INFO_GENERAL. There are many other options.
        

Changing the message further

If changing the option to fatalsRemix doesn't satisfy you, you can use the set_message routine that CGI::Carp::Fatals exports from CGI::Carp. Please refer to the documentation of CGI::Carp.

What else is included?

Whatever else that CGI::Carp exports (confess, croak, and carp).

BUGS

Please report any bugs or feature requests to bug-cgi-carp-fatals@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CGI-Carp-Fatals. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

REQUIREMENTS

HTML::Perlinfo

SEE ALSO

CGI::Carp, HTML::Perlinfo, CGI::Carp::DebugScreen, CGI::HTMLError, CGI::Carp::Throw.

AUTHOR

Mike Accardo <mikeaccardo@yahoo.com>

COPYRIGHT

   Copyright (c) 2009, Mike Accardo. All Rights Reserved.
 This module is free software. It may be used, redistributed
and/or modified under the terms of the Perl Artistic License.