From: Vincent Pit <vince@profvince.com>
Date: Fri, 23 Aug 2013 19:33:09 +0000 (-0300)
Subject: POD verbatim paragraphs should fit into a terminal
X-Git-Tag: v0.11~5
X-Git-Url: http://git.vpit.fr/?p=perl%2Fmodules%2FSub-Prototype-Util.git;a=commitdiff_plain;h=397877aa88384ae12584dcf22494c35ab0adc5cd

POD verbatim paragraphs should fit into a terminal
---

diff --git a/lib/Sub/Prototype/Util.pm b/lib/Sub/Prototype/Util.pm
index a981d27..011d1c2 100644
--- a/lib/Sub/Prototype/Util.pm
+++ b/lib/Sub/Prototype/Util.pm
@@ -29,10 +29,17 @@ $VERSION = '0.10';
     my @a = qw<a b c>;
     my @args = ( \@a, 1, { d => 2 }, undef, 3 );
 
-    my @flat = flatten '\@$;$', @args; # ('a', 'b', 'c', 1, { d => 2 })
-    recall 'CORE::push', @args; # @a contains 'a', 'b', 'c', 1, { d => 2 }, undef, 3
+    my @flat = flatten '\@$;$', @args;
+    # @flat contains now ('a', 'b', 'c', 1, { d => 2 })
+
+    my $res = recall 'CORE::push', @args;
+    # @a contains now 'a', 'b', 'c', 1, { d => 2 }, undef, 3
+    # and $res is 7
+
     my $splice = wrap 'CORE::splice';
-    my @b = $splice->(\@a, 4, 2); # @a is now ('a', 'b', 'c', 1, 3) and @b is ({ d => 2 }, undef)
+    my @b = $splice->(\@a, 4, 2);
+    # @a contains now ('a', 'b', 'c', 1, 3)
+    # and @b is ({ d => 2 }, undef)
 
 =head1 DESCRIPTION
 
@@ -170,7 +177,8 @@ Defaults to true, but turned off when C<sub> is false.
 For example, this allows you to recall into C<CORE::grep> and C<CORE::map> by using the C<\&@> prototype :
 
     my $grep = wrap { 'CORE::grep' => '\&@' };
-    sub mygrep (&@) { $grep->(@_) } # the prototypes are intentionally different
+    # the prototypes are intentionally different
+    sub mygrep (&@) { $grep->(@_) }
 
 =cut