view release on metacpan or  search on metacpan

README  view on Meta::CPAN

Acme/landmine version 1.00
==========================

It looks like a scalar/array/hash but if you try to evaluate
it an exception is thrown, with "confess" stacktrace.  For
help debugging data structure problems.  References to it
are safe though.

INSTALLATION

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install

landmine.pm  view on Meta::CPAN

=head1 SYNOPSIS

  use Acme::landmine; # crucial, this line
  tie $scalar, "Acme::landmine" => "first use of \$scalar";
  tie @array, "Acme::landmine" => "first use of \@array";
  tie %hash, "Acme::landmine" => "first use of \%hash";

=head1 ABSTRACT

  variables that "explode", which useful for locating the first
  use of a variable after a checkpoint, while debugging.

=head1 DESCRIPTION

 a tie interface that C<confess>es.  This is useful
 for creating out-of-bounds markers when modeling data structures,
 or setting a checkpoint when you want to know the next time
 a variable is accessed after some point.

 DESTROY is not mined, but everything else is.