slices: clarify that Grow can modify elements past the length
This is a documentation-only change.
Change-Id: Ic7847471543468f148498785cdb0b1998e1f53b5
Reviewed-on: https://go-review.googlesource.com/c/exp/+/387154
Trust: Ian Lance Taylor <iant@golang.org>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Eli Bendersky <eliben@golang.org>
diff --git a/slices/slices.go b/slices/slices.go
index 55f39e7..df78daf 100644
--- a/slices/slices.go
+++ b/slices/slices.go
@@ -200,7 +200,8 @@
// Grow increases the slice's capacity, if necessary, to guarantee space for
// another n elements. After Grow(n), at least n elements can be appended
-// to the slice without another allocation. If n is negative or too large to
+// to the slice without another allocation. Grow may modify elements of the
+// slice between the length and the capacity. If n is negative or too large to
// allocate the memory, Grow panics.
func Grow[S ~[]E, E any](s S, n int) S {
return append(s, make(S, n)...)[:len(s)]
