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 05916531a13d921991de7a318be5ab861db073f2..ba45b025671d7787ddd29648bbed2ddca9fdc4a6 100644 (file)
--- 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 351c00d98946d75c4a8fd26f6c0a23b7ebad5a83..626ca9161b4a8b0e059c3262975f1f62a3310e70 100644 (file)
--- 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