carp::datum::strip(3pm) [debian man page]

Datum::Strip(3pm)					User Contributed Perl Documentation					 Datum::Strip(3pm)

NAME

       Carp::Datum::Strip - strips most Carp::Datum calls lexically

SYNOPSIS

	use Carp::Datum::Strip qw(datum_strip);

	datum_strip("-", "-");
	datum_strip($file, "$file.new", ".bak");

DESCRIPTION

       This module exports a single routine, datum_strip(), whose purpose is to remove calls to "Carp::Datum" routines lexically.

       Because stripping is done lexically, there are some restrictions about what is actually supported.  Unless the conventions documented in
       Carp::Datum are followed, stripping will be incorrect.

       The general guidelines are:

       o   Do not use here documents or generalized quotes (qq) within assertion expression or tags.  Write assertions using '' or "", as
	   appropriate.

       o   Assertions can be safely put on several lines, but must end with a semi-colon, outside any string.

       There are two calls that will never be stripped: VERIFY() and DTRACE().	The VERIFY() is meant to be preserved (or "DREQUIRE" would have
       been used).  "DTRACE", when called, will be remapped dynamically to some "Log::Agent" routine, depending on the trace level.  See
       Carp::Datum for details.

INTERFACE

       The interface of the datum_strip() routine is:

       "datum_strip" old_file, new_file, [ext]
	   The old_file specifies the old file path, the one to be stripped.  The stripped version will be written to new_file.

	   If the optional third argument ext is given (e.g. ".bak"), then old_file will be renamed with the supplied extension, and new_file will
	   be renamed old_file.  Renaming only occurs if stripping was successful (i.e. the new file was correctly written to disk).

	   The lowest nine "rwx" mode bits from old_file are preserved when creating new_file.

	   Both old_file and new_file can be set to "-", in which case STDIN and STDOUT are used, respectively, and no renaming can occur, nor any
	   mode bit propagation.

	   Returns true on success, "undef" on error.

AUTHORS

       Christophe Dehaudt and Raphael Manfredi are the original authors.

       Send bug reports, hints, tips, suggestions to Dave Hoover at <squirrel@cpan.org>.

SEE ALSO

       Carp::Datum(3).

perl v5.10.0							    2006-04-13							 Datum::Strip(3pm)

App::Info::Handler::Carp(3pm)				User Contributed Perl Documentation			     App::Info::Handler::Carp(3pm)

NAME

       App::Info::Handler::Carp - Use Carp to handle App::Info events

SYNOPSIS

	 use App::Info::Category::FooApp;
	 use App::Info::Handler::Carp;

	 my $carp = App::Info::Handler::Carp->new('carp');
	 my $app = App::Info::Category::FooApp->new( on_info => $carp );

	 # Or...
	 my $app = App::Info::Category::FooApp->new( on_error => 'croak' );

DESCRIPTION

       App::Info::Handler::Carp objects handle App::Info events by passing their messages to Carp functions. This means that if you want errors to
       croak or info messages to carp, you can easily do that. You'll find, however, that App::Info::Handler::Carp is most effective for info and
       error events; unknown and prompt events are better handled by event handlers that know how to prompt users for data. See
       App::Info::Handler::Prompt for an example of that functionality.

       Upon loading, App::Info::Handler::Carp registers itself with App::Info::Handler, setting up a number of strings that can be passed to an
       App::Info concrete subclass constructor. These strings are shortcuts that tell App::Info how to create the proper App::Info::Handler::Carp
       object for handling events. The registered strings are:

       carp
	   Passes the event message to "Carp::carp()".

       warn
	   An alias for "carp".

       croak
	   Passes the event message to "Carp::croak()".

       die An alias for "croak".

       cluck
	   Passes the event message to "Carp::cluck()".

       confess
	   Passes the event message to "Carp::confess()".

INTERFACE

   Constructor
       new

	 my $carp_handler = App::Info::Handler::Carp->new;
	 $carp_handler = App::Info::Handler::Carp->new( level => 'carp' );
	 my $croak_handler = App::Info::Handler::Carp->new( level => 'croak' );

       Constructs a new App::Info::Handler::Carp object and returns it. It can take a single parameterized argument, "level", which can be any one
       of the following values:

       carp
	   Constructs a App::Info::Handler::Carp object that passes the event message to "Carp::carp()".

       warn
	   An alias for "carp".

       croak
	   Constructs a App::Info::Handler::Carp object that passes the event message to "Carp::croak()".

       die An alias for "croak".

       cluck
	   Constructs a App::Info::Handler::Carp object that passes the event message to "Carp::cluck()".

       confess
	   Constructs a App::Info::Handler::Carp object that passes the event message to "Carp::confess()".

       If the "level" parameter is not passed, "new()" will default to creating an App::Info::Handler::Carp object that passes App::Info event
       messages to "Carp::carp()".

BUGS

       Please send bug reports to <bug-app-info@rt.cpan.org> or file them at <http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-Info>.

AUTHOR

       David Wheeler <david@justatheory.com>

SEE ALSO

       App::Info documents the event handling interface.

       Carp of documents the functions used by this class.

       App::Info::Handler::Print handles events by printing their messages to a file handle.

       App::Info::Handler::Prompt offers event handling more appropriate for unknown and confirm events.

       App::Info::Handler describes how to implement custom App::Info event handlers.

COPYRIGHT AND LICENSE

       Copyright (c) 2002-2008, David Wheeler. Some Rights Reserved.

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

perl v5.10.1							    2011-03-15					     App::Info::Handler::Carp(3pm)