This is 0.48

[perl/modules/Variable-Magic.git] / README

diff --git a/README b/README
index 9ab46cb6d154c85298d63fa7a50c9afb64cbef46..abba9256e8a80d07bec350dae8e9a48c64f67afc 100644 (file)
--- 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<wizard cast VMG_OP_INFO_NAME>;
@@ -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
     <http://www.profvince.com/perl/cover/Variable-Magic>.
 
 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.