Fixes and adds example refs #1268

Raku · Jun 24, 2019 · c5f83a8 · c5f83a8 · b2gills · Jun 24, 2019
1 parent a0c8ad1
commit c5f83a8
Showing 1 changed file with 28 additions and 5 deletions.
diff --git a/doc/Type/CX/Next.pod6 b/doc/Type/CX/Next.pod6
@@ -6,11 +6,34 @@
 
     role CX::Next does X::Control { }
 
-A L<control exception|/language/exceptions#Control_exceptions> to be used to
-proceed to the next iteration; since Rakudo 2019.03, C<throw>ing an
-C<X::Control> object raises a control exception which is caught by the
-L<CONTROL phaser|/language/phasers#CONTROL> instead of
-L<CATCH|/language/phasers#CATCH>.
+A L<control exception|/language/exceptions#Control_exceptions> that is triggered
+when C<next> is called; since Rakudo 2019.03, C<throw>ing an C<X::Control>
+object raises a control exception which can be caught by the L<CONTROL
+phaser|/language/phasers#CONTROL> instead of L<CATCH|/language/phasers#CATCH>.
+
+=for code
+for ^10 {
+    CONTROL {
+      when CX::Next { say "We're next" };
+    }
+    next if $_ %% 2;
+    say "We're in $_";
+}
+
+This will print:
+
+=for code :lang<text>
+We're next
+We're in 1
+We're next
+We're in 3
+We're next
+We're in 5
+We're next
+We're in 7
+We're next
+We're in 9
+
 
 =head1 Methods