From: Robert Griesemer <gri@golang.org>
Date: Sun, 22 Aug 2021 19:11:02 +0000 (-0700)
Subject: math/big: clarified doc string for SetMantExp
X-Git-Tag: go1.18beta1~1679
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=19585826fa;p=gostls13.git

math/big: clarified doc string for SetMantExp

Fixes #47879.

Change-Id: I35efb5fc65c4f1eb1b45918f95bbe1ff4039950e
Reviewed-on: https://go-review.googlesource.com/c/go/+/344249
Trust: Robert Griesemer <gri@golang.org>
Run-TryBot: Robert Griesemer <gri@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Rob Pike <r@golang.org>
---

diff --git a/src/math/big/float.go b/src/math/big/float.go
index 42050e2c39..a8c91a6e54 100644
--- a/src/math/big/float.go
+++ b/src/math/big/float.go
@@ -304,7 +304,9 @@ func (z *Float) setExpAndRound(exp int64, sbit uint) {
 // SetMantExp sets z to mant × 2**exp and returns z.
 // The result z has the same precision and rounding mode
 // as mant. SetMantExp is an inverse of MantExp but does
-// not require 0.5 <= |mant| < 1.0. Specifically:
+// not require 0.5 <= |mant| < 1.0. Specifically, for a
+// given x of type *Float, SetMantExp relates to MantExp
+// as follows:
 //
 //	mant := new(Float)
 //	new(Float).SetMantExp(mant, x.MantExp(mant)).Cmp(x) == 0