aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichael Anthony Knyszek <mknyszek@google.com>2025-05-09 19:54:01 +0000
committerMichael Knyszek <mknyszek@google.com>2025-05-15 08:27:04 -0700
commitfac2ccbed320ef9fdca251d63b759b61bbc21f2a (patch)
tree700d28a6de36576b15cdf387e82380a51d90fd11 /doc
parent01e0e8b6b397f2e775d9ccbfcde104d025464382 (diff)
downloadgo-fac2ccbed320ef9fdca251d63b759b61bbc21f2a.tar.xz
doc: add a release note for greenteagc GOEXPERIMENT
For #71661. Change-Id: I802b0c36cac3bbd87b35ff216f06822e87fb7b5d Reviewed-on: https://go-review.googlesource.com/c/go/+/671439 Reviewed-by: Michael Pratt <mpratt@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/next/4-runtime.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/next/4-runtime.md b/doc/next/4-runtime.md
index e19996863d..4e8182c8cf 100644
--- a/doc/next/4-runtime.md
+++ b/doc/next/4-runtime.md
@@ -24,3 +24,15 @@ On Linux systems with kernel support for anonymous VMA names
mappings with context about their purpose. e.g., `[anon: Go: heap]` for heap
memory. This can be disabled with the [GODEBUG setting](/doc/godebug)
`decoratemappings=0`.
+
+<!-- go.dev/issue/73581 -->
+
+A new experimental garbage collector is now available as an experiment. The
+new design aims to improve the efficiency of garbage collection through better
+locality and CPU scalability in the mark algorithm. Benchmark result vary, but
+we expect somewhere between a 10—40% reduction in garbage collection overhead
+in real-world programs that heavily use the garbage collector.
+
+The new garbage collector may be enabled by setting `GOEXPERIMENT=greenteagc`
+at build time. See the [GitHub issue](/issue/73581) for more details on the design
+and instructions on how to report feedback.