This is 0.27

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

diff --git a/README b/README
index c0cc8a38c8157b51d089a6ad6197c50d89943a68..d5004fc0fd7ac68598b453f4a6961dca6b4b84dd 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     Variable::Magic - Associate user-defined magic to variables from Perl.
 
 VERSION
-    Version 0.26
+    Version 0.27
 
 SYNOPSIS
         use Variable::Magic qw/wizard cast dispell/;
@@ -253,6 +253,10 @@ FUNCTIONS
         (for example) cast magic on it. "copy" magic also receives the
         current element (i.e. the value) in $_[3].
 
+        All the callbacks are expected to return an integer, which is passed
+        straight to the perl magic API. However, only the return value of
+        the "len" callback currently holds a meaning.
+
         # A simple scalar tracer
         my $wiz = wizard get  => sub { print STDERR "got ${$_[0]}\n" },
                          set  => sub { print STDERR "set to ${$_[0]}\n" },
@@ -331,6 +335,8 @@ CAVEATS
     this destructor won't be called because the wizard will be destroyed
     first.
 
+    Using "get" and "clear" magics on hashes may cause segfaults.
+
 DEPENDENCIES
     perl 5.7.3.
 
@@ -372,7 +378,7 @@ SUPPORT
     <http://www.profvince.com/perl/cover/Variable-Magic>.
 
 COPYRIGHT & LICENSE
-    Copyright 2007-2008 Vincent Pit, all rights reserved.
+    Copyright 2007-2009 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.