random.c: improve docs for Random.bytes

* random.c: [DOC] improve language and RDoc markup in Random.bytes docs;
  also adjust call-seq style of Random.bytes and Random#bytes.

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

1 files changed, 4 insertions, 4 deletions

diff --git a/random.c b/random.c
index f41ae7cfba..0c1fdbe425 100644
--- a/random.c
+++ b/random.c
@@ -1084,7 +1084,7 @@ random_ulong_limited_big(VALUE obj, rb_random_t *rnd, VALUE vmax)
 static VALUE genrand_bytes(rb_random_t *rnd, long n);
 
 /*
- * call-seq: prng.bytes(size) -> a_string
+ * call-seq: prng.bytes(size) -> string
  *
  * Returns a random binary string containing +size+ bytes.
  *
@@ -1135,10 +1135,10 @@ rb_random_bytes(VALUE obj, long n)
 }
 
 /*
- * call-seq: Random.bytes(size) -> a_string
+ * call-seq: Random.bytes(size) -> string
  *
- * Returns a random binary string.  The argument size specified the length of
- * the result string.
+ * Returns a random binary string.
+ * The argument +size+ specifies the length of the returned string.
  */
 static VALUE
 random_s_bytes(VALUE obj, VALUE len)