Add a note to Random.urandom

The method may return nil for some reasons.

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

1 files changed, 3 insertions, 1 deletions

diff --git a/random.c b/random.c
index 8ea28a5792..82a51ccb6d 100644
--- a/random.c
+++ b/random.c
@@ -606,8 +606,10 @@ random_seed(void)
  * call-seq: Random.urandom(size) -> string
  *
  * Returns a string, using platform providing features.
- * Returned value expected to be a cryptographically secure
+ * Returned value is expected to be a cryptographically secure
  * pseudo-random number in binary form.
+ * This method returns nil if the feature provided by platform
+ * failed to prepare the result.
  *
  * In 2017, Linux manpage random(7) writes that "no cryptographic
  * primitive available today can hope to promise more than 256 bits of