1 files changed, 10 insertions, 1 deletions
diff --git a/bignum.c b/bignum.c
index b4e13444e5..a2ce0bc3bb 100644
--- a/bignum.c
+++ b/bignum.c
@@ -2308,7 +2308,9 @@ rb_big_divide(VALUE x, VALUE y, ID op)
  *  call-seq:
  *     big / other     => Numeric
  *
- *  Divides big by other, returning the result.
+ * Performs division: the class of the resulting object depends on
+ * the class of <code>numeric</code> and on the magnitude of the
+ * result.
  */
 
 VALUE
@@ -2317,6 +2319,13 @@ rb_big_div(VALUE x, VALUE y)
     return rb_big_divide(x, y, '/');
 }
 
+/*
+ *  call-seq:
+ *     big.div(other)  => integer
+ *
+ * Performs integer division: returns integer value.
+ */
+
 VALUE
 rb_big_idiv(VALUE x, VALUE y)
 {