Changes

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