X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FVariable%2FMagic.pm;h=b22fee60980dff2995088aac77b605427f1009d4;hb=02f11dff4858109f73a7c12ca146b9e33c9e229b;hp=05821e9799f35310aa118df000ef4a315ebf066b;hpb=67183cedd68decfdd05ef3d64b27bb7e07476626;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/lib/Variable/Magic.pm b/lib/Variable/Magic.pm index 05821e9..b22fee6 100644 --- a/lib/Variable/Magic.pm +++ b/lib/Variable/Magic.pm @@ -11,13 +11,13 @@ Variable::Magic - Associate user-defined magic to variables from Perl. =head1 VERSION -Version 0.47 +Version 0.49 =cut our $VERSION; BEGIN { - $VERSION = '0.47'; + $VERSION = '0.49'; } =head1 SYNOPSIS @@ -285,7 +285,25 @@ However, only the return value of the C callback currently holds a meaning. =back -Each callback can be specified as a code or a string reference, in which case the function denoted by the string will be used as the callback. +Each callback can be specified as : + +=over 4 + +=item * + +a code reference, which will be called as a subroutine. + +=item * + +a string reference, where the string denotes which subroutine is to be called when magic is triggered. +If the subroutine name is not fully qualified, then the current package at the time the magic is invoked will be used instead. + +=item * + +a reference to C, in which case a no-op magic callback is installed instead of the default one. +This may especially be helpful for 'local' magic, where an empty callback prevents magic from being copied during localization. + +=back Note that C callbacks are I called during global destruction, as there's no way to ensure that the wizard and the C callback weren't destroyed before the variable. @@ -657,7 +675,7 @@ Tests code coverage report is available at L