From 66689c7d46fb32eca064c9a1e0b2c9de6d377524 Mon Sep 17 00:00:00 2001 From: Russ Cox Date: Tue, 17 Jan 2023 09:21:43 -0500 Subject: [PATCH] doc/go1.20: remove mention of arena goexperiment The arena goexperiment contains code used inside Google in very limited use cases that we will maintain, but the discussion on #51317 identified serious problems with the very idea of adding arenas to the standard library. In particular the concept tends to infect many other APIs in the name of efficiency, a bit like sync.Pool except more publicly visible. It is unclear when, if ever, we will pick up the idea and try to push it forward into a public API, but it's not going to happen any time soon, and we don't want users to start depending on it: it's a true experiment and may be changed or deleted without warning. The arena text in the release notes makes them seem more official and supported than they really are, and we've already seen a couple blog posts based on that erroneous belief. Delete the text to try to set expectations better. Change-Id: I4f6e328ac470a9cd410f5f722d0769ef62d5e5ba Reviewed-on: https://go-review.googlesource.com/c/go/+/462355 TryBot-Result: Gopher Robot Reviewed-by: Austin Clements Run-TryBot: Russ Cox Auto-Submit: Russ Cox Reviewed-by: Eli Bendersky --- doc/go1.20.html | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/doc/go1.20.html b/doc/go1.20.html index a497f87712..6c007fe1ff 100644 --- a/doc/go1.20.html +++ b/doc/go1.20.html @@ -289,17 +289,6 @@ Do not send CLs removing the interior tags from such phrases.

Runtime

-

- The runtime now has experimental support for memory-safe arena allocation - that makes it possible to eagerly free memory in bulk. - When used appropriately, it has the potential to improve CPU performance by - up to 15% in memory-allocation-heavy applications. - To try it out, build your Go program with GOEXPERIMENT=arenas, - which will make the arena package visible to your program. - Source files that import the arena package must require the - goexperiment.arenas build tag. -

-

Some of the garbage collector's internal data structures were reorganized to be both more space and CPU efficient. @@ -1240,3 +1229,4 @@ proxyHandler := &httputil.ReverseProxy{ + -- 2.50.0