From: Michael Anthony Knyszek Date: Mon, 11 Dec 2023 18:43:11 +0000 (+0000) Subject: doc: fix formatting of runtime and runtime/trace release notes X-Git-Tag: go1.22rc1~47 X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=9db508d46fe201ecc6184ebd7b73770ed38fbdf9;p=gostls13.git doc: fix formatting of runtime and runtime/trace release notes For #61422. Change-Id: I621627140d2d5ebede9b932a7e55fbe92ded5249 Reviewed-on: https://go-review.googlesource.com/c/go/+/548935 Auto-Submit: Michael Knyszek LUCI-TryBot-Result: Go LUCI Reviewed-by: Michael Pratt --- diff --git a/doc/go1.22.html b/doc/go1.22.html index bbd71b5893..fca4f5ba53 100644 --- a/doc/go1.22.html +++ b/doc/go1.22.html @@ -177,13 +177,14 @@ defer func() {

The runtime now keeps type-based garbage collection metadata nearer to each heap object, improving the CPU performance (latency or throughput) of Go programs - by 1—3%. + by 1–3%. This change also reduces the memory overhead of the majority Go programs by approximately 1% by deduplicating redundant metadata. Some programs may see a smaller improvement because this change adjusts the size class boundaries of the memory allocator, so some objects may be moved up a size class. -
+

+

A consequence of this change is that some objects' addresses that were previously always aligned to a 16 byte (or higher) boundary will now only be aligned to an 8 byte boundary. @@ -749,7 +750,8 @@ defer func() {

The execution tracer has been completely overhauled in this release, resolving several long-standing issues and paving the way for new use-cases for execution traces. -
+

+

Execution traces now use the operating system's clock on most platforms (Windows excluded) so it is possible to correlate them with traces produced by lower-level components. Execution traces no longer depend on the reliability of the platform's clock to produce a correct trace. @@ -759,13 +761,15 @@ defer func() { Execution traces now contain information about the operating system threads that goroutines executed on. The latency impact of starting and stopping execution traces has been dramatically reduced. Execution traces may now begin or end during the garbage collection mark phase. -
+

+

To allow Go developers to take advantage of these improvements, an experimental trace reading package is available at golang.org/x/exp/trace. Note that this package only works on traces produced by programs built with Go 1.22 at the moment. Please try out the package and provide feedback on the corresponding proposal issue. -
+

+

If you experience any issues with the new execution tracer implementation, you may switch back to the old implementation by building your Go program with GOEXPERIMENT=noexectracer2. If you do, please file an issue, otherwise this option will be removed in a future release.