This is 0.22

diff --git a/Changes b/Changes
index 47bcb4850e1b5b14c9f4def44e7bea8833739421..ab4d0e42030cdb89b2e8cd97fb90b9fbf6f3df04 100644 (file)
--- a/Changes
+++ b/Changes
@@ -1,5 +1,10 @@
 Revision history for Variable-Magic
 
+0.22    2008-09-29 19:40 UTC
+        + Doc : Explain how magic differs from overloading.
+        + Fix : Disable thread safety for perl 5.8 on Windows. If you want it
+                enabled, reliable feedback is welcome.
+
 0.21_02 2008-09-28 23:10 UTC
         + Fix : Hide previously deleted magic tokens in vmg_svt_free (Yuval
                 Kogman).

diff --git a/META.yml b/META.yml
index 951d1fb8beba87dccf8e7fc2cda0433a77892510..7909735587550f2b9d8a21b3c0e9b0b57872d896 100644 (file)
--- a/META.yml
+++ b/META.yml
@@ -1,6 +1,6 @@
 --- #YAML:1.0
 name:                Variable-Magic
-version:             0.21_02
+version:             0.22
 abstract:            Associate user-defined magic to variables from Perl.
 license:             perl
 author:              

diff --git a/README b/README
index 2130990038f8ee0840f868b2b94ff1db6f31d468..61b60ab6ab683ee56d0b4a5499a4f00a6b9d5e75 100644 (file)
--- a/README
+++ b/README
@@ -2,7 +2,7 @@ NAME
     Variable::Magic - Associate user-defined magic to variables from Perl.
 
 VERSION
-    Version 0.21_02
+    Version 0.22
 
 SYNOPSIS
         use Variable::Magic qw/wizard cast dispell/;
@@ -16,11 +16,27 @@ SYNOPSIS
 
 DESCRIPTION
     Magic is Perl way of enhancing objects. This mechanism let the user add
-    extra data to any variable and overload syntaxical operations (such as
+    extra data to any variable and hook syntaxical operations (such as
     access, assignation or destruction) that can be applied to it. With this
     module, you can add your own magic to any variable without the pain of
     the C API.
 
+    Magic differs from tieing and overloading in several ways :
+
+    *   Magic isn't copied on assignation (as for blessed references) : you
+        attach it to variables, not values.
+
+    *   It doesn't replace the original semantics : magic callbacks trigger
+        before the original action take place, and can't prevent it to
+        happen.
+
+    *   It's mostly invisible at the Perl level : magical and non-magical
+        variables cannot be distinguished with "ref", "reftype" or another
+        trick.
+
+    *   It's notably faster, since perl's way of handling magic is lighter
+        by nature, and there's no need for any method resolution.
+
     The operations that can be overloaded are :
 
     *   "get"

diff --git a/lib/Variable/Magic.pm b/lib/Variable/Magic.pm
index f7e5792b220981db1a39be92f602ccb36265a334..02309b96f1af045a2de966f4f9287724eb0ada56 100644 (file)
--- a/lib/Variable/Magic.pm
+++ b/lib/Variable/Magic.pm
@@ -13,13 +13,13 @@ Variable::Magic - Associate user-defined magic to variables from Perl.
 
 =head1 VERSION
 
-Version 0.21_02
+Version 0.22
 
 =cut
 
 our $VERSION;
 BEGIN {
- $VERSION = '0.21_02';
+ $VERSION = '0.22';
 }
 
 =head1 SYNOPSIS