From: Vincent Pit <vince@profvince.com>
Date: Mon, 29 Sep 2008 19:38:57 +0000 (+0200)
Subject: This is 0.22
X-Git-Tag: v0.22^0
X-Git-Url: http://git.vpit.fr/?a=commitdiff_plain;ds=sidebyside;h=22d6784192ac01ed37585b6eafb78b4c910a75df;p=perl%2Fmodules%2FVariable-Magic.git

This is 0.22
---

diff --git a/Changes b/Changes
index 47bcb48..ab4d0e4 100644
--- 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 951d1fb..7909735 100644
--- 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 2130990..61b60ab 100644
--- 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 f7e5792..02309b9 100644
--- 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