From: Vincent Pit Date: Thu, 20 Sep 2012 19:02:32 +0000 (+0200) Subject: Minor POD tweaks X-Git-Tag: v0.21~6 X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2FScope-Upper.git;a=commitdiff_plain;h=1b110669e2687abaa42892a3b1e2e2e229df7044 Minor POD tweaks --- diff --git a/lib/Scope/Upper.pm b/lib/Scope/Upper.pm index 4d44d6c..57e312d 100644 --- a/lib/Scope/Upper.pm +++ b/lib/Scope/Upper.pm @@ -305,7 +305,7 @@ C<$key> is ignored. unwind; unwind @values, $context; -Returns C<@values> I the subroutine, eval or format context pointed by or just above C<$context>, and immediately restart the program flow at this point - thus effectively returning C<@values> to an upper scope. +Returns C<@values> I the subroutine, eval or format context pointed by or just above C<$context>, and immediately restarts the program flow at this point - thus effectively returning C<@values> to an upper scope. If C<@values> is empty, then the C<$context> parameter is optional and defaults to the current context (making the call equivalent to a bare C) ; otherwise it is mandatory. The upper context isn't coerced onto C<@values>, which is hence always evaluated in list context. @@ -325,7 +325,7 @@ You can use L to handle these cases. yield; yield @values, $context; -Returns C<@values> I the context pointed by or just above C<$context>, and immediately restart the program flow at this point. +Returns C<@values> I the context pointed by or just above C<$context>, and immediately restarts the program flow at this point. If C<@values> is empty, then the C<$context> parameter is optional and defaults to the current context ; otherwise it is mandatory. L differs from L in that it can target I upper scope (besides a C substitution context) and not necessarily a sub, an eval or a format. @@ -351,7 +351,7 @@ You can use the fifth value returned by L to handle context coerc leave @values; Immediately returns C<@values> from the current block, whatever it may be (besides a C substitution context). -C is actually a synonym for C, while C is a synonym for C. +C is actually a synonym for C, while C is a synonym for C. Like for L, you can use the fifth value returned by L to handle context coercion. @@ -381,7 +381,7 @@ will rightfully set C<$num> to C<26>. Gives information about the context denoted by C<$context>, akin to what L provides but not limited only to subroutine, eval and format contexts. When C<$context> is omitted, it defaults to the current context. -The values returned are, in order : +The returned values are, in order : =over 4