Document Mu.take()

Author: paultcochrane

lib/Type/Mu.pod

@@ -242,4 +242,19 @@ Marks a type as being exported, that is, available to external users.
 A user of a module or class automatically gets all the symbols imported that
 are marked as C<is export>.
 
+=head2 method take
+
+    method take()
+
+Takes the given item and passes it to the enclosing C<gather> block.
+
+    #| randomly select numbers for lotto
+    my $num-selected-numbers = 6;
+    my $max-lotto-numbers = 49;
+    gather for ^$num-selected-numbers {
+        take (1 .. $max-lotto-numbers).pick(1);
+    }.say;    #-> 32 22 1 17 32 9  (for example)
+
 =end pod
+
+# vim: expandtab shiftwidth=4 ft=perl6