debian man page for aspect::pointcut::highest

Aspect::Pointcut::Highest(3pm)				User Contributed Perl Documentation			    Aspect::Pointcut::Highest(3pm)

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 - 2012 Adam Kennedy.

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

perl v5.14.2							    2012-02-01					    Aspect::Pointcut::Highest(3pm)