rephrase Supply.first description

stoned · stoned · commit e94d112bc90d · 2020-02-17T19:25:40.000+01:00
diff --git a/doc/Type/Supply.pod6 b/doc/Type/Supply.pod6
@@ -374,17 +374,19 @@ Creates a "tail" supply with the same semantics as L<List.tail|/type/List#method
 
     method first(Supply:D: :$end, |c)
 
-This method is a frontend on the C<grep> method. Its creates a new "head"
-supply, or a "tail" supply if the optional named parameter C<:end>
-is truthy, from a supply created by calling the C<grep> method on the
-invocant, with any remaining arguments as parameters.
-If there are no remaining argument, this method is equivalent to calling
+This method creates a supply of the first element, or the last element if
+the optional named parameter C<:end> is truthy, from a supply created by
+calling the C<grep> method on the invocant, with any remaining arguments
+as parameters.
+If there is no remaining argument, this method is equivalent to calling
 on the invocant, without parameter, the C<head> or the C<tail> method,
 according to named parameter C<:end>.
 
     my $rand = supply { emit (rand × 100).floor for ^∞ };
     my $first-prime = $rand.first: &is-prime;
-    $first-prime.tap: &say; # output the first prime from the endless random number supply $rand
+    # output the first prime from the endless random number supply $rand,
+    # then the $first-prime supply reaches its end
+    $first-prime.tap: &say;
 
 =head2 method rotor
 
