Document await(Promise) and await(Channel)

Author: moritz

lib/Type/Channel.pod

@@ -86,4 +86,13 @@ Closes the channel (that is, makes subsequent C<send> calls die), and enqueues
 the error as the final element in the channel. Method C<receive> will throw
 the error as an exception.
 
+=head2 sub await
+
+    multi sub await(Channel:D)
+    multi sub await(*@)
+
+Waits until all of one or more channels has a value available, and returns
+those values (it calls C<.receive> on the channel). Also works with
+L<promises|/type/Promise>.
+
 =end pod

lib/Type/Promise.pod

@@ -211,4 +211,12 @@ exception of type C<X::Promise::Vowed>.
     $vow.keep;
     say $p.status;          # Kept
 
+=head2 sub await
+
+    multi sub await(Promise:D)
+    multi sub await(*@)
+
+Waits until one or more promises are all fulfilled, and then returns their
+values. Also works on L<channels|/type/Channel>.
+
 =end pod