Phoenix.pm: ANNOUNCE: CGI::AppError

[Douglas E. Miles]

Here is the module I mentioned last night.  I'm looking for feedback on
documentation, name, implementation, and usefulness.  Depending on
feedback, I might consider posting to CPAN.  Thanks!  Here's the docs:

NAME
    CGI::AppError - HTML template-based error pages for CGI

SYNOPSIS
      use CGI::AppError;

      CGI::AppError::set_template();
      CGI::AppError::set_template('/path/to/my/template.html');

DESCRIPTION
    CGI::AppError allows you to display CGI application errors on
    custom HTML pages. CGI::AppError sets a $SIG{__DIE__} handler to
    diplay all fatal errors to the browser.

  CREATING THE TEMPLATE

    The only required element in the template is this comment:

    `<!-- Error Message -->'

    wherever the error message should appear. This comment can
    appear more than once if desired.

  SETTING THE TEMPLATE

    Use CGI::AppError::set_template() to indicate the path and
    filename of the template to use. If no template is specified, a
    bare-bones default page is used.

  DISPLAYING ERRORS

    To display an error to the browser, all that is necessary is to
    call die:

    `die "Required field missing"';

    and the error will be inserted into the template, and sent to
    standard out, to be displayed by the browser.

AUTHOR
    Douglas E. Miles (dmiles at primenet.com)

SEE ALSO
    perl(1).

COPYRIGHT
    Copyright (c) 2000, Douglas E. Miles. All Rights Reserved. This
    module is free software. It may be used, redistributed and/or
    modified under the terms of the Perl Artistic License (see
    http://www.perl.com/perl/misc/Artistic.html)

-- 
- Doug

Socrates is a man. All men are mortal. Therefore, all mortals are
Socrates.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: CGI-AppError-0.01.tar.gz
Type: application/x-gzip
Size: 2339 bytes
Desc: not available
Url : http://mail.pm.org/archives/phoenix-pm/attachments/20000405/c5632675/CGI-AppError-0.01.tar.bin