From ab7baebb6ddb8ad4b06dfdc0f75fbecba19ca21d Mon Sep 17 00:00:00 2001
From: tadf <tadf@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Fri, 19 Jun 2009 21:57:51 +0000
Subject: [PATCH] 	* complex.c: edited rdoc.

	* rational.c: ditto.



git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@23753 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ChangeLog       | 10 ++++++++--
 complex.c       | 44 ++++++++++++++++++++++----------------------
 lib/complex.rb  |  2 ++
 lib/rational.rb |  2 ++
 numeric.c       |  6 +++---
 rational.c      |  8 +++++++-
 6 files changed, 44 insertions(+), 28 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f547246253..b2e5ab3b85 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,8 +1,14 @@
+Sat Jun 20 06:56:31 2009  Tadayoshi Funaba  <tadf@dotrb.org>
+
+	* complex.c: edited rdoc.
+
+	* rational.c: ditto.
+
 Sat Jun 20 05:08:59 2009  Tadayoshi Funaba  <tadf@dotrb.org>
 
-	* complex.c; edited rdoc.
+	* complex.c: edited rdoc.
 
-	* rational.c; ditto.
+	* rational.c: ditto.
 
 Sat Jun 20 04:30:35 2009  Tadayoshi Funaba  <tadf@dotrb.org>
 
diff --git a/complex.c b/complex.c
index 3ebbbd3f6e..d3850ac4e5 100644
--- a/complex.c
+++ b/complex.c
@@ -1311,24 +1311,6 @@ make_patterns(void)
 #define id_gsub_bang rb_intern("gsub!")
 #define f_gsub_bang(x,y,z) rb_funcall(x, id_gsub_bang, 2, y, z)
 
-/*
- * call-seq:
- *   string.to_c  =>  complex
- *
- * Returns a complex which denotes string form.
- *
- * For example:
- *
- *     '9'.to_c          #=> (9+0i)
- *     '-3/2'.to_c       #=> ((-3/2)+0i)
- *     '-i'.to_c         #=> (0-1i)
- *     '45i'.to_c        #=> (0+45i)
- *     '3-4i'.to_c       #=> (3-4i)
- *     '-4e2-4e-2i'.to_c #=> (-400.0-0.04i)
- *     '-0.0-0.0i'.to_c  #=> (-0.0-0.0i)
- *     '1/2+3/4i'.to_c   #=> ((1/2)+(3/4)*i)
- *     'ruby'.to_c       #=> (0+0i)
- */
 static VALUE
 string_to_c_internal(VALUE self)
 {
@@ -1428,6 +1410,24 @@ string_to_c_strict(VALUE self)
 #define id_gsub rb_intern("gsub")
 #define f_gsub(x,y,z) rb_funcall(x, id_gsub, 2, y, z)
 
+/*
+ * call-seq:
+ *   str.to_c  =>  complex
+ *
+ * Returns a complex which denotes string form.
+ *
+ * For example:
+ *
+ *     '9'.to_c          #=> (9+0i)
+ *     '-3/2'.to_c       #=> ((-3/2)+0i)
+ *     '-i'.to_c         #=> (0-1i)
+ *     '45i'.to_c        #=> (0+45i)
+ *     '3-4i'.to_c       #=> (3-4i)
+ *     '-4e2-4e-2i'.to_c #=> (-400.0-0.04i)
+ *     '-0.0-0.0i'.to_c  #=> (-0.0-0.0i)
+ *     '1/2+3/4i'.to_c   #=> ((1/2)+(3/4)*i)
+ *     'ruby'.to_c       #=> (0+0i)
+ */
 static VALUE
 string_to_c(VALUE self)
 {
@@ -1591,7 +1591,7 @@ numeric_arg(VALUE self)
  * call-seq:
  *   num.rect  =>  array
  *
- * This means [num, 0].
+ * Returns an array [num, 0].
  */
 static VALUE
 numeric_rect(VALUE self)
@@ -1603,7 +1603,7 @@ numeric_rect(VALUE self)
  * call-seq:
  *   num.polar  =>  array
  *
- * This means [num.abs, num.arg].
+ * Returns an array [num.abs, num.arg].
  */
 static VALUE
 numeric_polar(VALUE self)
@@ -1613,8 +1613,8 @@ numeric_polar(VALUE self)
 
 /*
  * call-seq:
- *   cmp.conj       =>  self
- *   cmp.conjucate  =>  self
+ *   num.conj       =>  self
+ *   num.conjucate  =>  self
  *
  * Returns self.
  */
diff --git a/lib/complex.rb b/lib/complex.rb
index 301879143f..c7c1a03b91 100644
--- a/lib/complex.rb
+++ b/lib/complex.rb
@@ -1,3 +1,5 @@
+# :enddoc:
+
 require 'cmath'
 
 unless defined?(Math.exp!)
diff --git a/lib/rational.rb b/lib/rational.rb
index 5acfa5433d..68eec47a58 100644
--- a/lib/rational.rb
+++ b/lib/rational.rb
@@ -1,3 +1,5 @@
+# :enddoc:
+
 class Fixnum
 
   alias quof fdiv
diff --git a/numeric.c b/numeric.c
index 627c5297c1..a2bd0f4ebf 100644
--- a/numeric.c
+++ b/numeric.c
@@ -425,8 +425,8 @@ num_int_p(VALUE num)
 
 /*
  *  call-seq:
- *     num.abs        =>  num or numeric
- *     num.magnitude  =>  num or numeric
+ *     num.abs        =>  num
+ *     num.magnitude  =>  num
  *
  *  Returns the absolute value of <i>num</i>.
  *
@@ -1172,7 +1172,7 @@ flo_to_f(VALUE num)
 /*
  *  call-seq:
  *     flt.abs        =>  float
- *     flt.magnitude  =>  num or numeric
+ *     flt.magnitude  =>  float
  *
  *  Returns the absolute value of <i>flt</i>.
  *
diff --git a/rational.c b/rational.c
index 98d8be30e4..35f5c40121 100644
--- a/rational.c
+++ b/rational.c
@@ -1723,6 +1723,12 @@ numeric_numerator(VALUE self)
     return f_numerator(f_to_r(self));
 }
 
+/*
+ * call-seq:
+ *   num.denominator  =>  integer
+ *
+ * Returns the denominator of _num_ as an +Integer+ object.
+ */
 static VALUE
 numeric_denominator(VALUE self)
 {
@@ -2009,7 +2015,7 @@ string_to_r_strict(VALUE self)
 
 /*
  * call-seq:
- *   string.to_r  =>  rational
+ *   str.to_r  =>  rational
  *
  * Returns a +Rational+ object representing _string_ as a rational number.
  * Leading and trailing whitespace is ignored. Underscores may be used to