1 Revision history for Scope-Upper
3 0.19 2012-09-01 13:25 UTC
4 + Doc : POD headings have been made linkable.
5 + Fix : Building with perl 5.17.4.
6 + Fix : BUILD_PREREQS are now set for ExtUtils::MakeMaker.
7 + Opt : uplevel() private data structure is 7% smaller on 64 bits
9 + Tst : Author tests overhaul.
11 0.18 2011-10-10 20:50 UTC
12 + Add : The uid() function returns an unique identifier for each dynamic
13 scope. The validate_uid() function can be used to check whether
14 one such identifier is valid (i.e. that the scope it refers to
16 + Chg : It is no longer possible on perl 5.6 to call goto() in an
17 uplevel callback to replace the uplevel call. This change was
18 needed in order to ensure consistency between platforms
19 regarding to the following fix just below.
20 + Fix : The uplevel() tests now pass on Windows.
21 Thanks C.H. Kang for bringing this to my attention.
23 0.17 2011-10-03 21:45 UTC
24 + Fix : uplevel() will now use the correct pad when executing its
25 callback. This fixes at least two issues :
26 - closures defined inside the uplevel callback can now correctly
27 access lexicals from inside and outside the callback.
28 - state variables in the uplevel callback now work properly.
29 + Fix : It is now generally possible to call goto() in the uplevel'd
30 code to replace the uplevel stack frame. There are two cases
31 for which it is still not possible :
32 - if -D flags were set when running perl (as in "perl -Dt ...").
33 - if the perl runloop has been replaced with a custom one by
35 If uplevel() detects that the replacement code contains a goto
36 statement, and is in one of those two cases, then it will refuse
37 to execute the callback and throw an exception.
38 Note that this fix implies a run-time overhead of uplevel()
39 proportional to the size of the the callback in every case
40 (with a small ratio), and proportional to the size of ALL the
41 code executed as the result of the uplevel call (including
42 subroutine calls inside the callback) when a goto statement is
43 found in the uplevel callback.
44 + Fix : uplevel() has been taught how to handle XS callbacks properly.
45 + Fix : The cause of "Attempt to free unreferenced scalar" warnings
46 when using uplevel() has been addressed.
47 + Fix : [RT #71212] : build failure on Windows.
48 The module does no longer rely on calling Perl_cv_clone, which
50 Thanks C.H. Kang for reporting.
52 0.16 2011-09-03 23:00 UTC
53 + Add : uplevel($code, @args, $cxt) executes $code with arguments @args
54 in the upper context pointed by $cxt.
55 This is an XS version of the well-known uplevel() routine from
56 Sub::Uplevel. There are a few differences between both
57 implmentations that are listed in the documentation.
58 The XS version is roughly 10 times faster than the pure-Perl
61 0.15 2011-08-24 14:20 UTC
62 + Fix : Localizing subroutines in an higher scope will now correctly
63 update the method cache.
65 0.14 2011-02-27 00:00 UTC
66 + Fix : [RT #64997] : Compatibility with perl 5.13.10.
67 Thanks Dave Mitchell for the notice.
68 + Tst : Lengthy tests have been ported to Test::Leaner, making the
69 whole test suite about 50% faster.
71 0.13 2010-12-20 01:00 UTC
72 + Fix : [RT #61904] : Stack corruption when using unwind() under
74 Thanks Sergey Aleynikov for contributing a fix.
75 + Fix : [RT #63378] : Compatibility with perl 5.13.8.
76 Thanks Andreas J. König for bisecting the issue.
77 + Tst : Threads tests are now only run on perl 5.13.4 and higher.
78 They could segfault randomly because of what seems to be an
79 internal bug of Perl, which has been addressed in 5.13.4.
80 There is also an environment variable that allows you to
81 forcefully run those tests, but it should be set only for
82 author testing and not for end users.
84 0.12 2010-05-19 00:45 UTC
85 + Fix : Compatibility with perl 5.13.
86 + Fix : Test failures with perl 5.8.0.
87 + Fix : A minor leak of SVs when a non array/hash was passed to
90 0.11 2010-04-16 23:20 UTC
91 + Chg : It's now forbiddent to pass a reference to a non-glob variable
92 as the localization target of localize(), localize_elem() and
94 + Chg : localize_elem() now only accepts localization of arrays or hashs
95 elements. For other types, it used to be a synonym of localize.
96 + Chg : localize_elem() no longer accepts a glob as the target. You now
97 have to specify the variable as a string. This is because it was
98 impossible in this case to handle meaningfully the array or the
99 hash reference passed as the assigned value.
100 + Doc : The synopsys was revamped, and the rest of the documentation was
102 + Fix : [RT #55593] : Segfault when localizing hash or array element to
103 different package in different file.
104 Thanks Dagfinn Ilmari Mannsåker for reporting.
105 + Fix : [RT #56301] : reap loses eval context when dying naturally.
106 Thanks Andrew Main for reporting.
107 + Fix : Scope inconsistencies and segfaults when saving several
108 localizations into the same target scope.
109 + Fix : Stop skipping frames as a pop optimization. This caused breakage
110 under the debugger (and most likely outside as well).
112 0.10 2010-01-18 23:50 UTC
113 + Fix : Properly handle given/when on 5.10.
114 + Fix : Some stack inconsistencies were fixed, though they were unlikely
115 to have an impact on your real-life code.
116 + Fix : Work around Kwalitee test misfailures.
118 0.09 2009-05-17 20:20 UTC
119 + Add : The new SU_THREADSAFE constant can be used to know whether the
120 module could have been built with thread safety enabled.
121 + Chg : Thread safety is disabled for perl 5.8 on Win32.
122 + Chg : A saner workaround for the "call_sv() during LEAVE clobbers the
123 still used last popped stack element" issue on 5.10.
125 0.08 2009-04-16 22:50 UTC
126 + Fix : [RT #44204] : Stack corruption with reap(). Thanks Torsten
127 Foertsch for reporting.
128 + Fix : Building with Solaris CC.
129 + Tst : unwind() in threads.
131 0.07 2009-02-20 00:20 UTC
132 + Chg : The CLONE method will no longer be defined for non-threaded
134 + Doc : Some examples on how to build the target context from the words.
135 + Fix : Some unlikely possible uninitialized reads, indirectly pointed
136 out in a Redhat review request.
137 + Fix : "localize *x, 'y' => $cxt" now matches Perl's behaviour for
139 + Fix : Miscellanous code cleanups, courtesy of Florian Ragwitz.
140 + Upd : Resources in META.yml.
142 0.06 2009-01-17 00:05 UTC
143 + Chg : INCOMPATIBLE CHANGE: The level is now absolute and no longer
144 relative to the current frame - we'll call it "context" from now
145 on. You should replace all your raw levels by combinations of
147 The old behaviour of "=> $n" can be easily reobtained by using
149 + Fix : As a result of this change, the module now plays nicely with
152 0.05 2009-01-12 18:15 UTC
153 + Fix : Stack mess when using unwind() in scalar context.
154 + Fix : Returning an automatic variable isn't wise, so let's use a
156 + Doc : Clarifications.
157 + Tst : Stress tests for unwind().
159 0.04 2009-01-11 18:40 UTC
160 + Add : unwind(@things, $level), that returns to an upper context.
161 + Add : want_at($level), that gives the wantarray for $level.
162 + Add : Control words, to reliably get the level of the n-th upper
163 subroutine or eval scope. TOPLEVEL was renamed to TOP.
164 + Fix : Tests with 5.6.
165 + Tst : Reordering and factoring some of the stress tests so that they
166 aren't needlessly ran several times.
168 0.03 2009-01-04 15:55 UTC
169 + Add : localize_delete(), that localize array/hash elements in upper
171 + Fix : Segfault when localizing array elements with an invalid negative
174 0.02 2008-12-28 18:40 UTC
175 + Doc : Clarifications and improvements.
176 + Fix : Missing compatibility macros.
177 + Fix : Localized nonexistant array elements should be deleted when
178 their time comes so that the array recovers its original length.
180 0.01 2008-12-26 16:05 UTC
181 First version, released on an unsuspecting world.