From: Cherry Zhang <cherryyz@google.com>
Date: Wed, 12 Aug 2020 17:30:43 +0000 (-0400)
Subject: doc/go1.15: clarify external linking can still be used for building PIE
X-Git-Tag: go1.16beta1~1377
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=50f63a7ae4b7f951fa894b96633b1716adca55fa;p=gostls13.git

doc/go1.15: clarify external linking can still be used for building PIE

In Go 1.15 we switched the default linking mode for PIE on
Linux/AMD64 and Linux/ARM64 to internal linking. Clarify that
the previous behavior (external linking) can still be used with
a flag.

Fixes #40719.

Change-Id: Ib7042622bc91e1b1aa31f520990d03b5eb6c56bb
Reviewed-on: https://go-review.googlesource.com/c/go/+/248199
Reviewed-by: Ian Lance Taylor <iant@golang.org>
---

diff --git a/doc/go1.15.html b/doc/go1.15.html
index 8872d71138..3a12ecfa11 100644
--- a/doc/go1.15.html
+++ b/doc/go1.15.html
@@ -357,7 +357,10 @@ Do not send CLs removing the interior tags from such phrases.
   The linker now defaults to internal linking mode
   for <code>-buildmode=pie</code> on
   <code>linux/amd64</code> and <code>linux/arm64</code>, so these
-  configurations no longer require a C linker.
+  configurations no longer require a C linker. External linking
+  mode (which was the default in Go 1.14 for
+  <code>-buildmode=pie</code>) can still be requested with
+  <code>-ldflags=-linkmode=external</code> flag.
 </p>
 
 <h2 id="objdump">Objdump</h2>