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