drbrain	2011-05-21 02:51:16 +0900 (Sat, 21 May 2011)

  New Revision: 31653

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=31653

  Log:
    * ext/bigdecimal/lib/bigdecimal/util.rb:  Improve documentation.  Patch
      by Pete Higgins.  [Ruby 1.9 - Bug #4746]

  Modified files:
    trunk/ChangeLog
    trunk/ext/bigdecimal/lib/bigdecimal/util.rb

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 31652)
+++ ChangeLog	(revision 31653)
@@ -1,3 +1,8 @@
+Sat May 21 02:51:01 2011  Eric Hodel  <drbrain@s...>
+
+	* ext/bigdecimal/lib/bigdecimal/util.rb:  Improve documentation.  Patch
+	  by Pete Higgins.  [Ruby 1.9 - Bug #4746]
+
 Sat May 21 02:44:10 2011  Eric Hodel  <drbrain@s...>
 
 	* ext/bigdecimal/lib/bigdecimal/jacobian.rb:  Document isEqual.  Patch
Index: ext/bigdecimal/lib/bigdecimal/util.rb
===================================================================
--- ext/bigdecimal/lib/bigdecimal/util.rb	(revision 31652)
+++ ext/bigdecimal/lib/bigdecimal/util.rb	(revision 31653)
@@ -1,35 +1,50 @@
-#
-# BigDecimal utility library.
-#
-# To use these functions, require 'bigdecimal/util'
-#
-# The following methods are provided to convert other types to BigDecimals:
-#
-#   String#to_d -> BigDecimal
-#   Float#to_d -> BigDecimal
-#   Rational#to_d -> BigDecimal
-#
-# The following method is provided to convert BigDecimals to other types:
-#
-#   BigDecimal#to_r -> Rational
-#
-# ----------------------------------------------------------------------
-#
 class Float < Numeric
+  # call-seq:
+  #     flt.to_d  -> bigdecimal
+  #
+  # Convert +flt+ to a BigDecimal and return it.
+  #
+  #     require 'bigdecimal'
+  #     require 'bigdecimal/util'
+  #
+  #     0.5.to_d
+  #     # => #<BigDecimal:1dc69e0,'0.5E0',9(18)> 
+  #
   def to_d
     BigDecimal(self.to_s)
   end
 end
 
 class String
+  # call-seq:
+  #     string.to_d  -> bigdecimal
+  #
+  # Convert +string+ to a BigDecimal and return it.
+  #
+  #     require 'bigdecimal'
+  #     require 'bigdecimal/util'
+  #
+  #     "0.5".to_d
+  #     # => #<BigDecimal:1dc69e0,'0.5E0',9(18)> 
+  #
   def to_d
     BigDecimal(self)
   end
 end
 
 class BigDecimal < Numeric
+  # call-seq:
+  #     a.to_digits -> string
+  #
   # Converts a BigDecimal to a String of the form "nnnnnn.mmm".
   # This method is deprecated; use BigDecimal#to_s("F") instead.
+  #
+  #     require 'bigdecimal'
+  #     require 'bigdecimal/util'
+  #
+  #     d = BigDecimal.new("3.14")
+  #     d.to_digits
+  #     # => "3.14"
   def to_digits
     if self.nan? || self.infinite? || self.zero?
       self.to_s
@@ -42,7 +57,19 @@
 end
 
 class Rational < Numeric
-  # Converts a Rational to a BigDecimal
+  # call-seq:
+  #   r.to_d        -> bigdecimal
+  #   r.to_d(sig)   -> bigdecimal
+  #
+  # Converts a Rational to a BigDecimal. Takes an optional parameter +sig+ to
+  # limit the amount of significant digits.
+  #
+  #   r = (22/7.0).to_r
+  #   # => (7077085128725065/2251799813685248)
+  #   r.to_d
+  #   # => #<BigDecimal:1a52bd8,'0.3142857142 8571427937 0154144999 105E1',45(63)>
+  #   r.to_d(3)
+  #   # => #<BigDecimal:1a44d08,'0.314E1',18(36)> 
   def to_d(nFig=0)
     num = self.numerator.to_s
     if nFig<=0

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/