doc sub forms of combinations, permutations

S32-setting-library/Containers.pod

@@ -18,8 +18,8 @@ DRAFT: Synopsis 32: Setting Library - Containers.pod
 
     Created: 19 Feb 2009 extracted from S29-functions.pod
 
-    Last Modified: 12 Nov 2013
-    Version: 45
+    Last Modified: 24 Jan 2014
+    Version: 46
 
 If you read the HTML version, it is generated from the Pod in the specs
 repository under
@@ -633,6 +633,7 @@ C<.comb> on that string with the same parameters. See C<Str::comb>.
 
  multi method combinations ( Int $of )
  multi method combinations ( Range $of = 0 .. * )
+ multi combinations ( $n, $k )
 
 Returns all combinations of the list taken N at a time (specified
 by the C<$of> parameter).  If the range option is taken, then the
@@ -657,14 +658,19 @@ be the entire list.
 It is erroneous to ask for the combinations of any infinite list.
 The compiler is allowed to complain if it notices, however.
 
+The functional form assumes it is working on a list of integers C<^$n> taken C<$k> at a time.
+
 =item permutations
 
  multi method permutations ( )
+ multi permutations ( $n )
 
 Permutes the values of the list, returning the permutations as a
 list of (presumably immutable) array values.  (Types such as C<Range>
 are converted to a list of individual values before permuting them.)
 
+The functional form assumes it is working on a list of integers C<^$n>.
+
 =back
 
 =head2 Array