Added a note to the documentation for the Date related Numeric extensions to indicate that they're

approximations and shouldn't be used for critical calculations. [Koz].  Closes #4148.  References #4146


git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@3821 5ecf4fe2-1ee6-0310-87b1-e25e094e27de

activesupport/CHANGELOG

@@ -1,5 +1,8 @@
 *SVN*
 
+* Added a note to the documentation for the Date related Numeric extensions to indicate that they're
+approximations and shouldn't be used for critical calculations. [Koz]
+
 * Added Hash#to_xml and Array#to_xml that makes it much easier to produce XML from basic structures [DHH]. Examples:
 
     { :name => "David", :street_name => "Paulina", :age => 26, :moved_on => Date.new(2005, 11, 15) }.to_xml

activesupport/lib/active_support/core_ext/numeric/time.rb

@@ -1,7 +1,12 @@
 module ActiveSupport #:nodoc:
   module CoreExtensions #:nodoc:
     module Numeric #:nodoc:
-      # Enables the use of time calculations and declarations, like 45.minutes + 2.hours + 4.years
+      # Enables the use of time calculations and declarations, like 45.minutes + 2.hours + 4.years.
+      # 
+      # Some of these methods are approximations, Ruby's core 
+      # Date[http://stdlib.rubyonrails.org/libdoc/date/rdoc/index.html] and 
+      # Time[http://stdlib.rubyonrails.org/libdoc/time/rdoc/index.html] should be used for precision
+      # date and time arithmetic
       module Time
         def minutes
           self * 60