* complex.c: modified doc.

	* ratioanl.c: ditto.


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

3 files changed, 22 insertions, 8 deletions

diff --git a/ChangeLog b/ChangeLog
index 9f930c4f51..3f04ee6f37 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Sat Nov 10 19:28:16 2012  Tadayoshi Funaba  <tadf@dotrb.org>
+
+	* complex.c: modified doc.
+	* ratioanl.c: ditto.
+
 Sat Nov 10 18:20:10 2012  Tadayoshi Funaba  <tadf@dotrb.org>
 
 	* ext/date/date_parse.c: edited about era.
diff --git a/complex.c b/complex.c
index f2f524011c..d04c7d73dd 100644
--- a/complex.c
+++ b/complex.c
@@ -481,7 +481,8 @@ f_complex_new2(VALUE klass, VALUE x, VALUE y)
  *
  * Returns x+i*y;
  *
- *    Complex(1, 2)  #=> (1+2i)
+ *    Complex(1, 2)    #=> (1+2i)
+ *    Complex('1+2i')  #=> (1+2i)
  */
 static VALUE
 nucomp_f_complex(int argc, VALUE *argv, VALUE klass)
@@ -1427,6 +1428,8 @@ nucomp_to_f(VALUE self)
  *    Complex(1, 0).to_r    #=> (1/1)
  *    Complex(1, 0.0).to_r  # RangeError
  *    Complex(1, 2).to_r    # RangeError
+ *
+ * See rationalize.
  */
 static VALUE
 nucomp_to_r(VALUE self)
@@ -1446,12 +1449,13 @@ nucomp_to_r(VALUE self)
  *    cmp.rationalize([eps])  ->  rational
  *
  * Returns the value as a rational if possible (the imaginary part
- * should be exactly zero).  The optional argument eps is always
- * ignored.
+ * should be exactly zero).
  *
  *    Complex(1.0/3, 0).rationalize  #=> (1/3)
  *    Complex(1, 0.0).rationalize    # RangeError
  *    Complex(1, 2).rationalize      # RangeError
+ *
+ * See to_r.
  */
 static VALUE
 nucomp_rationalize(int argc, VALUE *argv, VALUE self)
diff --git a/rational.c b/rational.c
index c06794f31d..845b4d80b4 100644
--- a/rational.c
+++ b/rational.c
@@ -549,7 +549,8 @@ f_rational_new_no_reduce2(VALUE klass, VALUE x, VALUE y)
  *
  * Returns x/y;
  *
- *    Rational(1, 2)  #=> (1/2)
+ *    Rational(1, 2)   #=> (1/2)
+ *    Rational('1/2')  #=> (1/2)
  */
 static VALUE
 nurat_f_rational(int argc, VALUE *argv, VALUE klass)
@@ -1450,7 +1451,7 @@ nurat_rationalize_internal(VALUE a, VALUE b, VALUE *p, VALUE *q)
  *    rat.rationalize       ->  self
  *    rat.rationalize(eps)  ->  rational
  *
- * Returns a simpler approximation of the value if an optional
+ * Returns a simpler approximation of the value if the optional
  * argument eps is given (rat-|eps| <= result <= rat+|eps|), self
  * otherwise.
  *
@@ -1793,7 +1794,7 @@ nilclass_to_r(VALUE self)
  * call-seq:
  *    nil.rationalize([eps])  ->  (0/1)
  *
- * Returns zero as a rational.  An optional argument eps is always
+ * Returns zero as a rational.  The optional argument eps is always
  * ignored.
  */
 static VALUE
@@ -1822,7 +1823,7 @@ integer_to_r(VALUE self)
  * call-seq:
  *    int.rationalize([eps])  ->  rational
  *
- * Returns the value as a rational.  An optional argument eps is
+ * Returns the value as a rational.  The optional argument eps is
  * always ignored.
  */
 static VALUE
@@ -1872,6 +1873,8 @@ float_decode(VALUE self)
  *    2.5.to_r    #=> (5/2)
  *    -0.75.to_r  #=> (-3/4)
  *    0.0.to_r    #=> (0/1)
+ *
+ * See rationalize.
  */
 static VALUE
 float_to_r(VALUE self)
@@ -1900,12 +1903,14 @@ float_to_r(VALUE self)
  *    flt.rationalize([eps])  ->  rational
  *
  * Returns a simpler approximation of the value (flt-|eps| <= result
- * <= flt+|eps|).  if eps is not given, it will be chosen
+ * <= flt+|eps|).  if the optional eps is not given, it will be chosen
  * automatically.
  *
  *    0.3.rationalize          #=> (3/10)
  *    1.333.rationalize        #=> (1333/1000)
  *    1.333.rationalize(0.01)  #=> (4/3)
+ *
+ * See to_r.
  */
 static VALUE
 float_rationalize(int argc, VALUE *argv, VALUE self)