From: Eric Lagergren <eric@ericlagergren.com>
Date: Wed, 28 Aug 2019 02:32:17 +0000 (-0700)
Subject: math/big: document that Rat.Denom might modify the receiver
X-Git-Tag: go1.14beta1~1305
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=9dfa4cb0260427c29137568c880aeae5e2a7f058;p=gostls13.git

math/big: document that Rat.Denom might modify the receiver

Fixes #33792

Change-Id: I306a95883c3db2d674d3294a6feb50adc50ee5d6
Reviewed-on: https://go-review.googlesource.com/c/go/+/192017
Reviewed-by: Robert Griesemer <gri@golang.org>
---

diff --git a/src/math/big/rat.go b/src/math/big/rat.go
index c8bf698b18..712116a08c 100644
--- a/src/math/big/rat.go
+++ b/src/math/big/rat.go
@@ -413,6 +413,8 @@ func (x *Rat) Num() *Int {
 // Denom returns the denominator of x; it is always > 0.
 // The result is a reference to x's denominator; it
 // may change if a new value is assigned to x, and vice versa.
+// If x's denominator is 1, Denom may materialize the denominator, thereby
+// modifying x.
 func (x *Rat) Denom() *Int {
 	x.b.neg = false // the result is always >= 0
 	if len(x.b.abs) == 0 {