X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=a7c09596b439f0f84ca65e2e4514f7c2b4a7a846;hb=d28712f92da321bedadbf8b4eb9c27fcd4205ab8;hp=cc595c27747557e242836547d9149cf9dcd8842b;hpb=1676b9c5dcfd3a398710ce5476bcff3bf5d83a8f;p=perl%2Fmodules%2FVariable-Magic.git diff --git a/README b/README index cc595c2..a7c0959 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ NAME Variable::Magic - Associate user-defined magic to variables from Perl. VERSION - Version 0.50 + Version 0.51 SYNOPSIS use Variable::Magic qw; @@ -63,13 +63,18 @@ DESCRIPTION the correct "Tie::Std*" class and overriding individual methods in your own class. + * Magic is multivalued. + + You can safely apply different kinds of magics to the same variable, + and each of them will be invoked successively. + * Magic is type-agnostic. The same magic can be applied on scalars, arrays, hashes, subs or globs. But the same hook (see below for a list) may trigger differently depending on the the type of the variable. - * Magic is invisible at the Perl level. + * Magic is invisible at Perl level. Magical and non-magical variables cannot be distinguished with "ref", "tied" or another trick. @@ -111,9 +116,11 @@ DESCRIPTION * *free* - This magic is called when an object is destroyed as the result of - the variable going out of scope (but not when the variable is - undefined). + This magic is called when a variable is destroyed as the result of + going out of scope (but not when it is undefined). It behaves + roughly like Perl object destructors (i.e. "DESTROY" methods), + except that exceptions thrown from inside a *free* callback will + always be propagated to the surrounding code. * *copy*