doc statement form of given

Raku · Jun 3, 2016 · 0ea5cd8 · 0ea5cd8
1 parent 2cd8cd1
commit 0ea5cd8
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/doc/Language/control.pod b/doc/Language/control.pod
@@ -558,6 +558,20 @@ if there is one:
         }
         "This also says".say;
     }
+=head2 X<given as a statement|control flow,given statement>
+
+C<given> can follow a statement to set the topic in the statement it follows.
+
+    .say given "foo";
+    # OUTPUT«foo␤»
+
+    printf "%s %02i.%02i.%i",
+            <Mo Tu We Th Fr Sa Su>[.day-of-week],
+            .day,
+            .month,
+            .year
+        given DateTime.now;
+    # OUTPUT«Sa 03.06.2016»
 
 =head1 X<loop|control flow>