X-Git-Url: http://git.vpit.fr/?a=blobdiff_plain;f=lib%2FScope%2FUpper.pm;h=6e05a038176ea909a70d3e58f67f0e6b074e394e;hb=5d857b7ad4cfbe517b0806ca6816ab4a2ac047ae;hp=a78272700766875a4fb2b63d29a43f12704dddfb;hpb=832f6a4eae21bec85e1cb1043fbc41fcf59cbfcd;p=perl%2Fmodules%2FScope-Upper.git diff --git a/lib/Scope/Upper.pm b/lib/Scope/Upper.pm index a782727..6e05a03 100644 --- a/lib/Scope/Upper.pm +++ b/lib/Scope/Upper.pm @@ -1,5 +1,7 @@ package Scope::Upper; +use 5.006_001; + use strict; use warnings; @@ -9,13 +11,13 @@ Scope::Upper - Act on upper scopes. =head1 VERSION -Version 0.21 +Version 0.27 =cut our $VERSION; BEGIN { - $VERSION = '0.21'; + $VERSION = '0.27'; } =head1 SYNOPSIS @@ -182,7 +184,7 @@ execute a subroutine in the setting of an upper subroutine stack frame with L and L. +uniquely identify contexts with L and L. =back @@ -290,7 +292,7 @@ A glob, in which case C<$key> is ignored and the call is equivalent to C or C<'%'>, for which the call is equivalent to respectiveley C and C. +A string beginning with C<'@'> or C<'%'>, for which the call is equivalent to respectively C and C. =item * @@ -603,7 +605,7 @@ The context of the current scope. =head2 Getting a context from a context For any of those functions, C<$from> is expected to be a context. -When omitted, it defaults to the the current context. +When omitted, it defaults to the current context. =head3 C @@ -787,9 +789,12 @@ when the runloop callback is replaced by another module. In those three cases, L will look for a C statement in its callback and, if there is one, throw an exception before executing the code. -Moreover, in order to handle C statements properly, L currently has to suffer a run-time overhead proportional to the size of the the callback in every case (with a small ratio), and proportional to the size of B the code executed as the result of the L call (including subroutine calls inside the callback) when a C statement is found in the L callback. +Moreover, in order to handle C statements properly, L currently has to suffer a run-time overhead proportional to the size of the callback in every case (with a small ratio), and proportional to the size of B the code executed as the result of the L call (including subroutine calls inside the callback) when a C statement is found in the L callback. Despite this shortcoming, this XS version of L should still run way faster than the pure-Perl version from L. +Starting from C 5.19.4, it is unfortunately no longer possible to reliably throw exceptions from L'd code while the debugger is in use. +This may be solved in a future version depending on how the core evolves. + =head1 DEPENDENCIES L 5.6.1. @@ -797,7 +802,7 @@ L 5.6.1. A C compiler. This module may happen to build with a C++ compiler as well, but don't rely on it, as no guarantee is made in this regard. -L (core since perl 5.006). +L (core since perl 5.6.0). =head1 SEE ALSO @@ -829,8 +834,6 @@ You can find documentation for this module with the perldoc command. perldoc Scope::Upper -Tests code coverage report is available at L. - =head1 ACKNOWLEDGEMENTS Inspired by Ricardo Signes. @@ -839,7 +842,7 @@ Thanks to Shawn M. Moore for motivation. =head1 COPYRIGHT & LICENSE -Copyright 2008,2009,2010,2011,2012 Vincent Pit, all rights reserved. +Copyright 2008,2009,2010,2011,2012,2013,2014,2015 Vincent Pit, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.