From: Than McIntosh <thanm@golang.org>
Date: Wed, 12 Mar 2025 17:27:25 +0000 (-0400)
Subject: doc/next: add tentative DWARF 5 release note fragment
X-Git-Tag: go1.25rc1~726
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=d7f58834cb9684cff9ccd8e8e8294dc436129551;p=gostls13.git

doc/next: add tentative DWARF 5 release note fragment

Add a small fragment describing the move to DWARF 5 for this release,
along with the name of the GOEXPERIMENT.

Updates #26379.

Change-Id: I3a30a71436133e2e0a5edf1ba0db84b9cc17cc5c
Reviewed-on: https://go-review.googlesource.com/c/go/+/657176
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: David Chase <drchase@google.com>
Reviewed-by: Ian Lance Taylor <iant@google.com>
---

diff --git a/doc/next/5-toolchain.md b/doc/next/5-toolchain.md
index 0f4a816479..971fa39608 100644
--- a/doc/next/5-toolchain.md
+++ b/doc/next/5-toolchain.md
@@ -1,7 +1,15 @@
 ## Compiler {#compiler}
 
+<!-- https://go.dev/issue/26379 -->
+
+The compiler and linker in Go 1.25 now generate debug information
+using [DWARF version 5](https://dwarfstd.org/dwarf5std.html); the
+newer DWARF version reduces the space required for debuging
+information in Go binaries.
+DWARF 5 generation is gated by the "dwarf5" GOEXPERIMENT; this
+functionality can be disabled (for now) using GOEXPERIMENT=nodwarf5.
+
 ## Assembler {#assembler}
 
 ## Linker {#linker}
 
-