First batch of documentation of Supply methods

Author: lizmat

lib/Type/Supply.pod

@@ -202,7 +202,6 @@ Waits until the supply is done (in which case it returns C<True>) or C<quit>
     say "Done";
     await $p;
 
-
 =head2 method list
 
     method list(Supply:D:) returns List:D
@@ -214,7 +213,7 @@ since the C<list> call.
 
     method interval(Supply:U: $interval, $delay = 0)
 
-Creates a new interval that fires an event every C<$interval> seconds,
+Creates a supply that fires an event every C<$interval> seconds,
 starting C<$delay> seconds from the call. The event payload is an integer,
 starting from 0 at the first event, and is increment by one for each event.
 
@@ -242,6 +241,66 @@ with the element transformed through C<&mapper>;
     $double.tap(&say);
     $all.emit(4);           # 8
 
+=head2 method batch
+
+    method batch(Supply:D: :$elems, :$seconds)
+
+Creates a new supply that batches the values of the given Supply by either
+the number of elements (using :elems) or the maximum number of seconds
+(using the :seconds) or both.  Remaining values are batched into a final
+emission when the supply is done.
+
+=head2 method elems
+
+    method elems(Supply:D: $seconds?)
+
+Creates a new supply in which changes to the number of elements seen are
+emitted.  It optionally also takes an interval (in seconds) if you only want
+to be updated every so many seconds.
+
+=head2 method rotor
+
+    method rotor(Supply:D: @cycle)
+
+Creates a "rotoring" supply with the same semantics as List.rotor.
+
+=head2 method delayed
+
+    method delayed(Supply:D: $seconds)
+
+Creates a new supply in which all values are emitted with the given delay in
+seconds.
+
+=head2 method stable
+
+    method stable(Supply:D: $seconds, :$scheduler)
+
+Creates a new supply that only passes on a value if it wasn't superseded by
+another value in the given time (in seconds).  Optionally uses another
+scheduler than the default scheduler, using the :scheduler parameter.
+
+=head2 method reduce
+
+    method reduce(Supply:D: {...} )
+
+Creates a "reducing" supply with the same semantics as List.reduce.
+
+=head2 method lines
+
+    method lines(Supply:D: :$chomp = True )
+
+Creates a supply that will emit the characters coming in line by line from a
+supply that's usually created by some asynchronous I/O operation. The optional
+:chomp parameter indicates whether to remove line separators: the default is
+True.
+
+=head2 method words
+
+    method words(Supply:D:)
+
+Creates a supply that will emit the characters coming in word for word from a
+supply that's usually created by some asynchronous I/O operation.
+
 =head2 method schedule-on
 
     method schedule-on(Supply:D: $scheduler)