From: Cherry Mui <cherryyz@google.com>
Date: Wed, 4 Dec 2024 22:24:54 +0000 (-0500)
Subject: doc/next: add linker change release notes
X-Git-Tag: go1.24rc1~27
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=be0c4547d21e7e29ba062af7240b67e2263e5325;p=gostls13.git

doc/next: add linker change release notes

Document that we now generate GNU build ID or Mach-O UUID by
default, and the related flags to disable or override it.

Fixes #68678.
Fixes #70586.
For #68545.

Change-Id: Ic79f3c05aab8a5032ba6983b8c72eeb4202bfe84
Reviewed-on: https://go-review.googlesource.com/c/go/+/633875
Reviewed-by: David Chase <drchase@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
---

diff --git a/doc/next/5-toolchain.md b/doc/next/5-toolchain.md
index 05916531a1..ba45b02567 100644
--- a/doc/next/5-toolchain.md
+++ b/doc/next/5-toolchain.md
@@ -10,6 +10,13 @@ whether directly or indirectly (through an alias type).
 
 ## Linker {#linker}
 
+<!-- go.dev/issue/68678, go.dev/issue/68652, CL 618598, CL 618601 -->
+The linker now generates a GNU build ID (the ELF `NT_GNU_BUILD_ID` note) on ELF platforms
+and a UUID (the Mach-O `LC_UUID` load command) on macOS by default.
+The build ID or UUID is derived from the Go build ID.
+It can be disabled by the `-B none` linker flag, or overridden by the `-B 0xNNNN` linker
+flag with a user-specified hexadecimal value.
+
 ## Bootstrap {#bootstrap}
 
 <!-- go.dev/issue/64751 -->
diff --git a/doc/next/9-todo.md b/doc/next/9-todo.md
index 351c00d989..626ca9161b 100644
--- a/doc/next/9-todo.md
+++ b/doc/next/9-todo.md
@@ -1,7 +1,5 @@
 <!-- Needs to be documented and tracked via a release-blocking issue.
 
-CL 618598 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/618598) - generating LC_UUID in Go linker for macOS 15 is now tracked in issue 68678 itself as a release blocker
-CL 618601 has a RELNOTE comment without a suggested text (from RELNOTE comment in https://go.dev/cl/618601) - on ELF, GNU build ID being generated by default is now tracked in a new release-blocking issue 70586
 accepted proposal https://go.dev/issue/26232 (from https://go.dev/cl/605256, https://go.dev/cl/605275, https://go.dev/cl/605298, https://go.dev/cl/625036) - cmd/go's HTTP auth is tracked in proposal 26232 itself as a release blocker
 accepted proposal https://go.dev/issue/48429 (from https://go.dev/cl/521958, https://go.dev/cl/521959, https://go.dev/cl/534817, https://go.dev/cl/563175, https://go.dev/cl/613095, https://go.dev/cl/614555, https://go.dev/cl/630695) - cmd/go support for tracking tool dependencies in go.mod is tracked in proposal 48429 itself as a release blocker
 accepted proposal https://go.dev/issue/50603 (from https://go.dev/cl/595376, https://go.dev/cl/596035, https://go.dev/cl/609155, https://go.dev/cl/611916, https://go.dev/cl/627295) - cmd/go support for stamping pseudo-version in go build is tracked in proposal 50603 itself as a release blocker