X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;fp=README;h=abba9256e8a80d07bec350dae8e9a48c64f67afc;hb=b2fbd6650bf935caee0c11a5c93f15070cdfd1d9;hp=9ab46cb6d154c85298d63fa7a50c9afb64cbef46;hpb=a15fd15a4532b5623e02c3e99cd2f3952c662ed0;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/README b/README index 9ab46cb..abba925 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME Variable::Magic - Associate user-defined magic to variables from Perl. VERSION - Version 0.47 + Version 0.48 SYNOPSIS use Variable::Magic qw; @@ -234,8 +234,19 @@ FUNCTIONS straight to the perl magic API. However, only the return value of the "len" callback currently holds a meaning. - 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 : + + * a code reference, which will be called as a subroutine. + + * 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. + + * a reference to "undef", 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. Note that "free" callbacks are *never* called during global destruction, as there's no way to ensure that the wizard and the "free" callback @@ -550,7 +561,8 @@ SUPPORT . COPYRIGHT & LICENSE - Copyright 2007,2008,2009,2010,2011 Vincent Pit, all rights reserved. + Copyright 2007,2008,2009,2010,2011,2012 Vincent Pit, all rights + reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.