NAME

       Aspect::Pointcut::Highest - Pointcut for preventing recursive matching

SYNOPSIS

         use Aspect;

         # High-level creation
         my $pointcut1 = highest;

         # Manual creation
         my $pointcut2 = Aspect::Pointcut::Highest->new;

DESCRIPTION

       For aspects including timers and other Aspect::Advice::Around-based advice, recursion can
       be significant problem.

       The "highest" pointcut solves this problem by matching only on the highest invocation of a
       function. If the function is called again recursively within the first call, at any depth,
       the deeper calls will be not match and the advice will not be executed.

AUTHORS

       Adam Kennedy <adamk@cpan.org>

       Marcel Gruenauer <marcel@cpan.org>

       Ran Eilam <eilara@cpan.org>

COPYRIGHT

       Copyright 2001 by Marcel Gruenauer

       Some parts copyright 2009 - 2013 Adam Kennedy.

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