X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=494ef72d2cdcbff8a48185672fe5b70107b38dcc;hb=8dcb0d71518205c9b31607040494731eed689de6;hp=9ab46cb6d154c85298d63fa7a50c9afb64cbef46;hpb=67183cedd68decfdd05ef3d64b27bb7e07476626;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/README b/README index 9ab46cb..494ef72 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.49 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.