From: Cherry Mui <cherryyz@google.com>
Date: Mon, 28 Nov 2022 20:42:40 +0000 (-0500)
Subject: doc/go1.20: add release notes for the linker
X-Git-Tag: go1.20rc1~73
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=a4772376af5821c5c341ce9de49628d10d60971b;p=gostls13.git

doc/go1.20: add release notes for the linker

For #54202.

Change-Id: I06d7a44fb24427d783a9f57368dccce219b217bb
Reviewed-on: https://go-review.googlesource.com/c/go/+/453620
Run-TryBot: Cherry Mui <cherryyz@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Than McIntosh <thanm@google.com>
Reviewed-by: Austin Clements <austin@google.com>
---

diff --git a/doc/go1.20.html b/doc/go1.20.html
index 4cec64c869..e048127ff0 100644
--- a/doc/go1.20.html
+++ b/doc/go1.20.html
@@ -276,8 +276,22 @@ Do not send CLs removing the interior tags from such phrases.
 
 <h2 id="linker">Linker</h2>
 
-<p>
-  TODO: complete this section, or delete if not needed
+<p><!-- https://go.dev/issue/54197, CL 420774 -->
+  On Linux, the linker now selects the dynamic interpreter for <code>glibc</code>
+  or <code>musl</code> at link time. The <code>GO_LDSO</code> environment
+  variable is no longer used.
+</p>
+
+<p><!-- https://go.dev/issue/35006 -->
+  On Windows, the Go linker now supports modern LLVM-based C toolchains.
+</p>
+
+<p><!-- https://go.dev/issue/37762, CL 317917 -->
+  Go 1.20 uses <code>go:</code> and <code>type:</code> prefixes for compiler-generated
+  symbols rather than <code>go.</code> and <code>type.</code>.
+  This avoids confusion for user packages whose name starts with <code>go.</code>.
+  The <a href="/pkg/debug/gosym"><code>debug/gosym</code></a> package understands
+  this new naming convention for binaries built with Go 1.20 and newer.
 </p>
 
 <h2 id="bootstrap">Bootstrap</h2>
@@ -619,6 +633,16 @@ proxyHandler := &httputil.ReverseProxy{
   </dd>
 </dl><!-- debug/elf -->
 
+<dl id="debug/gosym"><dt><a href="/pkg/debug/gosym/">debug/gosym</a></dt>
+  <dd>
+    <p><!-- https://go.dev/issue/37762, CL 317917 -->
+      Due to a change of <a href="#linker">Go's symbol naming conventions</a>, tools that
+      process Go binaries should use Go 1.20's <code>debug/gosym</code> package to
+      transparently handle both old and new binaries.
+    </p>
+  </dd>
+</dl><!-- debug/gosym -->
+
 <dl id="debug/pe"><dt><a href="/pkg/debug/pe/">debug/pe</a></dt>
   <dd>
     <p><!-- CL 421357 -->