Changes

   1 Revision history for Variable-Magic
   2
   3 0.38    2009-10-04 16:10 UTC
   4         + Dep : All the signature-related features are DEPRECATED and will be
   5                 removed in december 2009. This includes the 'sig' option to
   6                 wizard(), the getsig() and gensig() functions, and the SIG_*
   7                 constants.
   8                 Afaik those features were never used in real life, and they make
   9                 the XS code slow and brittle. If you want your wizards to be
  10                 globally available, you'll have to handle that yourself by
  11                 storing them in a hash.
  12         + Doc : More examples in a new COOKBOOK section.
  13         + Fix : Compatiblity with the 5.11.0 release. The new compatibility
  14                 constant VMG_COMPAT_ARRAY_PUSH_NOLEN_VOID was added to cover
  15                 this.
  16         + Fix : Work around Kwalitee test misfailures.
  17
  18 0.37    2009-08-25 15:25 UTC
  19         + Add : The new constant VMG_FORKSAFE can be tested to know whether the
  20                 module will behave nicely when fork()ing. It's currently always
  21                 true except on Windows where you need perl 5.10.1 for it to be
  22                 true.
  23         + Doc : Nits and clarifications.
  24
  25 0.36    2009-07-05 16:30 UTC
  26         + Chg : getdata() now returns an empty list when no magic is present.
  27                 It used to return undef but did not croak as stated in the doc.
  28                 Thanks Matt S. Trout for pointing this out.
  29         + Fix : Building and tests with ActiveState Perl 5.8 build >= 822.
  30
  31 0.35    2009-05-15 20:50 UTC
  32         This is a maintenance release. Users of 0.34 can skip this update.
  33         + Chg : uvar magic used to be enabled for 5.9.5. It now requires 5.10 or
  34                 later.
  35         + Fix : Silence compilation warnings for cxinc().
  36         + Rem : The workaround introduced in 0.31 for the "Unknown errors" issue
  37                 was removed, as regression tests show that 0.34 provides a
  38                 better fix.
  39         + Tst : Skip t/40-threads.t on 5.8.x with old versions of threads and
  40                 threads::shared.
  41
  42 0.34    2009-04-19 16:55 UTC
  43         + Fix : Destruction of wizards in require.
  44         + Fix : "panic: restartop" in 5.10 when dieing at compile time triggers
  45                 a destructor.
  46
  47 0.33    2009-03-26 00:00 UTC
  48         + Chg : cast() and getsig() now croak too when an invalid signature is
  49                 passed.
  50         + Fix : It was possible to generate with gensig() the same signature
  51                 twice before actually defining the wizards.
  52         + Tst : More stash tests.
  53         + Tst : Test when the magic takes place in some cases.
  54         + Tst : Improved coverage for the op object feature.
  55
  56 0.32    2009-03-01 13:45 UTC
  57         + Chg : dispell() and getdata() now croak when an invalid signature is
  58                 passed.
  59         + Doc : More examples and a brand new synopsis.
  60         + Fix : The signature is no longer stored in the mg_private member of
  61                 the MAGIC struct. This fixes possible clashes with magics from
  62                 other extensions.
  63         + Fix : op info objects weren't blessed into the right class.
  64         + Fix : Races when initializing the op names cache under threads.
  65
  66 0.31    2009-02-19 23:50 UTC
  67         + Doc : A somewhat better introduction. The FUNCTION section was moved
  68                 before CONSTANTS and HISTORY since it's more important. And
  69                 'assignation' is really 'assignment', says Ricardo. :)
  70         + Fix : The op_info features are now thread safe.
  71         + Fix : Segfaults that occured when trying to get the op name during
  72                 global destruction.
  73         + Fix : Segfaults and wrong "Unknown error" exceptions that happened
  74                 when dieing in require caused a free callback to fire.
  75                 Thanks Florian Ragwitz for reporting.
  76
  77 0.30    2009-02-12 17:05 UTC
  78         + Add : You can now get in all the callbacks either the name or a B::OP
  79                 object representing the current op if you pass the new 'op_info'
  80                 option to wizard() with respective values VMG_OP_INFO_NAME and
  81                 VMG_OP_INFO_OBJECT.
  82         + Doc : Document magic on array/hashes values.
  83         + Fix : Completely skip free callbacks during global destruction.
  84         + Tst : Tests now pass again on 5.8.3 and lower (they were broken since
  85                 0.27).
  86         + Tst : Test magic on symbol table and on array/hash values.
  87
  88 0.29    2009-02-08 11:10 UTC
  89         + Add : Set $_[2] to the default length for len magic on scalars.
  90         + Chg : Perl 5.8 is required.
  91         + Chg : The CLONE method will no longer be defined for non-threaded
  92                 perls.
  93         + Doc : Nits.
  94         + Fix : The logic for turning off the GMAGICAL flag on hashes when no
  95                 uvar magic is involved could do nasty things on tied hashes.
  96         + Upd : More resources in META.yml.
  97
  98 0.28    2009-01-24 17:05 UTC
  99         + Add : The 'copy_key' option to wizard(), that enables the safe edition
 100                 of $_[2] in uvar callbacks to redirect actions to another key.
 101         + Fix : Exception objects thrown from callbacks at compile time were not
 102                 available in $@.
 103         + Fix : free callbacks triggered during global destruction could lead to
 104                 segfaults because the wizard was already freed.
 105         + Fix : Refcount of scalars with free callback.
 106         + Fix : Segfaults when using get or uvar magic simultaneously with clear
 107                 magic.
 108         + Doc : The documentation about what the callbacks take and should
 109                 return is now somewhat clearer.
 110
 111 0.27    2009-01-18 23:40 UTC
 112         + Fix : Offset of 1 with len magic on scalars.
 113         + Fix : Segfaults that seem to happen when one croak in a callback at
 114                 compile time (thanks Ash Berlin for the testcase).
 115         + Upd : Resources in META.yml (Florian Ragwitz)
 116         + Tst : Large cleanup resulting in a wider set of tested behaviours.
 117
 118 0.26    2008-11-29 22:05 UTC
 119         + Fix : Leaks of cloned coderefs that access lexicals.
 120         + Fix : Building with maint-5.8 and blead (thanks Andreas Koenig).
 121
 122 0.25    2008-11-12 19:40 UTC
 123         + Fix : Compatibility with 5.8.9.
 124         + Fix : Old Pod::Coverage don't ignore CLONE.
 125         + Upd : META.yml spec updated to 1.4.
 126
 127 0.24    2008-10-12 14:55 UTC
 128         + Fix : Really fix it.
 129
 130 0.23    2008-10-11 17:25 UTC
 131         + Fix : Building on perls with multiplicity but not ithreads.
 132
 133 0.22    2008-09-29 19:40 UTC
 134         + Doc : Explain how magic differs from overloading.
 135         + Fix : Disable thread safety for perl 5.8 on Windows. If you want it
 136                 enabled, reliable feedback is welcome.
 137
 138 0.21_02 2008-09-28 23:10 UTC
 139         + Fix : Hide previously deleted magic tokens in vmg_svt_free (Yuval
 140                 Kogman).
 141
 142 0.21_01 2008-09-22 13:25 UTC
 143         + Chg : Shrink the context data.
 144         + Fix : Enable thread safety features for perls that just lack
 145                 MY_CXT_CLONE.
 146         + Tst : Output threads and threads::shared versions in threads tests.
 147
 148 0.20    2008-09-20 23:35 UTC
 149         + Fix : The module is now thread safe. You can test if it had been
 150                 built with thread safety features enabled through the
 151                 VMG_THREADSAFE constant.
 152         + Fix : Correct backtrace when wizard() croaks.
 153         + Fix : 'cast $a, undef' should throw an 'invalid wizard' error instead
 154                 of an 'invalid signature'.
 155
 156 0.19    2008-07-05 15:05 UTC
 157         + Add : The patchlevel with which the module has been built is now
 158                 exported with the VMG_PERL_PATCHLEVEL constant.
 159         + Chg : Version checking macros overhaul.
 160         + Fix : 'uvar' magic should only be enabled in maint-5.10 and higher
 161                 since it's never going to be backported to 5.8.
 162         + Fix : Likewise, the copy callback API change should only be enabled in
 163                 5.11 and higher.
 164         + Fix : Instead of those ackward fake refcount increments in the wizard
 165                 destructor, flag the wizard with SVf_BREAK and force temps
 166                 cleanup. This should fix the wizard destruction for all perls,
 167                 and solves the leak introduced by the previous solution.
 168
 169 0.18    2008-07-04 12:20 UTC
 170         + Fix : Enable uvar magic when patchlevel >= 28419.
 171         + Fix : Set VMG_COMPAT_ARRAY_PUSH_NOLEN for Windows ActiveState Perl
 172                 5.8.x.
 173
 174 0.17    2008-05-11 09:05 UTC
 175         + Fix : 5.8.4 and lower don't have mPUSHi. Gah. Yeah, I know, I should
 176                 use Devel::PPPort.
 177
 178 0.16    2008-05-10 22:05 UTC
 179         + Add : The samples/copy.pl script.
 180         + Chg : The sv_magical() + vmg_mg_magical() combo was simplified into
 181                 vmg_sv_magicuvar().
 182         + Tst : t/33-code.t was testing scalars, not code.
 183         + Tst : is() and like() are better than ok().
 184         + Tst : 100% coverage reached.
 185
 186 0.15    2008-04-11 18:25 UTC
 187         + Chg : Factor vmg_cb_call{1,2,3}() into one function.
 188         + Fix : len magic is no longer called when taking the length() of a
 189                 magical scalar since p32969. The VMG_COMPAT_SCALAR_LENGTH_NOLEN
 190                 constant was added to cover this.
 191         + Tst : More tests for t/22-len.t.
 192
 193 0.14    2008-03-24 12:35 UTC
 194         + Fix : t/16-huf.t failures on Solaris and FreeBSD caused by not
 195                 updating mg->mg_ptr after Renew-ing it on dispell.
 196         + Fix : Undefining MGf_DUP caused the wizard's magic to be wrongly
 197                 initialized. MGf_DUP now appears as true from the user point of
 198                 view, but the dup callback isn't actually set.
 199         + Fix : Warnings with blead due to copy callbacks now taking an I32 (API
 200                 change #33256).
 201         + Fix : vmg_svt_val() and vmg_uvar_del() aren't required if no uvar
 202                 magic is available.
 203         + Tst : Tests now output the version of optional modules loaded.
 204
 205 0.13    2008-03-19 14:35 UTC
 206         + Doc : Link to coverage report.
 207         + Fix : Correct dependencies listing in META.yml.
 208         + Tst : Improved test coverage.
 209         + Tst : Print the patchlevel as a comment.
 210         + Tst : Use is() where it's relevant.
 211         + Tst : t/16-huf.t now really tests interaction with H::U::FH.
 212
 213 0.12    2008-02-07 18:15 UTC
 214         + Fix : POD error. Thanks to Chris Williams (BinGOs) for the quick
 215                 feedback.
 216
 217 0.11    2008-02-07 17:55 UTC
 218         + Add : Copy callbacks now receive the current key/index in $_[2].
 219                 The current value/element is now in $_[3].
 220         + Chg : The trigger of copy magic on list assignment with perls greater
 221                 than 5.10.0 was caused by uvar magic. Hence,
 222                 VMG_COMPAT_HASH_LISTASSIGN_COPY was removed. Use VMG_UVAR
 223                 instead.
 224         + Fix : Build failures on patched perls.
 225         + Tst : Added missing exported symbols to 01-import.t.
 226
 227 0.10    2008-02-04 11:30 UTC
 228         + Add : New script : samples/vm_vs_tie.pl, that benchmarks our uvar
 229                 magic versus tied hashes.
 230         + Add : The VMG_COMPAT_* constants can be used from userspace to check
 231                 perl magic abilities.
 232         + Fix : Callbacks that returned undef made us croak, breaking the
 233                 variable behaviour (regression test in 14-callbacks.t).
 234         + Fix : uvar callbacks weren't tested for non-NULL-ity before being
 235                 called (regression test in 28-uvar.t).
 236         + Tst : Fix typo in 25-copy.t that prevented Tie::Hash tests to be ran.
 237
 238 0.09    2008-02-02 11:30 UTC
 239         + Doc : Explicitely say that uvar callbacks are safely ignored for
 240                 non-hashes.
 241         + Doc : Document caveats and fix the usual set of typos.
 242         + Fix : vmg_dispell() didn't check if the ext magic were ours when
 243                 counting wizards that have uvar callbacks, resulting in a
 244                 possible memory misread.
 245         + Fix : getdata() now returns directly the data object, and no longer a
 246                 copy. This caused a leak.
 247         + Tst : Prefix author tests by 9*-.
 248         + Tst : New optional author test : 95-portability-files.t, that uses
 249                 Test::Portability::Files when it's present.
 250         + Tst : New test : 14-self.t, that tests application of magic on the
 251                 wizard itself.
 252         + Tst : Move Hash::Util::FieldHash tests out of 11-multiple.t to
 253                 15-huf.t.
 254
 255 0.08    2008-02-01 16:55 UTC
 256         + Add : copy magic for tied arrays/hashes.
 257         + Add : local magic.
 258         + Add : uvar magics : fetch, store, exists, delete for hashes.
 259
 260 0.07_*  2008-01
 261         Internal development versions.
 262
 263 0.06    2007-11-20 10:10 UTC
 264         + Chg : 5.7.3 is now officially required.
 265         + Fix : "data" test failures on 5.8.{0,2}.
 266         + Fix : Drand01() vs rand().
 267
 268 0.05    2007-11-19 09:10 UTC
 269         + Fix : 5.10.0_RC1 compatibility fix.
 270
 271 0.04    2007-08-28 12:25 UTC
 272         + Chg : s/require (XSLoader)/use $1/.
 273         + Fix : Tests are now strict.
 274         + Fix : Complete dependencies.
 275
 276 0.03    2007-08-01 17:20 UTC
 277         + Add : Passing the signature of an already defined magic to wizard()
 278                 now returns the corresponding magic object.
 279         + Add : You can pass the numeric signature as the wizard argument of
 280                 cast(), dispell() and getdata().
 281         + Add : Any argument specified after the wizard (or the signature) in a
 282                 call to cast() is now passed to the private data constructor in
 283                 $_[1] and after.
 284         + Chg : $_[0] is now always a reference to the magic variable in all
 285                 callbacks. The reason for changing from the previous behaviour
 286                 is that one may want to apply the same magic to a plain scalar
 287                 and to a scalar reference, and needs a way to distinguish
 288                 between them in the callback (say, ref()).
 289         + Fix : Wizard object destruction used not to free the signature.
 290
 291 0.02    2007-07-27 13:50 UTC
 292         + Fix : In response to test report 548152 :
 293                 Newx() and SvMAGIC_set() not present on older perls.
 294         + Fix : In response to test report 548275 :
 295                 Since perl 5.9.5, 'clear' magic is invoked when an array is
 296                 undefined (bug #43357). Moreover, 'len' magic is no longer
 297                 called by pushing an element since perl 5.9.3.
 298         + Fix : Missing glob test in MANIFEST.
 299
 300 0.01    2007-07-25 16:15 UTC
 301         First version, released on an unsuspecting world.
 302