X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=d5004fc0fd7ac68598b453f4a6961dca6b4b84dd;hb=da9c1cac7534f75645bb34430d38ec2d912eb9f4;hp=c0cc8a38c8157b51d089a6ad6197c50d89943a68;hpb=2cf241bbc4c9741f610d75dd794c71d1429b6ef3;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/README b/README index c0cc8a3..d5004fc 100644 --- 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 . 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.