* random.c: Document range argument for Kernel#rand.

  [ruby-core:51794] [Bug #7770]


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@39025 b2dd03c8-39d4-4d8f-98ff-823fe69b080e

1 files changed, 5 insertions, 3 deletions

diff --git a/random.c b/random.c
index 50db6ec393..6e635d912f 100644
--- a/random.c
+++ b/random.c
@@ -1273,12 +1273,14 @@ random_equal(VALUE self, VALUE other)
  *
  *   rand        #=> 0.2725926052826416
  *
- * When <tt>max.abs</tt> is greater than or equal to 1, +rand+ returns a
- * pseudo-random integer greater than or equal to 0 and less than
- * <tt>max.to_i.abs</tt>.
+ * When +max.abs+ is greater than or equal to 1, +rand+ returns a pseudo-random
+ * integer greater than or equal to 0 and less than +max.to_i.abs+.
  *
  *   rand(100)   #=> 12
  *
+ * When +max+ is a Range, +rand+ returns a random number where
+ * range.member?(number) == true.
+ *
  * Negative or floating point values for +max+ are allowed, but may give
  * surprising results.
  *