From c80bd631a53762a44d0e0f5bf6fd558a691a2167 Mon Sep 17 00:00:00 2001
From: Cherry Mui <cherryyz@google.com>
Date: Tue, 5 Dec 2023 12:36:13 -0500
Subject: [PATCH] doc/go1.22: document linker flag changes

Updates #41004.
For #61422.

Change-Id: I5ab60d8e9d30986233d7adec400ef059bbe4c1a9
Reviewed-on: https://go-review.googlesource.com/c/go/+/547515
Reviewed-by: Than McIntosh <thanm@google.com>
LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
---
 doc/go1.22.html | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/doc/go1.22.html b/doc/go1.22.html
index 64afa898af..d7e8bbd7fb 100644
--- a/doc/go1.22.html
+++ b/doc/go1.22.html
@@ -155,12 +155,22 @@ packages that do not have their own test files. Prior to Go 1.22 a
 
 <h2 id="linker">Linker</h2>
 
-<p><!-- https://go.dev/issue/62577 -->
-  TODO: <a href="https://go.dev/issue/62577">https://go.dev/issue/62577</a>: cmd/link, cmd/go: emit split DWARF on darwin
-</p>
-
-<p>
-  TODO: complete this section, or delete if not needed
+<p><!-- CL 493136 -->
+  The linker's <code>-s</code> and <code>-w</code> flags are now behave more
+  consistently across all platforms.
+  The <code>-w</code> flag suppresses DWARF debug information generation.
+  The <code>-s</code> flag suppresses symbol table generation.
+  The <code>-s</code> flag also implies the <code>-w</code> flag, which can be
+  negated with <code>-w=0</code>.
+  That is, <code>-s</code> <code>-w=0</code> will generate a binary with DWARF
+  debug information generation but without the symbol table.
+</p>
+
+<p><!-- CL 511475 -->
+  On ELF platforms, the <code>-B</code> linker flag now accepts a special form:
+  with <code>-B</code> <code>gobuildid</code>, the linker will generate a GNU
+  build ID (the ELF <code>NT_GNU_BUILD_ID</code> note) derived from the Go
+  build ID.
 </p>
 
 <h2 id="bootstrap">Bootstrap</h2>
-- 
2.48.1