From 963829552795668dc5b04c3a40bb52161bcd1076 Mon Sep 17 00:00:00 2001
From: stomar <stomar@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sun, 9 Apr 2017 13:30:31 +0000
Subject: math.c: improve docs for Math.sqrt

* math.c: [DOC] mention possibly surprising behavior of Math.sqrt
  due to floating point arithmetic; also refer to BigDecimal#sqrt.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@58291 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 math.c | 7 +++++++
 1 file changed, 7 insertions(+)

(limited to 'math.c')

diff --git a/math.c b/math.c
index 523937ecb3..8032e41ae3 100644
--- a/math.c
+++ b/math.c
@@ -590,6 +590,13 @@ math_log10(VALUE unused_obj, VALUE x)
  *    #   [8, 2.82842712474619, 8.0]
  *    #   [9, 3.0, 9.0]
  *    #   [10, 3.16227766016838, 10.0]
+ *
+ *  Note that the limited precision of floating point arithmetic
+ *  might lead to surprising results:
+ *
+ *    Math.sqrt(10**46).to_i  #=> 99999999999999991611392 (!)
+ *
+ *  See also BigDecimal#sqrt.
  */
 
 static VALUE
-- 
cgit v1.2.3