Changeset 20196 for docs

Timestamp:

03/31/08 20:23:51 (9 months ago)

Author:

lwall

Message:

[S29] rand is now 0-ary or method only

Files:

• docs/Perl6/Spec/Functions.pod (modified) (2 diffs)

docs/Perl6/Spec/Functions.pod

@@ -13 +13 @@
                 Mark Stosberg <mark@summersault.com>
  Date:          12 Mar 2005
- Last Modified: 24 Jan 2008
- Version:       19
+ Last Modified: 31 Jan 2008
+ Version:       20
 
 This document attempts to document the list of builtin functions in Perl 6.
@@ -296 +296 @@
 =item rand
 
- our Num multi method rand ( Num $x: )
- our Num multi rand ( Num $x = 1 )
+ our Num method rand ( Num $x: )
+ our Num term:<rand>
 
 Pseudo random number in range C<< 0 ..^ $x >>.  That is, C<0> is
-theoretically possible, while C<$x> is not.
-
+theoretically possible, while C<$x> is not.  The C<rand> function
+is 0-ary and always produces a number from C<0..^1>.  In any case,
+for picking a random integer you probably want to use something like
+C<(1..6).pick> instead.
 
 =item sign