X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=README;h=a7c09596b439f0f84ca65e2e4514f7c2b4a7a846;hb=22768b2c966463cd2574d2f7f7ea5c1cf494456b;hp=cc595c27747557e242836547d9149cf9dcd8842b;hpb=4817a150722f1900424bd23dc474f399ed647c3c;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*