Changes

   1 Revision history for Scope-Upper
   2
   3 0.27    2015-03-27 22:10 UTC
   4         + Chg : The new environment variable to enable thread tests on older
   5                 perls is PERL_FORCE_TEST_THREADS. Note that this variable
   6                 should only be turned on by authors.
   7         + Fix : Segfaults when the module is loaded by several threads (or
   8                 Windows emulated processes) ran in parallel.
   9         + Fix : Memory leak with the uid() feature.
  10         + Fix : Update the Windows ActivePerl + gcc 3.4 workaround for
  11                 ExtUtils::MakeMaker 7.04. Thanks Christian Walde for reporting
  12                 and feedback on this issue.
  13         + Fix : reap(), localize(), localize_elem() and localize_delete()
  14                 will again work correctly on perl 5.19.4+ when the debugger
  15                 is enabled.
  16         + Fix : Silence some compiler warnings.
  17
  18 0.26    2015-03-12 23:30 UTC
  19         + Fix : [RT #100264] : Don't use CvPADLIST on XSUBs
  20                 Thanks Father Chrysostomos for reporting and contributing a
  21                 patch.
  22         + Fix : Be really compatible with the optional OP_PARENT feature.
  23
  24 0.25    2014-09-21 17:10 UTC
  25         + Add : Support for the PERL_OP_PARENT optional feature introduced in
  26                 perl 5.21.2.
  27         + Fix : Work around an assertion failure in perl 5.21.4.
  28
  29 0.24    2013-09-10 11:10 UTC
  30         + Fix : Lexicals returned with unwind(), yield() and leave() will no
  31                 longer be lost on perl 5.19.4 and above.
  32
  33 0.23    2013-09-02 11:30 UTC
  34         This is a maintenance release. The code contains no functional change.
  35         Satisfied users of version 0.22 can skip this update.
  36         + Fix : [RT #87178] : typo fixes.
  37                 Thanks dsteinbrunner@pobox.com for the patch.
  38         + Fix : [RT #88177] : 5.19.3 block hint test breakage
  39                 t/07-context_info.t has been taught about perl 5.19.3.
  40                 Thanks Andrew Main for the patch.
  41         + Tst : Author tests are no longer bundled with this distribution.
  42                 They are only made available to authors in the git repository.
  43         + Tst : "given is experimental" warnings when running tests on perl
  44                 5.18 and above have been silenced.
  45
  46 0.22    2013-01-30 23:35 UTC
  47         + Chg : perl 5.6.1 is required.
  48         + Fix : context_info() now ignores %warnings::Bits for perl 5.8.6 and
  49                 below, just like caller().
  50         + Fix : [RT #82220] : Scope-Upper-0.21 test stuck on Windows perl 5.12.3
  51                 t/93-pod-spelling.t will not crash anymore on perl 5.12 and
  52                 below.
  53                 Thanks Gabor Szabo for reporting and Slaven Rezic for debugging
  54                 this issue.
  55         + Tst : Rare test failures of t/07-context_info.t on perl 5.6,
  56                 t/55-yield-target.t on perl 5.[68], and t/63-uplevel-ctl.t on
  57                 perl 5.8.[345] have been addressed.
  58
  59 0.21    2012-09-21 15:10 UTC
  60         + Fix : context_info() has been taught about perl 5.17.4.
  61         + Fix : t/07-context_info.t will no longer fail with perls that have
  62                 sitecustomize enabled (like many perl builds for Windows).
  63                 Thanks Steve Hay and Nicholas Clark for debugging help.
  64         + Fix : Broken linkage on Windows with gcc 3.4, which appears in
  65                 particular when using ActivePerl's default compiler suite.
  66                 For those setups, the Scope::Upper shared library will now be
  67                 linked against the perl dll directly (instead of the import
  68                 library).
  69
  70 0.20    2012-09-17 11:00 UTC
  71         + Add : The new yield(@values, $context) function can be used to return
  72                 values to any upper scope, including do or map blocks.
  73                 The new leave(@values) function is an alias for
  74                 yield(@values, HERE).
  75         + Add : The new context_info($context) function return information
  76                 about context $context, similarly to what caller() provides
  77                 but for any upper scope.
  78         + Chg : Contexts are now normalized. In previous versions, it was
  79                 possible for different contexts to refer to the same scope :
  80                 for example, "for (my $i = 0; $i < 10; ++$i) { ... }" was
  81                 reachable through two contexts, while "for (@array) { ... }"
  82                 only by one. Starting from this version, contexts are
  83                 normalized so that they always represent an actual scope.
  84         + Doc : C++ compilers are officially NOT supported.
  85         + Fix : Building with a more recent version of perl 5.17.4.
  86         + Fix : Debugger compatibility with perl 5.17.1 and above.
  87
  88 0.19    2012-09-01 13:25 UTC
  89         + Doc : POD headings have been made linkable.
  90         + Fix : Building with perl 5.17.4.
  91         + Fix : BUILD_PREREQS are now set for ExtUtils::MakeMaker.
  92         + Opt : uplevel() private data structure is 7% smaller on 64 bits
  93                 architectures.
  94         + Tst : Author tests overhaul.
  95
  96 0.18    2011-10-10 20:50 UTC
  97         + Add : The uid() function returns an unique identifier for each dynamic
  98                 scope. The validate_uid() function can be used to check whether
  99                 one such identifier is valid (i.e. that the scope it refers to
 100                 is still alive).
 101         + Chg : It is no longer possible on perl 5.6 to call goto() in an
 102                 uplevel callback to replace the uplevel call. This change was
 103                 needed in order to ensure consistency between platforms
 104                 regarding to the following fix just below.
 105         + Fix : The uplevel() tests now pass on Windows.
 106                 Thanks C.H. Kang for bringing this to my attention.
 107
 108 0.17    2011-10-03 21:45 UTC
 109         + Fix : uplevel() will now use the correct pad when executing its
 110                 callback. This fixes at least two issues :
 111                 - closures defined inside the uplevel callback can now correctly
 112                 access lexicals from inside and outside the callback.
 113                 - state variables in the uplevel callback now work properly.
 114         + Fix : It is now generally possible to call goto() in the uplevel'd
 115                 code to replace the uplevel stack frame. There are two cases
 116                 for which it is still not possible :
 117                 - if -D flags were set when running perl (as in "perl -Dt ...").
 118                 - if the perl runloop has been replaced with a custom one by
 119                 another module.
 120                 If uplevel() detects that the replacement code contains a goto
 121                 statement, and is in one of those two cases, then it will refuse
 122                 to execute the callback and throw an exception.
 123                 Note that this fix implies a run-time overhead of uplevel()
 124                 proportional to the size of the the callback in every case
 125                 (with a small ratio), and proportional to the size of ALL the
 126                 code executed as the result of the uplevel call (including
 127                 subroutine calls inside the callback) when a goto statement is
 128                 found in the uplevel callback.
 129         + Fix : uplevel() has been taught how to handle XS callbacks properly.
 130         + Fix : The cause of "Attempt to free unreferenced scalar" warnings
 131                 when using uplevel() has been addressed.
 132         + Fix : [RT #71212] : build failure on Windows.
 133                 The module does no longer rely on calling Perl_cv_clone, which
 134                 isn't exported.
 135                 Thanks C.H. Kang for reporting.
 136
 137 0.16    2011-09-03 23:00 UTC
 138         + Add : uplevel($code, @args, $cxt) executes $code with arguments @args
 139                 in the upper context pointed by $cxt.
 140                 This is an XS version of the well-known uplevel() routine from
 141                 Sub::Uplevel. There are a few differences between both
 142                 implmentations that are listed in the documentation.
 143                 The XS version is roughly 10 times faster than the pure-Perl
 144                 version.
 145
 146 0.15    2011-08-24 14:20 UTC
 147         + Fix : Localizing subroutines in an higher scope will now correctly
 148                 update the method cache.
 149
 150 0.14    2011-02-27 00:00 UTC
 151         + Fix : [RT #64997] : Compatibility with perl 5.13.10.
 152                 Thanks Dave Mitchell for the notice.
 153         + Tst : Lengthy tests have been ported to Test::Leaner, making the
 154                 whole test suite about 50% faster.
 155
 156 0.13    2010-12-20 01:00 UTC
 157         + Fix : [RT #61904] : Stack corruption when using unwind() under
 158                 Devel::NYTProf.
 159                 Thanks Sergey Aleynikov for contributing a fix.
 160         + Fix : [RT #63378] : Compatibility with perl 5.13.8.
 161                 Thanks Andreas J. König for bisecting the issue.
 162         + Tst : Threads tests are now only run on perl 5.13.4 and higher.
 163                 They could segfault randomly because of what seems to be an
 164                 internal bug of Perl, which has been addressed in 5.13.4.
 165                 There is also an environment variable that allows you to
 166                 forcefully run those tests, but it should be set only for
 167                 author testing and not for end users.
 168
 169 0.12    2010-05-19 00:45 UTC
 170         + Fix : Compatibility with perl 5.13.
 171         + Fix : Test failures with perl 5.8.0.
 172         + Fix : A minor leak of SVs when a non array/hash was passed to
 173                 localize_elem().
 174
 175 0.11    2010-04-16 23:20 UTC
 176         + Chg : It's now forbiddent to pass a reference to a non-glob variable
 177                 as the localization target of localize(), localize_elem() and
 178                 localize_delete().
 179         + Chg : localize_elem() now only accepts localization of arrays or hashs
 180                 elements. For other types, it used to be a synonym of localize.
 181         + Chg : localize_elem() no longer accepts a glob as the target. You now
 182                 have to specify the variable as a string. This is because it was
 183                 impossible in this case to handle meaningfully the array or the
 184                 hash reference passed as the assigned value.
 185         + Doc : The synopsys was revamped, and the rest of the documentation was
 186                 reviewed.
 187         + Fix : [RT #55593] : Segfault when localizing hash or array element to
 188                 different package in different file.
 189                 Thanks Dagfinn Ilmari Mannsåker for reporting.
 190         + Fix : [RT #56301] : reap loses eval context when dying naturally.
 191                 Thanks Andrew Main for reporting.
 192         + Fix : Scope inconsistencies and segfaults when saving several
 193                 localizations into the same target scope.
 194         + Fix : Stop skipping frames as a pop optimization. This caused breakage
 195                 under the debugger (and most likely outside as well).
 196
 197 0.10    2010-01-18 23:50 UTC
 198         + Fix : Properly handle given/when on 5.10.
 199         + Fix : Some stack inconsistencies were fixed, though they were unlikely
 200                 to have an impact on your real-life code.
 201         + Fix : Work around Kwalitee test misfailures.
 202
 203 0.09    2009-05-17 20:20 UTC
 204         + Add : The new SU_THREADSAFE constant can be used to know whether the
 205                 module could have been built with thread safety enabled.
 206         + Chg : Thread safety is disabled for perl 5.8 on Win32.
 207         + Chg : A saner workaround for the "call_sv() during LEAVE clobbers the
 208                 still used last popped stack element" issue on 5.10.
 209
 210 0.08    2009-04-16 22:50 UTC
 211         + Fix : [RT #44204] : Stack corruption with reap(). Thanks Torsten
 212                 Foertsch for reporting.
 213         + Fix : Building with Solaris CC.
 214         + Tst : unwind() in threads.
 215
 216 0.07    2009-02-20 00:20 UTC
 217         + Chg : The CLONE method will no longer be defined for non-threaded
 218                 perls.
 219         + Doc : Some examples on how to build the target context from the words.
 220         + Fix : Some unlikely possible uninitialized reads, indirectly pointed
 221                 out in a Redhat review request.
 222         + Fix : "localize *x, 'y' => $cxt" now matches Perl's behaviour for
 223                 "local *x = 'y'".
 224         + Fix : Miscellanous code cleanups, courtesy of Florian Ragwitz.
 225         + Upd : Resources in META.yml.
 226
 227 0.06    2009-01-17 00:05 UTC
 228         + Chg : INCOMPATIBLE CHANGE: The level is now absolute and no longer
 229                 relative to the current frame - we'll call it "context" from now
 230                 on. You should replace all your raw levels by combinations of
 231                 words.
 232                 The old behaviour of "=> $n" can be easily reobtained by using
 233                 "=> SCOPE($n)".
 234         + Fix : As a result of this change, the module now plays nicely with
 235                 the debugger.
 236
 237 0.05    2009-01-12 18:15 UTC
 238         + Fix : Stack mess when using unwind() in scalar context.
 239         + Fix : Returning an automatic variable isn't wise, so let's use a
 240                 context instead.
 241         + Doc : Clarifications.
 242         + Tst : Stress tests for unwind().
 243
 244 0.04    2009-01-11 18:40 UTC
 245         + Add : unwind(@things, $level), that returns to an upper context.
 246         + Add : want_at($level), that gives the wantarray for $level.
 247         + Add : Control words, to reliably get the level of the n-th upper
 248                 subroutine or eval scope. TOPLEVEL was renamed to TOP.
 249         + Fix : Tests with 5.6.
 250         + Tst : Reordering and factoring some of the stress tests so that they
 251                 aren't needlessly ran several times.
 252
 253 0.03    2009-01-04 15:55 UTC
 254         + Add : localize_delete(), that localize array/hash elements in upper
 255                 scopes.
 256         + Fix : Segfault when localizing array elements with an invalid negative
 257                 index.
 258
 259 0.02    2008-12-28 18:40 UTC
 260         + Doc : Clarifications and improvements.
 261         + Fix : Missing compatibility macros.
 262         + Fix : Localized nonexistant array elements should be deleted when
 263                 their time comes so that the array recovers its original length.
 264
 265 0.01    2008-12-26 16:05 UTC
 266         First version, released on an unsuspecting world.
 267