From 92b6cdeb4250861b1e81451ef699307993856b0a Mon Sep 17 00:00:00 2001
From: Michael Anthony Knyszek <mknyszek@google.com>
Date: Thu, 30 Nov 2023 21:14:52 +0000
Subject: [PATCH] doc: add release notes for runtime/pprof changes

For #50891.
For #61015.

For #61422.

Change-Id: I30d580814ac02fe9f3fbd1a101b2cc05947a9aaa
Reviewed-on: https://go-review.googlesource.com/c/go/+/546475
Reviewed-by: Cherry Mui <cherryyz@google.com>
Reviewed-by: Michael Pratt <mpratt@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
---
 doc/go1.22.html | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/doc/go1.22.html b/doc/go1.22.html
index 157ff501a8..7ffe434821 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -546,14 +546,6 @@ Do not send CLs removing the interior tags from such phrases.
   </dd>
 </dl><!-- reflect -->
 
-<dl id="runtime"><dt><a href="/pkg/runtime/">runtime</a></dt>
-  <dd>
-    <p><!-- https://go.dev/issue/61015 -->
-      TODO: <a href="https://go.dev/issue/61015">https://go.dev/issue/61015</a>: change mutex profile to scale contention by number of blocked goroutines
-    </p>
-  </dd>
-</dl><!-- runtime -->
-
 <dl id="runtime/metrics"><dt><a href="/pkg/runtime/metrics/">runtime/metrics</a></dt>
   <dd>
     <p><!-- https://go.dev/issue/63340 -->
@@ -562,6 +554,23 @@ Do not send CLs removing the interior tags from such phrases.
   </dd>
 </dl><!-- runtime/metrics -->
 
+<dl id="runtime/pprof"><dt><a href="/pkg/runtime/pprof/">runtime/pprof</a></dt>
+  <dd>
+    <p><!-- https://go.dev/issue/61015 -->
+      Mutex profiles now scale contention by the number of goroutines blocked on the mutex.
+      This provides a more accurate representation of the degree to which a mutex is a bottleneck in
+      a Go program.
+      For instance, if 100 goroutines are blocked on a mutex for 10 milliseconds, a mutex profile will
+      now record 1 second of delay instead of 10 milliseconds of delay.
+    </p>
+
+    <p><!-- https://go.dev/issue/50891 -->
+      CPU profiles on Darwin platforms now contain the process's memory map, enabling the disassembly
+      view in the pprof tool.
+    </p>
+  </dd>
+</dl><!-- runtime/pprof -->
+
 <dl id="runtime/trace"><dt><a href="/pkg/runtime/trace/">runtime/trace</a></dt>
   <dd>
     <p><!-- https://go.dev/issue/60773 -->
-- 
2.50.0