A few documentation improvements.

Author: pmichaud

lib/List.pod

@@ -140,29 +140,28 @@ Creates the hash C<< { odd => [1, 3], even => [2, 4] } >> in C<%h>.
     multi method Bool(List:D:) returns Bool:D
 
 Returns C<True> if the list has at least one element, and C<False>
-for the empty list
+for the empty list.
 
 =head3 Str
 
     multi method Str(List:D:) returns Str:D
 
-Same as C<.join(' ')>.
+Stringifies the elements of the list and joins them with spaces
+(same as C<.join(' ')>).
 
 =head3 Int
 
     multi method Int(List:D:) return Int:D
 
-Same as C<.elems>.
+Returns the number of elements in the list (same as C<.elems>).
 
 =head3 pick
 
     multi method pick(List:D:, $count = 1)
 
-Returns a list of random, non-repeating list elements of C<$count>
-elements (or a single element if C<$count> is 1).
-
-If a C<*> is passed to C<$count>, all elements are returned in a random
-order.
+Returns C<$count> elements chosen at random and without repetition
+from the invocant.  If C<*> is passed as C<$count>, all elements
+from the invocant list are returned in a random sequence.
 
 =head3 roll
 
@@ -179,8 +178,9 @@ elements from the original list.
 
     multi method eager(List:D:) returns List:D
 
-Evaluates all elements in the list, ie make the list not be lazy.
-Returns the invocant.
+Evaluates all elements in the list eagerly, and returns the invocant.
+If a List signals that it is "known infinite", eager evaluation may
+stop at the point where the infinity is detected.
 
 =head3 reverse